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 String A ID de um produto.
título Sequência de caracteres O título do produto.
Descrição String 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 String O nome do editor do produto, se disponível.
ligações ProductLinks Os links de recursos contidos no produto.

Tipo de Item

Representa o tipo de um produto.

Propriedade Tipo Descrição
identificação String O identificador de tipo.
nome de exibição Cadeia O nome de exibição para um tipo de item.
subtipo 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 Product.

Propriedade Tipo Descrição
Unidades de Manutenção de Stock (SKUs) Link 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 String O título do SKU.
Descrição String A descrição do SKU.
productId String 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 String 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
isAddon 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 cadeias de caracteres 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 String IDs de termos aos quais as instruções se aplicam
Data de fim Cadeia 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 String 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 Fio Descreva se o desconto se baseia em percentagens ou descontos de taxa fixa.
valor Cadeia 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 String 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 String O ID do produto que contém esta disponibilidade.
skuId String O ID do SKU que contém essa disponibilidade.
catalogItemId String 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 String A moeda padrão suportada para esta disponibilização.
segmento Cordas O segmento da indústria para esta disponibilidade. Os valores suportados são: Comercial, Educação, Governo, Sem Fins Lucrativos.
país Cadeia 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 String 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 Cadeia 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.

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 avaliará.
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 definirá 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 Cadeia (Obrigatório) O ID do produto .
skuId String ID do 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.
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ó será preenchida se estiver restrito = "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
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 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 será cobrado mensalmente.
Anual 2 Indica que o parceiro será sujeito a uma cobrança anual.
Nenhum 3 Indica que o parceiro não será cobrado. Esse valor pode ser usado para itens de avaliação.
Uma única vez 4 Indica que o parceiro será cobrado uma única vez.
Trienal 5 Indica que o parceiro será 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 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."
imporAtestação Booleano Indica se o atestado é necessário para a compra.