Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ressourcen, die käufliche Waren oder Dienstleistungen darstellen. Enthält Ressourcen zum Beschreiben des Produkttyps und der Form (SKU) und zur Überprüfung der Verfügbarkeit des Produkts in einem Bestand.
Produkt
Stellt ein käufliches Gut oder eine Dienstleistung dar. Ein Produkt selbst ist kein käuflicher Artikel.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| id | Schnur | Die ID für ein Produkt. |
| Titel | Schnur | Der Produkttitel. |
| Beschreibung | Schnur | Die Produktbeschreibung. |
| Produkttyp | Artikeltyp | Ein Objekt, das die Typkategorisierungen dieses Produkts beschreibt. |
| isMicrosoftProdukt | Bool | Gibt an, ob das Produkt ein Microsoft-Produkt ist. |
| VerlegerName | Schnur | Der Name des Herausgebers des Produkts, falls verfügbar. |
| Links | ProductLinks | Die Im Produkt enthaltenen Ressourcenverknüpfungen. |
Artikeltyp
Stellt den Typ eines Produkts dar.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| id | Schnur | Der Typbezeichner. |
| Anzeigename | Schnur | Der Anzeigename für einen Elementtyp. |
| Untertyp | Artikeltyp | Wahlfrei. Ein Objekt, das eine Untertypkategorisierung für einen Elementtyp beschreibt. |
ProduktLinks
Enthält eine Liste von Links für ein Produkt.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Skus | Verbinden | Der Link für den Zugriff auf die zugrunde liegenden SKUs. |
| Links | RessourcenLinks | Die In einer Ressource enthaltenen Ressourcenverknüpfungslinien. |
Sku
Stellt eine kaufbare Lagerhaltungseinheit (SKU) innerhalb eines Produkts dar.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| id | Schnur | Die ID für die SKU. Die ID ist nur im Kontext des übergeordneten Produkts eindeutig. |
| Titel | Schnur | Der Titel der SKU. |
| Beschreibung | Schnur | Die Beschreibung der SKU. |
| Produkt-ID | Schnur | Die ID des übergeordneten Produkts , das eine SKU enthält. |
| Mindestmenge | Integer | Die Mindestmenge, die für den Kauf zulässig ist. |
| maximale Menge | Integer | Die maximal zulässige Menge für den Kauf. |
| isTrial | Bool | Gibt an, ob eine SKU ein Testelement ist. |
| unterstützte Abrechnungszeiträume | Array von Zeichenfolgen | Die Liste der unterstützten Abrechnungszyklen für eine SKU. Unterstützte Werte sind die Membernamen, die in BillingCycleType gefunden werden. |
| Kaufvoraussetzungen | Array von Zeichenfolgen | Die Liste der erforderlichen Schritte oder Aktionen, die vor dem Kauf eines Artikels erforderlich sind. Die unterstützten Werte sind: "InventoryCheck" – Gibt an, dass das Inventar des Artikels ausgewertet werden soll, bevor versucht wird, einen Artikel zu kaufen. "AzureSubscriptionRegistration" – Gibt an, dass ein Azure-Abonnement erforderlich ist und vor dem Kauf eines Artikels registriert werden muss. |
| Inventarvariablen | Array von Zeichenfolgen | Die Liste der Variablen, die zum Ausführen einer Bestandsüberprüfung für ein Element erforderlich sind. Die unterstützten Werte sind: "CustomerId" – Die ID des Kunden, für den der Kauf vorgesehen wäre. "AzureSubscriptionId" – Die ID des Azure-Abonnements, das für einen Azure-Reservierungskauf verwendet würde. "ArmRegionName" – Die Region, für die der Bestand überprüft werden soll. Dieser Wert muss mit dem "ArmRegionName" aus den DynamicAttributes der SKU übereinstimmen. |
| Bereitstellungsvariablen | Array von Zeichenfolgen | Die Liste der Variablen, die in den Bereitstellungskontext eines Einkaufswagenartikels eingefügt werden müssen, wenn ein Artikel gekauft wird. Die unterstützten Werte sind: Bereich – Der Anwendungsbereich für einen Azure-Reservierungskauf: "Einzeln", "Gemeinsam". "SubscriptionId" – Die ID des Azure-Abonnements, das für einen Azure-Reservierungskauf verwendet würde. "Duration" – Die Dauer der Azure-Reservierung: "1Year", "3Year". |
| dynamicAttributes | Schlüssel/Wert-Paare | Das Wörterbuch der dynamischen Eigenschaften, die für ein Element gelten. Die Eigenschaften in einem Wörterbuch sind dynamisch und können ohne vorherige Ankündigung geändert werden. Partner sollten keine starken Abhängigkeiten auf bestimmte Schlüssel aufbauen, die im Wert einer Eigenschaft vorhanden sind. |
| Links | RessourcenLinks | Die in der SKU enthaltenen Ressourcenlinks. |
| Bescheinigungseigenschaften | AttestationProperties | Die Nachweiseigenschaften für eine SKU. |
| Verbrauchstyp | Schnur | Ist nur verfügbar, wenn die SKU den Verbrauch wie z. B. Mehrverbrauch unterstützt. |
| Eigenschaften spezialisierter Angebote | Liste der spezialisierten AngebotsEigenschaften | Ist nur verfügbar, wenn das Produkt untertyp "SpecializedOffer" ist. |
| Mindestabnahmeverpflichtung | Mindestabnahmeverpflichtung | Der feste Betrag, der für Rechendienste zugesichert ist. |
Dynamische SKU-Attribute
Wichtige Eigenschaften, die für neue handelslizenzbasierte Produkte und Dienste relevant sind.
Hinweis
Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| hat Einschränkungen | Boolescher Typ (Boolean) | Beschreibt, ob die SKU assetContraints enthält. |
| istAddon | Boolescher Typ (Boolean) | Beschreibt, ob es sich bei der SKU um ein Add-On handelt. |
| prerequisiteSkus | Feld von Zeichenfolgen | Beschreibt Produkte und SKUs, mit denen das Zusatzmodul kompatibel ist |
| Aktualisierung der Zielangebote | Feld von Zeichenfolgen | Eine Liste von Produkten und SKUs, auf die der Artikel aufgewertet werden kann |
| Umwandlungsanweisungen | Liste der Umwandlungsanweisungen | Liste der Für Konvertierungsvorgänge zutreffenden Anweisungen |
Eigenschaften spezialisierter Angebote
Hinweis
Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.
Gilt nur für Produktuntertypen "SpecializedOffers"
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Startdatum | Schnur | Begriffs-IDs, für die die Anweisungen gelten |
| Enddatum | Schnur | Optionen zum Definieren von Verlängerungen |
| Preisrichtlinien | Liste der Preispolitiken | Eine Liste der Richtlinien, die die Rabatttypen und -werte für Werbeaktionen definieren. |
Mindestabnahmeverpflichtung
Attribute des Mindestbetrags, die für Rechendienste festgelegt werden können.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Korn | Schnur | Der Zeitraum der Mindestkaufverpflichtung. |
| Währungscode | Wörterbuch<String, String> | Die "Währung" und das "Symbol" des Mindestbetrags, der zugesichert werden kann. |
| Menge | Integer | Der Mindestbetrag, der bei Computedienste festgelegt werden kann. |
Preisrichtlinien
Beschreiben Sie die Rabatttypen und -werte der Werbeaktion.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Typ | Schnur | Beschreiben Sie, ob der Rabatt auf Prozentsätze oder Pauschalrabatte basiert. |
| Wert | Schnur | Definiert den Betrag des angewendeten Rabatts. |
Verfügbarkeit
Stellt eine Konfiguration dar, in der eine SKU zum Kauf verfügbar ist (z. B. Land/Region, Währung und Industriesegment).
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| id | Schnur | Die ID für diese Verfügbarkeit. Diese ID ist nur innerhalb des Kontexts des übergeordneten Produkts und der SKU eindeutig. Anmerkung Verfügbarkeits-IDs können sich im Laufe der Zeit ändern. Partner sollten sich nur innerhalb kurzer Zeit auf diesen Wert verlassen, nachdem er abgerufen wurde. |
| Produkt-ID | Schnur | Die ID des Produkts , das diese Verfügbarkeit enthält. |
| SKU-Nummer | Schnur | Die ID der SKU , die diese Verfügbarkeit enthält. |
| KatalogArtikelId | Schnur | Der eindeutige Bezeichner für dieses Element im Katalog. Diese ID muss beim Kauf der übergeordneten SKU in die Eigenschaften OrderLineItem.OfferId oder CartLineItem.CatalogItemId aufgefüllt werden. Anmerkung Diese ID kann sich im Laufe der Zeit ändern. Sie sollten sich nur innerhalb kurzer Zeit nach dem Abrufen auf diesen Wert verlassen. Es sollte nur zum Zeitpunkt des Kaufs aufgerufen und verwendet werden. |
| Standardwährung | Schnur | Die für diese Verfügbarkeit unterstützte Standardwährung. |
| Abschnitt | Schnur | Das Branchensegment für diese Verfügbarkeit. Unterstützte Werte sind: Gewerbe, Bildung, Regierung, Gemeinnützig. |
| Staat | Schnur | Das Land oder die Region (im ISO-Ländercodeformat), in dem diese Verfügbarkeit gilt. |
| istKaufbar | Bool | Gibt an, ob diese Verfügbarkeit erwerbbar ist. |
| istErneuerbar | Bool | Gibt an, ob diese Verfügbarkeit erneuerbar ist. |
| Erneuerungsanweisungen | RenewalInstruction | Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar. |
| Produkt | Produkt | Das Produkt, dem diese Verfügbarkeit entspricht. |
| Sku | Sku | Die SKU, zu der diese Verfügbarkeit gehört. |
| Bedingungen | Array von Term-Ressourcen | Die Sammlung von Bedingungen, die für diese Verfügbarkeit gelten. |
| Links | RessourcenLinks | Die Ressourcenverknüpfungen, die in der Verfügbarkeit enthalten sind. |
Erneuerungsanweisung
Hinweis
Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.
Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| anwendbareBegriffsIDs | Array von Zeichenfolgen | Begriffs-IDs, für die die Anweisungen gelten |
| Verlängerungsoptionen | Array von RenewalOption | Optionen zum Definieren von Verlängerungen |
Verlängerungsoption
Hinweis
Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.
Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| renewToId | Schnur | Stellt das Produkt und die SKU dar, die erneuert werden sollen. |
| istAutoerneuerbar | Bool | Gibt an, ob die Verfügbarkeit automatisch verlängert werden kann. |
Begriff
Stellt einen Begriff dar, für den die Verfügbarkeit erworben werden kann.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Dauer | Schnur | Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre). |
| Beschreibung | Schnur | Die Beschreibung des Begriffs. |
| termLifeCycleState | Schnur | Eine Beschreibung des Lebenszyklus. Diese unterstützten Werte umfassen GA (allgemein verfügbar, EndOfSale und EndofSaleWithConversions). Diese Eigenschaft wird nur zurückgegeben, wenn includeLifeCycleState beim Aufrufen der Verfügbarkeit per ID-API auf "true" festgelegt ist. |
InventoryCheckAnfrage
Stellt eine Anforderung zum Überprüfen des Inventars für bestimmte Katalogelemente dar.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Zielobjekte | Array von InventoryItem | Die Liste der Katalogelemente, die von der Bestandsüberprüfung ausgewertet werden. |
| Inventarkontext | Schlüssel-Wert-Paare | Das Wörterbuch der Kontextwerte, die für die Durchführung der Bestandsüberprüfungen erforderlich sind. Jede SKU der Produkte bestimmt, welche Werte (falls vorhanden) erforderlich sind, um diesen Vorgang auszuführen. |
| Links | RessourcenLinks | Die Ressourcenlinks, die in der Bestandsüberprüfungsanforderung enthalten sind. |
InventarArtikel
Stellt ein einzelnes Element in einem Bestandsüberprüfungsvorgang dar. Diese Ressource wird verwendet, um die Zielelemente in einer Eingabeanforderung anzugeben und wird auch verwendet, um die Ausgabeergebnisse des Bestandsüberprüfungsvorgangs darzustellen.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Produkt-ID | Schnur | (Erforderlich) Die ID des Produkts. |
| SKU-Nummer | Schnur | Die ID der SKU. Dieser Wert ist optional. Wenn dieser Wert nicht angegeben wird, werden alle SKUs unter dem Produkt als Zielelemente des Bestandsüberprüfungsvorgangs betrachtet. |
| istEingeschränkt | Bool | Gibt an, ob dieser Artikel einen eingeschränkten Bestand aufweist. |
| Einschränkungen | Array von InventoryRestriction | Die Details aller Einschränkungen, die für dieses Element gefunden werden. Diese Eigenschaft wird nur aufgefüllt, wenn isRestricted = "true" ist. |
Bestandsbeschränkung
Stellt die Details einer Bestandseinschränkung dar. Diese Details gelten nur für Die Ausgabeergebnisse der Bestandsüberprüfung, nicht für Eingabeanforderungen.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Grundcode | Schnur | Der Code, der den Grund für die Einschränkung identifiziert. |
| Beschreibung | Schnur | Die Beschreibung der Bestandsbeschränkung. |
| Eigenschaften | Schlüssel-Wert-Paare | Das Wörterbuch der Eigenschaften, das weitere Details zur Einschränkung bereitstellen kann. |
Abrechnungszyklustyp
Eine [Enum/dotnet/api/system.enum) mit Werten, die einen Abrechnungszyklustyp angeben.
| Wert | Position | BESCHREIBUNG |
|---|---|---|
| Unbekannt | 0 | Enum-Initialisierer. |
| Monatlich | 1 | Gibt an, dass der Partner monatlich belastet wird. |
| Jährlich | 2 | Gibt an, dass der Partner jährlich in Rechnung gestellt wird. |
| Nichts | 3 | Gibt an, dass der Partner nicht belastet wird. Dieser Wert kann für Testelemente verwendet werden. |
| Ehemalig | 4 | Gibt an, dass der Partner einmalig in Rechnung gestellt wird. |
| Dreijährlich | 5 | Gibt an, dass der Partner alle drei Jahre in Rechnung gestellt wird. |
Bescheinigungseigenschaften
Stellt einen Nachweistyp dar und ob er zum Kauf erforderlich ist.
| Eigentum | Typ | BESCHREIBUNG |
|---|---|---|
| Bescheinigungstyp | Schnur | Gibt den Nachweistyp an. Windows 365-Produkte haben den Wert von Windows 365. Der Nachweistext von Windows 365 lautet "Ich verstehe, dass jede Person, die Windows 365 Business mit Windows Hybrid-Vorteil verwendet, auch eine gültige Kopie von Windows 10/11 Pro auf ihrem primären Arbeitsgerät installiert haben muss." |
| BestätigungDurchsetzen | Boolescher Typ (Boolean) | Gibt an, ob der Nachweis für den Kauf erforderlich ist. |