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 kategoryzację typu 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 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 bazowych jednostek 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 Id SKU. Identyfikator jest unikatowy tylko w kontekście produktu, do którego należy.
tytuł Struna Tytuł jednostki (SKU).
opis Struna Opis produktu oznaczonego jako SKU.
identyfikatorProdukt Struna Identyfikator nadrzędnego produktu , który zawiera jednostkę 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.
inventoryVariables 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.
provisioningVariables Tablica znaków Lista zmiennych, które należy podać w kontekście aprowizacji elementu wiersza koszyka podczas zakupu elementu. Obsługiwane wartości to:
Zakres — zakres zakupu rezerwacji platformy 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ściPoświadczenia Właściwości atestowe dla SKU.
typ konsumpcji Struna Jest dostępny tylko wtedy, gdy SKU obsługuje konsumpcję, taką jak 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 MinimumPurchaseCommitment 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órych dodatek może pracować
upgradeTargetOffers tablica ciągów Lista produktów i jednostek SKU, do których można uaktualnić produkt
instrukcje konwersji Lista instrukcji konwersji Lista instrukcji dotyczących konwertowania operacji

właściwości oferty wyspecjalizowanej

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, zobacz przegląd 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.
productId Struna Identyfikator produktu, który zawiera tę dostępność.
skuId Struna Identyfikator SKU , który jest powiązany z tą dostępnością.
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 dostępności.
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.
Kupowalny 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 Łącza zasobów 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, zobacz omówienie nowych środowisk handlowych.

Przedstawia instrukcje dotyczące odnawiania dla określonej dostępności.

Własność Typ Opis
identyfikatoryTerminówZastosowalnych Tablica ciągów Identyfikatory terminów, do których mają zastosowanie instrukcje
OpcjeOdnowienia Tablica opcjaOdnowienia 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, zobacz omówienie nowych środowisk handlowych.

Reprezentuje instrukcje odnawiania odnoszące się do danej dostępności.

Własność Typ Opis
renewToId Struna Reprezentuje produkt i SKU do odnowienia
isAutoRenewable 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ąceSprawdzeniaZasobów

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 przeprowadzenia kontroli spisu. Każda SKU produktów zdefiniuje, które wartości (jeśli jakieś) są potrzebne do przeprowadzenia tej operacji.
Linki Łącza Zasobów Linki do zasobów zawarte w żądaniu sprawdzania spisu.

ElementInwentarza

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
Productid 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.
isRestricted Bool Wskazuje, czy ten element został uznany za mający ograniczenia w zasobach.
Ograniczenia Tablica OgraniczeniaZasobów Szczegóły wszelkich ograniczeń znalezionych dla tego elementu. Ta właściwość zostanie wypełniona tylko wtedy, gdy jest ograniczone = "prawda".

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 wyliczenia.
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.

ZaświadczenieWłaściwości

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.