Condividi tramite

Risorse dei prodotti

  • Articolo

Risorse che rappresentano beni o servizi acquistabili. Include le risorse per descrivere il tipo di prodotto e la forma (SKU) e per verificare la disponibilità del prodotto in un inventario.

Prodotto

Rappresenta un bene o un servizio acquistabile. Un prodotto da solo non è un articolo acquistabile.

Proprietà Type Descrizione
id String ID di un prodotto.
title String Titolo del prodotto.
description Stringa Descrizione del prodotto.
productType ItemType Oggetto che descrive la categorizzazione di tipo di questo prodotto.
isMicrosoftProduct Bool Indica se il prodotto è un prodotto Microsoft.
publisherName String Nome dell'editore del prodotto, se disponibile.
collegamenti ProductLinks Collegamenti alle risorse contenuti all'interno del prodotto.

ItemType

Rappresenta il tipo di un prodotto.

Proprietà Type Descrizione
id String Identificatore del tipo.
displayName String Nome visualizzato per un tipo di elemento.
subType ItemType Facoltativo. Oggetto che descrive una categorizzazione del sottotipo per un tipo di elemento.

Contiene un elenco di collegamenti per un prodotto.

Proprietà Type Descrizione
SKU Collegamento Collegamento per l'accesso agli SKU sottostanti.
collegamenti ResourceLinks Collegamenti alle risorse contenuti all'interno di una risorsa.

Sku

Rappresenta un'unità di mantenimento delle scorte (SKU) acquistabile in un prodotto.

Proprietà Type Descrizione
id String ID per lo SKU. L'ID è univoco solo all'interno del contesto del prodotto padre.
title String Titolo dello SKU.
description Stringa Descrizione dello SKU.
productId String ID del prodotto padre che contiene uno SKU.
minimumQuantity Int Quantità minima consentita per l'acquisto.
maximumQuantity Int Quantità massima consentita per l'acquisto.
isTrial Bool Indica se uno SKU è un elemento di valutazione.
supportedBillingCycles Matrice di stringhe Elenco dei cicli di fatturazione supportati per uno SKU. I valori supportati sono i nomi di membro presenti in BillingCycleType.
purchasePrerequisites Matrice di stringhe Elenco di passaggi o azioni prerequisiti necessari prima di acquistare un articolo. I valori supportati sono:
"InventoryCheck" - Indica che l'inventario dell'articolo deve essere valutato prima di tentare di acquistare un articolo.
"AzureSubscriptionRegistration" - Indica che è necessaria una sottoscrizione di Azure e deve essere registrata prima di tentare di acquistare un articolo.
inventoryVariables Matrice di stringhe Elenco di variabili necessarie per eseguire un controllo dell'inventario su un elemento. I valori supportati sono:
"CustomerId" - ID del cliente per il quale l'acquisto sarebbe dovuto.
"AzureSubscriptionId" - ID della sottoscrizione di Azure che verrebbe usata per un acquisto di prenotazione di Azure.
"ArmRegionName" - Area per cui verificare l'inventario. Questo valore deve corrispondere a "ArmRegionName" da DynamicAttributes dello SKU.
provisioningVariables Matrice di stringhe Elenco di variabili che devono essere fornite nel contesto di provisioning di un articolo della riga del carrello durante l'acquisto di un articolo. I valori supportati sono:
Ambito: ambito per l'acquisto di una prenotazione di Azure: "Single", "Shared".
"SubscriptionId" - ID della sottoscrizione di Azure che verrebbe usata per un acquisto di prenotazione di Azure.
"Duration" - Durata della prenotazione di Azure: "1Year", "3Year".
dynamicAttributes coppie chiave/valore Dizionario di proprietà dinamiche che si applicano a un elemento. Le proprietà in un dizionario sono dinamiche e possono cambiare senza preavviso. I partner devono evitare di creare dipendenze complesse da chiavi specifiche esistenti nel valore di una proprietà.
collegamenti ResourceLinks Collegamenti alle risorse contenuti nello SKU.
AttestazioniProprietà AttestazioniProprietà Proprietà di attestazione per uno SKU.
consumptionType String È disponibile solo se lo SKU supporta l'utilizzo, ad esempio l'eccedenza.
specializedOfferProperties Elenco di specializedOfferProperties È disponibile solo se il prodotto è subType di SpecializedOffer.
minimumPurchaseCommitment MinimumPurchaseCommitment Importo fisso di cui è stato eseguito il commit nei servizi di calcolo.

Attributi SKU dinamici

Proprietà rilevanti relative a nuovi prodotti e servizi basati sulle licenze commerciali.

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

Proprietà Type Descrizione
hasConstraints Booleano Descrive se lo SKU contiene assetContraints
isAddon Booleano Descrive se lo SKU è un componente aggiuntivo
prerequisitoSkus matrice di stringhe Descrive i prodotti e gli SKU con cui il componente aggiuntivo può funzionare
upgradeTargetOffers matrice di stringhe Un elenco di prodotti e SKU a cui l'elemento può eseguire l'aggiornamento
conversionInstructions Elenco di conversionInstructions Elenco di istruzioni applicabili alle operazioni di conversione

specializedOfferProperties

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

Applicabile solo per i sottoTipi di prodotto "SpecializedOffers"

Proprietà Type Descrizione
startDate String ID termini a cui si applicano le istruzioni
endDate String Opzioni che definiscono i rinnovi
pricingPolicies Elenco dei prezziCriteri Elenco di criteri che definiscono i tipi e i valori di sconto promozionali.

MinimumPurchaseCommitment

Attributi della quantità minima di cui è possibile eseguire il commit nei servizi di calcolo.

Proprietà Type Descrizione
grano String Periodo dell'impegno minimo di acquisto.
currencyCode String del<dizionario, stringa> La "valuta" e il "simbolo" dell'importo minimo che è possibile impegnare.
amount Int Importo minimo di cui è possibile eseguire il commit nei servizi di calcolo.

PricingPolicies

Descrivere i tipi e i valori di sconto promozionali.

Proprietà Type Descrizione
type String Descrivere se lo sconto è basato su percentuali o sconti a tariffa fissa.
value String Definisce l'importo dello sconto applicato.

Disponibilità

Rappresenta una configurazione in cui uno SKU è disponibile per l'acquisto(ad esempio paese/area geografica, valuta e segmento del settore).

Proprietà Type Descrizione
id String ID per questa disponibilità. Questo ID è univoco solo all'interno del contesto del prodotto padre e dello SKU. Nota Gli ID di disponibilità possono cambiare nel tempo. I partner devono basarsi solo su questo valore entro un breve intervallo di tempo dopo il recupero.
productId String ID del prodotto che contiene questa disponibilità.
skuId String ID dello SKU che contiene questa disponibilità.
catalogItemId String Identificatore univoco per questo elemento nel catalogo. Questo ID deve essere popolato nelle proprietà OrderLineItem.OfferId o CartLineItem.CatalogItemId durante l'acquisto dello SKU padre. Nota Questo ID può cambiare nel tempo. È consigliabile basarsi solo su questo valore entro un breve periodo di tempo dopo il recupero. Deve essere accessibile e utilizzato solo al momento dell'acquisto.
defaultCurrency String Valuta predefinita supportata per questa disponibilità.
segment String Segmento di settore per questa disponibilità. I valori supportati sono: Commercial, Education, Government, NonProfit.
country String Paese o area geografica (in formato codice paese ISO) in cui si applica questa disponibilità.
isPurchasable Bool Indica se questa disponibilità è acquistabile.
isRenewable Bool Indica se questa disponibilità è rinnovabile.
RenewalInstructions RenewalInstruction Rappresenta le istruzioni di rinnovo per una determinata disponibilità.
product Prodotto Il prodotto a cui corrisponde questa disponibilità.
sku Sku Lo SKU a cui corrisponde questa disponibilità.
terms Matrice di risorse termini Raccolta di termini applicabili a questa disponibilità.
collegamenti ResourceLinks Collegamenti alle risorse contenuti nella disponibilità.

Istruzione di rinnovo

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

Rappresenta le istruzioni di rinnovo per una determinata disponibilità.

Proprietà Type Descrizione
applicableTermIds Matrice di stringhe ID termini a cui si applicano le istruzioni
RenewalOptions Matrice di RenewalOption Opzioni che definiscono i rinnovi

RenewalOption

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

Rappresenta le istruzioni di rinnovo per una determinata disponibilità.

Proprietà Type Descrizione
renewToId String Rappresenta il prodotto e lo SKU a cui eseguire il rinnovo
isAutoRenewable Bool Indica se la disponibilità può essere rinnovata automaticamente

Termine

Rappresenta un termine per il quale è possibile acquistare la disponibilità.

Proprietà Type Descrizione
duration String Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
description Stringa Descrizione del termine.

InventoryCheckRequest

Rappresenta una richiesta di controllo dell'inventario rispetto a determinati elementi del catalogo.

Proprietà Type Descrizione
targetItems Matrice di InventoryItem Elenco di elementi del catalogo che verranno valutati dal controllo dell'inventario.
inventoryContext Coppie chiave/valore Dizionario dei valori di contesto necessari per eseguire i controlli di inventario. Ogni SKU dei prodotti definirà i valori (se presenti) necessari per eseguire questa operazione.
collegamenti ResourceLinks Collegamenti alle risorse contenuti nella richiesta di controllo dell'inventario.

InventoryItem

Rappresenta un singolo elemento in un'operazione di controllo dell'inventario. Questa risorsa viene usata per specificare gli elementi di destinazione in una richiesta di input e viene usata anche per rappresentare i risultati di output dell'operazione di controllo dell'inventario.

Proprietà Type Descrizione
productId String (Obbligatorio) ID del prodotto.
skuId String ID dello SKU. Quando si usa questa risorsa come input per una richiesta di inventario, questo valore è facoltativo. Se questo valore non viene specificato, tutti gli SKU nel prodotto verranno considerati come articoli di destinazione dell'operazione di controllo dell'inventario.
isRestricted Bool Indica se l'articolo è stato trovato per avere un inventario limitato.
restrizioni Matrice di InventoryRestriction Dettagli di eventuali restrizioni trovate per questo elemento. Questa proprietà verrà popolata solo se isRestricted = "true".

InventoryRestriction

Rappresenta i dettagli di una restrizione dell'inventario. Questi dettagli sono applicabili solo per i risultati dell'output del controllo inventario, non per le richieste di input.

Proprietà Type Descrizione
reasonCode String Codice che identifica il motivo della restrizione.
description Stringa Descrizione della restrizione dell'inventario.
proprietà Coppie chiave/valore Dizionario di proprietà che possono fornire ulteriori dettagli sulla restrizione.

BillingCycleType

[Enum/dotnet/api/system.enum) con valori che indicano un tipo di ciclo di fatturazione.

Valore Posizione Descrizione
Sconosciuto 0 Inizializzatore di enumerazione.
Mensile 1 Indica che il partner verrà addebitato mensilmente.
Annuale 2 Indica che il partner verrà addebitato annualmente.
None 3 Indica che il partner non verrà addebitato. Questo valore può essere usato per gli elementi di valutazione.
OneTime 4 Indica che il partner verrà addebitato una sola volta.
Triennale 5 Indica che il partner verrà addebitato ogni tre anni.

AttestazioniProprietà

Rappresenta un tipo di attestazione e, se necessario per l'acquisto.

Proprietà Type Descrizione
attestationType String Indica il tipo di attestazione. I prodotti Windows 365 avranno il valore di Windows 365. Il testo dell'attestazione di Windows 365 è "Capisco che ogni persona che usa Windows 365 Business con Vantaggio Windows Hybrid deve avere anche una copia valida di Windows 10/11 Pro installata nel dispositivo di lavoro principale".
enforceAttestation Booleano Indica se l'attestazione è necessaria per l'acquisto.