Partilhar via


Recursos dos 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.

Produto

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 Tipo de Item Um objeto que descreve a(s) categorização(ões) de tipo deste produto.
isMicrosoftProduct Bool Indica se o produto é um produto da Microsoft.
publisherName String O nome do editor do produto, se disponível.
ligações Links de produtos Os links de recursos contidos no produto.

TipoItem

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 Tipo de Item 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 Description
SKUs Ligação O link para acessar as SKUs subjacentes.
ligações Links de Recursos Os links de recursos contidos em um recurso.

Sku

Representa uma Unidade de Manutenção de Estoque (SKU) que pode ser comprada sob um produto.

Propriedade Type Descrição
id String A ID da SKU. O ID é exclusivo apenas dentro do 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.
supportedBillingCycles Matriz de cadeias A lista de ciclos de faturamento suportados para uma SKU. Os valores suportados são os nomes de membros encontrados em BillingCycleType.
compraPré-requisitos Matriz de cadeias A lista de etapas ou ações de pré-requisito necessárias antes de comprar um item. Os valores suportados são:
"InventoryCheck" - Indica que o inventário 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 de cadeias A lista de variáveis necessárias para executar uma verificação de inventário em um item. Os valores suportados 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" do DynamicAttributes da SKU.
provisionamentoVariáveis Matriz de cadeias 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 suportados 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: "1Ano", "3Ano".
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 fortes dependências em chaves específicas existentes no valor de uma propriedade.
ligações Links de Recursos Os links de recursos contidos na SKU.
AttestationProperties AttestationProperties As propriedades de atestado para um SKU.
consumptionType String Está disponível apenas se o sku suportar 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 montante fixo comprometido em serviços de computação.

Atributos de SKU dinâmico

Propriedades notáveis relevantes para novos produtos e serviços baseados em licença de comércio.

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

Propriedade Type Description
hasConstraints Boolean Descreve se a SKU contém assetContraints
isAddon Boolean Descreve se a SKU é um complemento
pré-requisiteSkus matriz de cadeias Descreve os produtos e skus com os quais o complemento pode trabalhar
upgradeTargetOffers matriz de cadeias Uma lista de produtos e skus para os quais o item pode ser atualizado
conversionInstruções Lista de instruções de conversão Lista de instruções aplicáveis às operações de conversão

specializedOfferProperties

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

Aplicável apenas aos subtipos de produtos "SpecializedOffers"

Propriedade Type Description
startDate String IDs de termo aos quais as instruções se aplicam
endDate String Opções que definem renovações
preçosPolíticas 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 Description
cereais String O período do compromisso mínimo de compra.
currencyCode Cadeia de dicionário<, String> A "moeda" e o "símbolo" do montante mínimo que pode ser autorizado.
montante 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 Description
tipo String Descreva se o desconto se baseia em percentagens ou descontos de taxa fixa.
valor 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 de setor).

Propriedade Type Descrição
id String O ID para esta disponibilidade. Essa ID é exclusiva apenas no contexto de seu produto pai e SKU. Observação Os IDs de disponibilidade podem mudar ao longo do tempo. Os parceiros só devem contar com este valor num curto espaço de tempo após a sua recuperação.
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 ao longo do tempo. Você só deve confiar nesse valor dentro de um curto período de tempo após recuperá-lo. Só deve ser acedido e utilizado no momento da compra.
defaultCurrency 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.
país/região String O país ou região (no formato de código de país ISO) onde esta disponibilidade se aplica.
isPurchasable Bool Indica se essa disponibilidade é comprável.
isRenewable 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 Produto O produto a que esta disponibilidade corresponde.
sku Sku O SKU a que esta disponibilidade corresponde.
termos Matriz de recursos de termo A recolha de termos aplicáveis a esta disponibilidade.
ligações Links de Recursos Os links de recursos contidos na disponibilidade.

Instrução de renovação

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

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

Propriedade Type Description
applicableTermIds Matriz de cadeias IDs de termo aos quais as instruções se aplicam
RenovaçãoOpções Matriz de RenewalOption Opções que definem renovações

RenewalOption

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

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

Propriedade Type Description
renovarToId String Representa o produto e o sku a ser renovado para
isAutoRenewable 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 Description
duration String Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (um mês), P1Y (um ano) e P3Y (três anos).
descrição String A descrição do termo.

InventárioCheckRequest

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

Propriedade Type Description
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 esta operação.
ligações Links de Recursos Os links de recursos contidos na solicitação de verificação de inventário.

InventárioItem

Representa um único item em uma operação de verificação de inventário. Este 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 inventário.

Propriedade Type Description
productId String (Obrigatório) O ID do produto.
skuId String A 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.
isRestricted Bool Indica se esse item foi encontrado com um inventário restrito.
Restrições Matriz de InventoryRestriction Os detalhes de quaisquer restrições encontradas para este item. Esta propriedade só será preenchida se isRestricted = "true".

InventárioRestrição

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

Propriedade Type Description
reasonCode String O código que identifica o motivo da restrição.
descrição String A descrição da restrição de inventário.
propriedades 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.

Value Position Description
Desconhecido 0 Inicializador de enum.
Mensal 1 Indica que o parceiro será cobrado mensalmente.
Anuais 2 Indica que o parceiro será cobrado anualmente.
Nenhuma 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 parceiro será cobrado a cada três anos.

AttestationProperties

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

Propriedade Type Description
attestationType String Indica o tipo de atestado. Os produtos Windows 365 terão o valor do Windows 365. O texto do atestado do Windows 365 é "Eu entendo que cada pessoa que usa o Windows 365 Business com o Windows Hybrid Benefit também precisa ter uma cópia válida do Windows 10/11 Pro instalada em seu dispositivo de trabalho principal."
execuçãoAtestado Boolean Indica se o atestado é necessário para a compra.