Compartilhar via


Recursos de produtos

Recursos que representam bens ou serviços compráveis. Inclui recursos para descrever o tipo e a forma do produto (SKU) e para verificar a disponibilidade do produto em um inventário.

Product

Representa um bem ou serviço comprável. Um produto por si só não é um item comprável.

Propriedade Type Descrição
id String A ID de um produto.
title String O título do produto.
descrição String A descrição do produto.
productType ItemType Um objeto que descreve a(s) categorização(ões) de tipo deste produto.
isMicrosoftProduct Bool Indica se o produto é um produto Microsoft.
publisherName String O nome do editor do produto, se disponível.
links Links de Produtos Os links de recursos contidos no produto.

ItemType

Representa o tipo de um produto.

Propriedade Type Descrição
id String O identificador de tipo.
displayName String O nome para exibição de um tipo de item.
subType ItemType Opcional. Um objeto que descreve uma categorização de subtipo para um tipo de item.

Contém uma lista de links para um Produto.

Propriedade Type Descrição
SKUs Link O link para acessar os SKUs subjacentes.
links ResourceLinks Os links de recurso contidos em um recurso.

Sku

Representa uma unidade de manutenção de estoque (SKU) comprável sob um produto.

Propriedade Type Descrição
id String A ID da SKU. O ID é exclusivo somente no contexto de seu produto pai.
title String O título do SKU.
descrição String A descrição do SKU.
productId String A ID do Produto pai que contém uma SKU.
mínimoQuantidade Int A quantidade mínima permitida para compra.
maximumQuantidade Int A quantidade máxima permitida para compra.
isTrial Bool Indica se uma SKU é um item de avaliação.
suportadosBillingCycles Matriz das cadeias de caracteres A lista de ciclos de faturamento com suporte para uma SKU. Os valores suportados são os nomes de membros encontrados em BillingCycleType.
compraPré-requisitos Matriz das cadeias de caracteres A lista de etapas ou ações de pré-requisito necessárias antes da compra de um item. Os valores com suporte são:
"InventoryCheck" - Indica que o estoque do item deve ser avaliado antes de tentar comprar um item.
"AzureSubscriptionRegistration" - Indica que uma assinatura do Azure é necessária e deve ser registrada antes de tentar comprar um item.
inventárioVariáveis Matriz das cadeias de caracteres A lista de variáveis necessárias para executar uma verificação de estoque em um item. Os valores com suporte são:
"CustomerId" - O ID do cliente para o qual a compra seria.
"AzureSubscriptionId" - A ID da assinatura do Azure que seria usada para uma compra de reserva do Azure.
"ArmRegionName" - A região para a qual verificar o inventário. Esse valor deve corresponder ao "ArmRegionName" dos DynamicAttributes da SKU.
provisionamentoVariáveis Matriz das cadeias de caracteres A lista de variáveis que devem ser fornecidas no contexto de provisionamento de um item de linha de carrinho ao comprar um item. Os valores com suporte são:
Escopo - O escopo para uma compra de reserva do Azure: "Único", "Compartilhado".
"SubscriptionId" - A ID da assinatura do Azure que seria usada para uma compra de reserva do Azure.
"Duração" - A duração da reserva do Azure: "1Year", "3Year".
dynamicAttributes Pares chave/valor O dicionário de propriedades dinâmicas que se aplicam a um item. As propriedades em um dicionário são dinâmicas e podem ser alteradas sem aviso prévio. Os parceiros devem evitar criar dependências fortes em chaves específicas existentes no valor de uma propriedade.
links ResourceLinks Os links de recursos contidos na SKU.
AttestationProperties AttestationProperties As propriedades de atestado para um SKU.
consumoTipo String Está disponível somente se o sku suportar o consumo, como excesso de idade.
specializedOfferProperties Lista de specializedOfferProperties Está disponível apenas se o produto for subTipo de SpecializedOffer.
mínimoCompraCompromisso MínimoCompraCompromisso O valor fixo comprometido em serviços de computação.

Atributos de SKU dinâmicos

Propriedades notáveis relevantes para novos produtos e serviços baseados em licenças comerciais.

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Propriedade Type Descrição
hasRestrições Booliano Descreve se a SKU contém assetContraints
isAddon Booliano Descreve se a SKU é um complemento
pré-requisitoSkus matriz de cadeias de caracteres Descreve produtos e skus com os quais o complemento pode trabalhar
upgradeTargetOfertas matriz de cadeias de caracteres Uma lista de produtos e skus para os quais o item pode ser atualizado
conversãoInstruções Lista de conversãoInstruções Lista de instruções aplicáveis às operações de conversão

specializedOfferProperties

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Aplicável apenas para subtipos de produtos "SpecializedOffers"

Propriedade Type Descrição
startDate String IDs de termo aos quais as instruções se aplicam
endDate String Opções que definem renovações
Políticas de preços Lista de preçosPolíticas Uma lista de políticas que definem os tipos e valores de desconto da promoção.

MínimoCompraCompromisso

Atributos do valor mínimo que pode ser comprometido em serviços de computação.

Propriedade Type Descrição
grão String O período do compromisso mínimo de compra.
currencyCode Cadeia de caracteres do dicionário<, cadeia de caracteres> A "moeda" e o "símbolo" do valor mínimo que pode ser comprometido.
valor Int O valor mínimo que pode ser comprometido em serviços de computação.

Políticas de Preços

Descreva os tipos e valores de desconto da promoção.

Propriedade Type Descrição
type String Descreva se o desconto é baseado em porcentagens ou descontos de taxa fixa.
value String Define o valor do desconto aplicado.

Disponibilidade

Representa uma configuração na qual uma SKU está disponível para compra (como país/região, moeda e segmento do setor).

Propriedade Type Descrição
id String O ID para essa disponibilidade. Esse ID é exclusivo somente no contexto de seu produto pai e SKU. Observação As IDs de disponibilidade podem mudar com o tempo. Os parceiros só devem confiar nesse valor dentro de um curto período de tempo após recuperá-lo.
productId String A ID do produto que contém essa disponibilidade.
skuId String A ID da SKU que contém essa disponibilidade.
catalogItemId String O identificador exclusivo para este item no catálogo. Essa ID deve ser preenchida nas propriedades OrderLineItem.OfferId ou CartLineItem.CatalogItemId ao comprar a SKU pai. Observação Essa ID pode mudar com o tempo. Você só deve confiar nesse valor dentro de um curto período de tempo depois de recuperá-lo. Ele só deve ser acessado e utilizado no momento da compra.
defaultMoeda String A moeda padrão suportada para essa disponibilidade.
segmento String O segmento da indústria para esta disponibilidade. Os valores suportados são: Comercial, Educação, Governo, Sem Fins Lucrativos.
country String O país ou região (no formato de código de país ISO) onde essa disponibilidade se aplica.
isComprado Bool Indica se essa disponibilidade pode ser comprada.
isRenovável Bool Indica se essa disponibilidade é renovável.
RenovaçãoInstruções RenovaçãoInstrução Representa as instruções de renovação para uma determinada disponibilidade.
produto Product O produto a que esta disponibilidade corresponde.
sku Sku O SKU a que esta disponibilidade corresponde.
terms Matriz de recursos de Termo A coleção de termos aplicáveis a esta disponibilidade.
links ResourceLinks Os links de recursos contidos na disponibilidade.

Instrução de renovação

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Representa as instruções de renovação para uma determinada disponibilidade.

Propriedade Type Descrição
aplicávelTermIds Matriz das cadeias de caracteres IDs de termo aos quais as instruções se aplicam
Opções de renovação Matriz de RenewalOption Opções que definem renovações

Opção de renovação

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Representa as instruções de renovação para uma determinada disponibilidade.

Propriedade Type Descrição
renewToId String Representa o produto e o sku a serem renovados
isAutoRenovável Bool Se a disponibilidade pode ou não ser renovada automaticamente

Termo

Representa um termo para o qual a disponibilidade pode ser comprada.

Propriedade Type Descrição
duration String Uma representação ISO 8601 da duração do termo. Os valores atuais suportados são P1M (um mês), P1Y (um ano) e P3Y (três anos).
descrição String A descrição do termo.

InventoryCheckRequest

Representa uma solicitação para verificar o estoque em relação a determinados itens de catálogo.

Propriedade Type Descrição
targetItems Matriz de InventoryItem A lista de itens de catálogo que a verificação de inventário avaliará.
inventárioContexto Pares chave-valor O dicionário de valores de contexto necessários para realizar a(s) verificação(ões) de inventário. Cada SKU dos produtos definirá quais valores (se houver) são necessários para realizar essa operação.
links ResourceLinks Os links de recursos contidos na solicitação de verificação de inventário.

InventoryItem

Representa um único item em uma operação de verificação de estoque. Esse recurso é usado para especificar os itens de destino em uma solicitação de entrada e também é usado para representar os resultados de saída da operação de verificação de estoque.

Propriedade Type Descrição
productId String (Obrigatório) A ID do produto.
skuId String O ID da SKU. Ao usar esse recurso como entrada para uma solicitação de inventário, esse valor é opcional. Se esse valor não for fornecido, todos os SKUs sob o produto serão considerados como itens de destino da operação de verificação de estoque.
éRestrito Bool Indica se esse item foi encontrado com um estoque restrito.
restrições Matriz de Restrição de Estoque Os detalhes de quaisquer restrições encontradas para este item. Essa propriedade só será preenchida se isRestricted = "true".

Restrição de Estoque

Representa os detalhes de uma restrição de inventário. Esses detalhes são aplicáveis apenas aos resultados de saída da verificação de estoque, não às solicitações de entrada.

Propriedade Type Descrição
reasonCode String O código que identifica o motivo da restrição.
descrição String A descrição da restrição de inventário.
properties Pares chave-valor O dicionário de propriedades que pode fornecer mais detalhes sobre a restrição.

BillingCycleType

Um [Enum/dotnet/api/system.enum) com valores que indicam um tipo de ciclo de faturamento.

Valor Posição Descrição
Desconhecido 0 Inicializador Enum.
Mensal 1 Indica que o parceiro será cobrado mensalmente.
Anual 2 Indica que o parceiro será cobrado anualmente.
Nenhum 3 Indica que o parceiro não será cobrado. Esse valor pode ser usado para itens de avaliação.
OneTime 4 Indica que o parceiro será cobrado uma vez.
Trienal 5 Indica que o sócio será cobrado a cada três anos.

AttestationProperties

Representa um tipo de atestado e se ele é necessário para a compra.

Propriedade Type Descrição
atestadoTipo String Indica o tipo de atestado. Os produtos Windows 365 terão o valor do Windows 365. O texto de atestado do Windows 365 é "Entendo que cada pessoa que usa o Windows 365 Business com o Benefício Híbrido do Windows também precisa ter uma cópia válida do Windows 10/11 Pro instalada em seu dispositivo de trabalho principal."
enforceAttestation Booliano Indica se o atestado é necessário para a compra.