Freigeben über


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.

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.