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