Udostępnij za pośrednictwem

Zasoby produktów

  • Artykuł

Zasoby reprezentujące towary lub usługi do wykupu. Zawiera zasoby do opisywania typu i kształtu produktu (SKU) oraz sprawdzania dostępności produktu w spisie.

Produkt

Reprezentuje możliwy do zakupu towar lub usługę. Produkt sam w sobie nie jest przedmiotem do kupienia.

Własność Typ Opis
id Struna Identyfikator produktu.
tytuł Struna Tytuł produktu.
opis Struna Opis produktu.
typ produktu ItemType Obiekt opisujący typy kategoryzacji tego produktu.
isMicrosoftProduct bool Wskazuje, czy produkt jest produktem firmy Microsoft.
nazwaWydawcy Struna Nazwa wydawcy produktu, jeśli jest dostępna.
Linki ProductLinks Linki do zasobów zawarte w produkcie.

Typ elementu

Reprezentuje typ produktu.

Własność Typ Opis
id Struna Identyfikator typu.
Nazwa wyświetlana Struna Nazwa wyświetlana dla typu elementu.
podtyp ItemType Fakultatywny. Obiekt, który opisuje podtyp kategoryzacji dla typu elementu.

Zawiera listę linków do produktu .

Własność Typ Opis
sku Link Link umożliwiający uzyskanie dostępu do podstawowych SKU.
Linki ResourceLinks Łącza do zasobów znajdujące się w zasobie.

SKU

Reprezentuje możliwą do zakupu jednostkę magazynową (SKU) w ramach produktu.

Własność Typ Opis
id Struna Identyfikator dla SKU. Identyfikator jest unikatowy tylko w kontekście produktu, do którego należy.
tytuł Struna Tytuł SKU.
opis Struna Opis produktu oznaczonego jako SKU.
identyfikator produktu Struna Identyfikator nadrzędnego produktu zawierającego SKU.
minimalna ilość Int Minimalna dozwolona ilość do zakupu.
maksymalna ilość Int Maksymalna dozwolona ilość do zakupu.
isTrial bool Wskazuje, czy jednostka SKU jest elementem wersji próbnej.
obsługiwane cykle rozliczeniowe Tablica ciągów Lista obsługiwanych cykli rozliczeniowych dla jednostki SKU. Obsługiwane wartości to nazwy członków znalezione w BillingCycleType.
Wymagania wstępne zakupu Tablica ciągów Lista kroków lub działań warunków wstępnych, które są potrzebne przed zakupem przedmiotu. Obsługiwane wartości to:
"InventoryCheck" — wskazuje, że spis elementu powinien zostać oceniony przed podjęciem próby zakupu elementu.
"AzureSubscriptionRegistration" — wskazuje, że wymagana jest subskrypcja platformy Azure i musi zostać zarejestrowana przed podjęciem próby zakupu elementu.
zmienne inwentarza Tablica ciągów Lista zmiennych potrzebnych do wykonania sprawdzenia inwentaryzacji na przedmiocie. Obsługiwane wartości to:
"CustomerId" — identyfikator klienta, dla którego dokonywany jest zakup.
"AzureSubscriptionId" — identyfikator subskrypcji platformy Azure, która będzie używana do zakupu rezerwacji platformy Azure.
"ArmRegionName" — region, dla którego należy zweryfikować spis. Ta wartość musi być zgodna z wartością "ArmRegionName" z atrybutów DynamicAttributes jednostki SKU.
zmienneProvisioning Tablica ciągów Lista zmiennych, które należy podać w kontekście konfiguracji elementu wiersza koszyka podczas zakupu produktu. Obsługiwane wartości to:
Zakres — zakres zakupu rezerwacji na platformie Azure: "Pojedynczy", "Udostępniony".
"SubscriptionId" — identyfikator subskrypcji platformy Azure, która będzie używana do zakupu rezerwacji platformy Azure.
"Czas trwania" — czas trwania rezerwacji Azure: "1rok", "3lata".
dynamicAttributes pary klucz/wartość Słownik właściwości dynamicznych, które mają zastosowanie do elementu. Właściwości w słowniku są dynamiczne i mogą ulec zmianie bez powiadomienia. Partnerzy powinni unikać tworzenia mocnych zależności od konkretnych kluczy istniejących w wartości właściwości.
Linki ResourceLinks Łącza zasobów zawarte w SKU.
ZaświadczenieWłaściwości Właściwości Atestacji Właściwości atestowe dla SKU.
typ konsumpcji Struna Jest dostępny tylko wtedy, gdy jednostka magazynowa (SKU) obsługuje konsumpcję, jak na przykład nadwyżka.
właściwości specjalnej oferty Lista wyspecjalizowanych właściwości ofert Jest dostępny tylko wtedy, gdy produkt jest podtypem oferty specjalistycznej (SpecializedOffer).
minimalne zobowiązanie zakupowe MinimalneZobowiązanieZakupu Stała kwota przeznaczona na usługi obliczeniowe.

Atrybuty jednostki SKU dynamicznej

Istotne właściwości dotyczące nowych produktów i usług opartych na licencjach handlowych.

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.

Własność Typ Opis
maOgraniczenia Boolean Opisuje, czy jednostka SKU zawiera element assetContraints
jestDodatkiem Boolean Opisuje, czy jednostka SKU jest dodatkiem
prerequisiteSkus tablica ciągów Opisuje produkty i jednostki SKU, z którymi może współpracować dodatek.
Modernizacja Ofert Docelowych tablica ciągów Lista produktów i jednostek SKU, na które można uaktualnić element
instrukcje konwersji Lista instrukcji konwersji Lista instrukcji dotyczących konwertowania operacji

właściwości specjalnej oferty

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.

Dotyczy tylko podtypów produktów "SpecializedOffers"

Własność Typ Opis
data rozpoczęcia Struna Identyfikatory terminów, do których mają zastosowanie instrukcje
data zakończenia Struna Opcje definiujące odnowienia
polityki cenowe Lista cenZasady Lista zasad definiujących typy rabatów i wartości promocji.

Minimalne Zobowiązanie Zakupowe

Atrybuty minimalnej kwoty, która może zostać zarezerwowana w usługach obliczeniowych.

Własność Typ Opis
zboże Struna Okres minimalnego zobowiązania zakupu.
kod waluty Słownik<String, String> "waluta" i "symbol" minimalnej kwoty, którą można zadeklarować.
kwota Int Minimalna kwota, która może zostać przeznaczona na usługi obliczeniowe.

Zasady Cenowe

Opisz typy rabatów i wartości promocji.

Własność Typ Opis
typ Struna Opisz, czy rabat jest oparty na procentach, czy rabatach na stawkę płaską.
wartość Struna Definiuje ilość zastosowanego rabatu.

Dostępność

Reprezentuje konfigurację, w której jednostka SKU jest dostępna do zakupu (na przykład kraj/region, waluta i segment branżowy).

Własność Typ Opis
id Struna Identyfikator tej dostępności. Ten identyfikator jest unikatowy tylko w kontekście produktu nadrzędnego i jednostki SKU . Zwróć uwagę, że identyfikatory dostępności mogą ulec zmianie w czasie. Partnerzy powinni polegać tylko na tej wartości w krótkim przedziale czasu po jego pobraniu.
identyfikator produktu Struna Identyfikator produktu, który zawiera tę dostępność.
skuId Struna Identyfikator SKU, który zawiera tę dostępność.
catalogItemId Struna Unikatowy identyfikator tego elementu w wykazie. Ten identyfikator należy umieścić we właściwościach OrderLineItem.OfferId lub CartLineItem.CatalogItemId podczas zakupu nadrzędnego SKU . Uwaga ten identyfikator może ulec zmianie w czasie. Należy polegać na tej wartości tylko zaraz po jej pobraniu. Powinien on być dostępny i używany tylko w momencie zakupu.
domyślna waluta Struna Domyślna waluta obsługiwana dla tej usługi.
część Struna Segment branżowy dla tej dostępności. Obsługiwane wartości to: Komercyjna, Edukacja, Rządowa, Organizacja Niedochodowa.
kraj Struna Kraj lub region (w formacie kodu kraju ISO), w którym ta dostępność ma zastosowanie.
Możliwy do zakupu bool Wskazuje, czy ten produkt lub usługa jest dostępna do kupienia.
jestOdnawialne bool Wskazuje, czy ta dostępność jest odnawialna.
Instrukcje dotyczące odnowienia RenewalInstruction Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.
produkt produkt Produkt, który odpowiada tej dostępności.
Jednostka magazynowa (SKU) Sku SKU, któremu odpowiada ta dostępność.
Warunki Tablica zasobów terminów Kolekcja terminów, które mają zastosowanie do tej dostępności.
Linki ResourceLinks Linki do zasobów zawarte w ramach dostępności.

Instrukcja odnawiania

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.

Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.

Własność Typ Opis
identyfikatoryTerminówZastosowalnych Tablica ciągów Identyfikatory terminów, do których mają zastosowanie instrukcje
OpcjeOdnowienia Lista opcji odnawiania Opcje definiujące odnowienia

Opcja odnowienia

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.

Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.

Własność Typ Opis
renewToId Struna Przedstawia produkt i SKU do odnowienia
czyAutomatycznieOdnawialne bool Określa, czy dostępność może być odnawiana automatycznie

Termin

Reprezentuje określenie, dla którego można kupić prawo do korzystania.

Własność Typ Opis
czas trwania Struna Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata).
opis Struna Opis terminu.

ZapytanieDotycząceSprawdzeniaInwentarza

Reprezentuje prośbę o sprawdzenie inwentarza pod kątem niektórych pozycji katalogowych.

Własność Typ Opis
elementy docelowe Tablica InventoryItem Lista elementów katalogu, które zostaną ocenione przez kontrolę stanu magazynowego.
kontekst magazynowy Pary klucz/wartość Słownik wartości kontekstowych potrzebnych do przeprowadzania kontroli spisu. Każda SKU produktów zdefiniuje, które wartości (jeśli jakieś) są potrzebne do przeprowadzenia tej operacji.
Linki ResourceLinks Linki do zasobów zawarte w żądaniu sprawdzania spisu.

Przedmiot Inwentarza

Reprezentuje pojedynczy element w operacji sprawdzania spisu. Ten zasób służy do określania elementów docelowych w żądaniu wejściowym, a także służy do reprezentowania wyników wyjściowych operacji sprawdzania spisu.

Własność Typ Opis
identyfikator produktu Struna (Wymagane) Identyfikator produktu .
skuId Struna Identyfikator jednostki SKU . Jeśli używasz tego zasobu jako danych wejściowych do żądania spisu, ta wartość jest opcjonalna. Jeśli ta wartość nie zostanie podana, wszystkie jednostki SKU w ramach produktu będą traktowane jako elementy docelowe operacji sprawdzania zapasów.
jestOgraniczone bool Wskazuje, czy ten element został uznany za mający ograniczenia w zasobach.
Ograniczenia Tablica OgraniczenieZasobów Szczegóły wszelkich ograniczeń znalezionych dla tego elementu. Ta właściwość zostanie wypełniona tylko wtedy, gdy isRestricted = "true".

Ograniczenie inwentaryzacji

Reprezentuje szczegóły ograniczenia inwentarza. Te szczegóły dotyczą tylko wyników kontroli zapasów, a nie dotyczą żądań wejściowych.

Własność Typ Opis
kod przyczyny Struna Kod identyfikujący przyczynę ograniczenia.
opis Struna Opis ograniczenia inwentarza.
Właściwości Pary klucz/wartość Słownik właściwości, które mogą zawierać szczegółowe informacje na temat ograniczenia.

Typ cyklu rozliczeniowego

[Enum/dotnet/api/system.enum) z wartościami wskazującymi typ cyklu rozliczeniowego.

Wartość Pozycja Opis
Nieznany 0 Inicjalizator typu wyliczeniowego.
Miesięczny 1 Wskazuje, że partner będzie naliczany co miesiąc.
Roczny 2 Wskazuje, że partner będzie obciążany opłatą roczną.
Żaden 3 Wskazuje, że partner nie zostanie obciążony opłatą. Ta wartość może być używana dla elementów wersji próbnej.
OneTime 4 Wskazuje, że partner zostanie obciążony jednorazowo.
Triennale 5 Wskazuje, że partner zostanie obciążony co trzy lata.

WłaściwościAtestacji

Reprezentuje typ zaświadczenia oraz informuje, czy jest wymagany do zakupu.

Własność Typ Opis
typ poświadczenia Struna Wskazuje typ zaświadczania. Produkty Windows 365 będą mieć taką samą wartość jak Windows 365. Tekst zaświadczenia Windows 365 brzmi: "Rozumiem, że każda osoba korzystająca z Windows 365 Business z korzyścią hybrydową musi również mieć prawidłową kopię systemu Windows 10/11 Pro zainstalowaną na swoim podstawowym urządzeniu służbowym."
wymusić poświadczenie Boolean Wskazuje, czy zaświadczenie jest wymagane do zakupu.