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. |
Links de produtos
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. |