Ressourcen für Produkte
Ressourcen, die bearbeitbare 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 einen bearbeitbaren Guten oder Dienst dar. Ein Produkt selbst ist kein bearbeitbarer Artikel.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Die ID für ein Produkt. |
| title | String | Der Produkttitel. |
| Beschreibung | String | Die Produktbeschreibung. |
| productType | Elementtyp | Ein Objekt, das die Typkategorisierung(en) dieses Produkts beschreibt. |
| isMicrosoftProduct | Bool | Gibt an, ob das Produkt ein Microsoft-Produkt ist. |
| publisherName | String | Der Name des Herausgebers des Produkts, falls verfügbar. |
| Verknüpfungen | ProductLinks | Die Im Produkt enthaltenen Ressourcenverknüpfungen. |
ItemType
Stellt den Typ eines Produkts dar.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Der Typbezeichner. |
| displayName | String | Der Anzeigename für einen Elementtyp. |
| subType | Elementtyp | Optional. Ein Objekt, das eine Untertypkategorisierung für einen Elementtyp beschreibt. |
ProductLinks
Enthält eine Liste von Links für ein Produkt.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| skus | Link | Der Link für den Zugriff auf die zugrunde liegenden SKUs. |
| Verknüpfungen | ResourceLinks | Die In einer Ressource enthaltenen Ressourcenverknüpfungslinien. |
Sku
Stellt eine bearbeitbare Lagerhaltungseinheit (SKU) unter einem Produkt dar.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Die ID für die SKU. Die ID ist nur im Kontext des übergeordneten Produkts eindeutig. |
| title | String | Der Titel der SKU. |
| Beschreibung | String | Die Beschreibung der SKU. |
| productId | String | Die ID des übergeordneten Produkts , das eine SKU enthält. |
| Mindestmenge | Int | Die Mindestmenge, die für den Kauf zulässig ist. |
| maximale Menge | Int | Die maximal zulässige Menge für den Kauf. |
| isTrial | Bool | Gibt an, ob eine SKU ein Testelement ist. |
| supportedBillingCycles | Array aus Zeichenfolgen | Die Liste der unterstützten Abrechnungszeitraum für eine SKU. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen. |
| purchasePrerequisites | Array aus 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. |
| inventoryVariables | Array aus 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. |
| provisioningVariables | Array aus Zeichenfolgen | Die Liste der Variablen, die beim Kauf eines Artikels im Bereitstellungskontext eines Einkaufswagenartikels bereitgestellt werden müssen. Die unterstützten Werte sind: Bereich – Der Bereich für einen Azure-Reservierungskauf: "Single", "Shared". "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 Vorheriges geändert werden. Partner sollten keine starken Abhängigkeiten von bestimmten Schlüsseln erstellen, die im Wert einer Eigenschaft vorhanden sind. |
| Verknüpfungen | ResourceLinks | Die In der SKU enthaltenen Ressourcenverknüpfungslinien. |
| AttestationProperties | AttestationProperties | Die Nachweiseigenschaften für eine SKU. |
| consumptionType | String | Ist nur verfügbar, wenn die SKU den Verbrauch wie z . B. Überlastung unterstützt. |
| specializedOfferProperties | Liste der spezialisiertenOfferProperties | Ist nur verfügbar, wenn das Produkt untertyp "SpecializedOffer" ist. |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | Der feste Betrag, der für Computedienste zugesichert wurde. |
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.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| hasConstraints | Boolean | Beschreibt, ob die SKU assetContraints enthält. |
| isAddon | Boolean | Beschreibt, ob es sich bei der SKU um ein Add-On handelt. |
| prerequisiteSkus | Zeichenfolgen-Arrays | Beschreibt Produkte und Skus, mit denen das Add-On arbeiten kann |
| upgradeTargetOffers | Zeichenfolgen-Arrays | Eine Liste der Produkte und Skus, auf die das Element aktualisiert werden kann |
| conversionInstructions | Liste der conversionInstructions | Liste der Für Konvertierungsvorgänge zutreffenden Anweisungen |
specializedOfferProperties
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"
| Eigenschaft | Typ | BESCHREIBUNG |
|---|---|---|
| startDate | String | Ausdrucks-IDs, für die die Anweisungen gelten |
| endDate | String | Optionen zum Definieren von Verlängerungen |
| pricingPolicies | Liste der preisePolicies | Eine Liste der Richtlinien, die die Rabatttypen und -werte für Werbeaktionen definieren. |
MinimumPurchaseCommitment
Attribute des Mindestbetrags, der für Computedienste zugesichert werden kann.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Korn | String | Der Zeitraum der Mindestkaufverpflichtung. |
| currencyCode | Wörterbuchzeichenfolge<, Zeichenfolge> | Die "Währung" und das "Symbol" des Mindestbetrags, der zugesichert werden kann. |
| amount | Int | Der Mindestbetrag, der für Computedienste zugesichert werden kann. |
PricingPolicies
Beschreiben Sie die Rabatttypen und -werte der Werbeaktion.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| type | String | Beschreiben Sie, ob der Rabatt auf Prozentsätze oder Pauschalrabatte basiert. |
| value | String | 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).
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Die ID für diese Verfügbarkeit. Diese ID ist nur innerhalb des Kontexts des übergeordneten Produkts und der SKU eindeutig. Hinweis: 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. |
| productId | String | Die ID des Produkts , das diese Verfügbarkeit enthält. |
| skuId | String | Die ID der SKU, die diese Verfügbarkeit enthält. |
| catalogItemId | String | 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. Hinweis : 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. |
| defaultCurrency | String | Die für diese Verfügbarkeit unterstützte Standardwährung. |
| Segment | String | Das Branchensegment für diese Verfügbarkeit. Unterstützte Werte sind: Commercial, Education, Government, NonProfit. |
| country | String | Das Land oder die Region (im ISO-Ländercodeformat), in dem diese Verfügbarkeit gilt. |
| isPurchasable | Bool | Gibt an, ob diese Verfügbarkeit bearbeitbar ist. |
| isRenewable | Bool | Gibt an, ob diese Verfügbarkeit verwendbar ist. |
| RenewalInstructions | RenewalInstruction | Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar. |
| product | Produkt | Das Produkt, dem diese Verfügbarkeit entspricht. |
| sku | sku | Die SKU, der diese Verfügbarkeit entspricht. |
| terms | Array von Ausdrucksressourcen | Die Sammlung von Bedingungen, die für diese Verfügbarkeit gelten. |
| Verknüpfungen | ResourceLinks | Die Ressourcenverknüpfungen, die in der Verfügbarkeit enthalten sind. |
Verlängerungsanweisung
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.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| applicableTermIds | Array aus Zeichenfolgen | Ausdrucks-IDs, für die die Anweisungen gelten |
| RenewalOptions | Array von RenewalOption | Optionen zum Definieren von Verlängerungen |
RenewalOption
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.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| renewToId | String | Stellt das Produkt und die SKU dar, auf das verlängert werden soll |
| isAutoRenewable | 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.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| duration | String | 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 | String | Die Beschreibung des Begriffs. |
InventoryCheckRequest
Stellt eine Anforderung zum Überprüfen des Inventars für bestimmte Katalogelemente dar.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| targetItems | Array von InventoryItem | Die Liste der Katalogelemente, die von der Bestandsüberprüfung ausgewertet werden. |
| inventoryContext | Schlüssel-Werte-Paare | Das Wörterbuch der Kontextwerte, die für die Durchführung der Bestandsüberprüfungen erforderlich sind. Jede SKU der Produkte definiert, welche Werte (falls vorhanden) erforderlich sind, um diesen Vorgang auszuführen. |
| Verknüpfungen | ResourceLinks | Die Ressourcenverknüpfung, die in der Bestandsüberprüfungsanforderung enthalten ist. |
InventoryItem
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.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| productId | String | (Erforderlich) Die ID des Produkts. |
| skuId | String | Die ID der SKU. Wenn Sie diese Ressource als Eingabe für eine Bestandsanforderung verwenden, ist dieser Wert optional. Wenn dieser Wert nicht angegeben wird, werden alle SKUs unter dem Produkt als Zielelemente des Bestandsüberprüfungsvorgangs betrachtet. |
| isRestricted | Bool | Gibt an, ob dieses Element über einen eingeschränkten Bestand verfügt. |
| Einschränkungen | Array von InventoryRestriction | Die Details aller Einschränkungen, die für dieses Element gefunden werden. Diese Eigenschaft wird nur ausgefüllt, wenn isRestricted = "true" ist. |
InventoryRestriction
Stellt die Details einer Bestandseinschränkung dar. Diese Details gelten nur für Die Ausgabeergebnisse der Bestandsüberprüfung, nicht für Eingabeanforderungen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| reasonCode | String | Der Code, der den Grund für die Einschränkung identifiziert. |
| Beschreibung | String | Die Beschreibung der Bestandsbeschränkung. |
| properties | Schlüssel-Werte-Paare | Das Wörterbuch der Eigenschaften, das weitere Details zur Einschränkung bereitstellen kann. |
BillingCycleType
Eine [Enum/dotnet/api/system.enum) mit Werten, die einen Typ von Abrechnungszeitraum angeben.
| Wert | Position | Beschreibung |
|---|---|---|
| Unbekannt | 0 | Enumerationsinitialisierer. |
| Monatlich | 1 | Gibt an, dass der Partner monatlich belastet wird. |
| Jährlich | 2 | Gibt an, dass der Partner jährlich belastet wird. |
| Keine | 3 | Gibt an, dass der Partner nicht belastet wird. Dieser Wert kann für Testelemente verwendet werden. |
| OneTime | 4 | Gibt an, dass der Partner einmal in Rechnung gestellt wird. |
| Dreijährig | 5 | Gibt an, dass der Partner alle drei Jahre in Rechnung gestellt wird. |
AttestationProperties
Stellt einen Nachweistyp dar und wenn er zum Kauf erforderlich ist.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| attestationType | String | 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-Hybridvorteil verwendet, auch eine gültige Kopie von Windows 10/11 Pro auf ihrem primären Arbeitsgerät installiert haben muss." |
| enforceAttestation | Boolean | Gibt an, ob der Nachweis für den Kauf erforderlich ist. |