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