Partilhar 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.

Produto

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

Propriedade Tipo Descrição
identificação Corda A ID de um produto.
título Corda O título do produto.
Descrição Corda A descrição do produto.
tipo de produto TipoDeItem Um objeto que descreve as categorizações de tipo deste produto.
isMicrosoftProduct Bool Indica se o produto é um produto da Microsoft.
Nome do editor Corda O nome do editor do produto, se disponível.
ligações Links de produtos Os links de recursos contidos no produto.

Tipo de Item

Representa o tipo de um produto.

Propriedade Tipo Descrição
identificação Corda O identificador de tipo.
nome de exibição Corda O nome de exibição para um tipo de item.
subtipo TipoDeItem Opcional. Um objeto que descreve uma categorização de subtipo para um tipo de item.

Contém uma lista de links para um Product.

Propriedade Tipo Descrição
Unidades de Manutenção de Stock (SKUs) Ligação O link para acessar as SKUs subjacentes.
ligações Ligações 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 Tipo Descrição
identificação Corda O ID do SKU. O identificador é exclusivo apenas dentro do contexto do produto pai.
título Corda O título do SKU.
Descrição Corda A descrição do SKU.
productId Corda O ID do produto pai que contém uma SKU.
quantidade mínima int A quantidade mínima permitida para compra.
quantidadeMáxima int A quantidade máxima permitida para compra.
isTrial Bool Indica se uma SKU é um item de avaliação.
ciclos de cobrança suportados Matriz de cadeias de caracteres 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 de caracteres 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.
variáveis de inventário Matriz de cadeias de caracteres 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.
variáveis de provisionamento Matriz de cadeias de caracteres A lista de variáveis que devem ser fornecidas no contexto de provisionamento de uma linha de item do carrinho ao comprar um item. Os valores suportados são:
Âmbito - O âmbito para a compra de uma reserva no Azure: "Único", "Partilhado".
"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 uma forte dependência de chaves específicas existentes no valor de uma propriedade.
ligações Ligações de Recursos Os links de recursos contidos na SKU.
Propriedades de Atestação AttestationProperties As propriedades de certificação para um SKU.
tipo de consumo Corda Está disponível apenas se o código de produto (SKU) permitir consumo, como o excesso de utilização .
propriedades de oferta especializada Lista de propriedades de oferta especializada Está disponível apenas se o produto for subtipo de 'SpecializedOffer'.
compromisso de compra mínima CompromissoMínimoDeCompra O montante fixo comprometido em serviços de computação.

Atributos dinâmicos de SKU

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

Propriedade Tipo Descrição
temRestrições Booleano Descreve se a UMS contém restrições de ativos
éAddon Booleano Descreve se a SKU é um complemento
pré-requisitosSkus matriz de strings Descreve os produtos e SKUs com os quais o complemento pode trabalhar
upgradeTargetOffers matriz de strings Uma lista de produtos e skus para os quais o item pode ser atualizado
Instruções de Conversão Lista de instruções de conversão Lista de instruções aplicáveis às operações de conversão

propriedades de oferta especializada

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 (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 Tipo Descrição
data de início Corda IDs de termos aos quais as instruções se aplicam
Data de fim Corda 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.

Compromisso de Compra Mínima

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

Propriedade Tipo Descrição
cereais Corda O período do compromisso mínimo de compra.
código de moeda Dicionário<String, String> A "moeda" e o "símbolo" do valor mínimo que pode ser comprometido.
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 Tipo Descrição
tipo Corda Descreva se o desconto se baseia em percentagens ou descontos de taxa fixa.
valor Corda 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 Tipo Descrição
identificação Corda O identificador desta disponibilidade. Este ID é exclusivo no contexto do seu produto pai e SKU. Observação Identificadores 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 obtenção.
productId Corda O ID do produto que contém esta disponibilidade.
skuId Corda O ID do SKU que contém essa disponibilidade.
Id do Item do Catálogo Corda O identificador exclusivo deste artigo no catálogo. Esta ID deve ser preenchida nas propriedades OrderLineItem.OfferId ou CartLineItem.CatalogItemId ao comprar o SKU pai . Nota Este 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 Corda A moeda padrão suportada para esta disponibilização.
segmento Corda O segmento da indústria para esta disponibilidade. Os valores suportados são: Comercial, Educação, Governo, Sem Fins Lucrativos.
país Corda O país ou região (no formato de código de país ISO) onde esta disponibilidade se aplica.
está disponível para compra Bool Indica se essa disponibilidade é comprável.
éRenovável Bool Indica se essa disponibilidade é renovável.
Instruções de Renovação Instruções de Renovaçã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 Term O conjunto de termos aplicáveis a esta disponibilidade.
ligações Ligações de Recursos 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 (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 Tipo Descrição
IdentificadoresDeTermosAplicáveis Matriz de cadeias de caracteres IDs de termos 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 (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 Tipo Descrição
renovarToId Corda Representa o produto e o sku que será renovado
éRenovávelAutomaticamente Bool Se a disponibilidade pode ou não ser renovada automaticamente

Prazo

Representa um termo cuja disponibilidade pode ser adquirida.

Propriedade Tipo Descrição
Duração Corda 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 Corda A descrição do termo.
termLifeCycleState Corda Uma descrição do ciclo de vida. Esses valores suportados incluem GA (geralmente disponível, EndOfSale e EndofSaleWithConversions. Essa propriedade só será retornada se includeLifeCycleState estiver definido como true ao chamar a get availability by id API.

Pedido de Verificação de Inventário

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

Propriedade Tipo Descrição
itens-alvo Matriz de InventoryItem A lista de itens de catálogo que a verificação de inventário avalia.
inventárioContexto Pares chave/valor O dicionário de valores de contexto que são necessários para realizar as verificações de inventário. Cada SKU dos produtos determina quais valores (se houver) são necessários para realizar esta operação.
ligações Ligações de Recursos Os links de recursos contidos na solicitação de verificação de inventário.

Item do Inventário

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 Tipo Descrição
productId Corda (Obrigatório) O ID do produto .
skuId Corda ID do SKU . Este 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.
estáRestrito 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ó é preenchida se isRestricted = "true".

Restrição de Inventário

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 Tipo Descrição
código de motivo Corda O código que identifica o motivo da restrição.
Descrição Corda A descrição da restrição de inventário.
propriedades Pares chave/valor O dicionário de propriedades que podem fornecer detalhes adicionais sobre a restrição.

Tipo de Ciclo de Faturação

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

Valor Posição Descrição
Desconhecido 0 Inicializador de enum.
Mensal 1 Indica que o parceiro é cobrado mensalmente.
Anual 2 Indica que o parceiro é cobrado anualmente.
Nenhum 3 Indica que o parceiro não é cobrado. Esse valor pode ser usado para itens de avaliação.
Uma única vez 4 Indica que o parceiro é cobrado apenas uma vez.
Trienal 5 Indica que o parceiro é cobrado a cada três anos.

Propriedades de Atestação

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

Propriedade Tipo Descrição
tipo de atestado Corda Indica o tipo de atestado. Os produtos Windows 365 têm 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."
imporAtestação Booleano Indica se o atestado é necessário para a compra.