Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Recursos que representam bens ou serviços adquiríveis. Inclui recursos para descrever o tipo de produto e a forma (SKU) e para verificar a disponibilidade do produto em um inventário.
Produto
Representa um bem ou serviço adquirível. Um produto por si só não é um item comprável.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | fio | A ID de um produto. |
| título | fio | O título do produto. |
| descrição | fio | A descrição do produto. |
| tipoDeProduto | Tipo de Item | Um objeto que descreve as categorizações de tipo deste produto. |
| isMicrosoftProduct | Bool | Indica se o produto é um produto da Microsoft. |
| nomeDoPublicador | fio | O nome do editor do produto, se disponível. |
| Links | ProductLinks | Os links de recurso contidos no produto. |
Tipo de Item
Representa o tipo de um produto.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | fio | O identificador de tipo. |
| nome de exibição | fio | O nome de exibição de 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 Produto.
| Propriedade | Tipo | Descrição |
|---|---|---|
| códigos SKU | Link | O link para acessar as SKUs subjacentes. |
| Links | Links de recursos | Os links de recurso contidos em um recurso. |
Sku
Representa uma SKU (Unidade de Manutenção de Estoque) adquirível em um produto.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | fio | O ID do SKU. A ID é única somente no contexto do seu produto de origem. |
| título | fio | O título da SKU. |
| descrição | fio | A descrição da SKU. |
| ID do produto | fio | O ID do produto pai que contém um SKU. |
| quantidadeMínima | Int | A quantidade mínima permitida para compra. |
| quantidadeMáxima | Int | A quantidade máxima permitida para compra. |
| isTrial | Bool | Indica se um SKU é um item de avaliação. |
| ciclosDeCobrançaSuportados | Matriz das cadeias de caracteres | A lista de ciclos de cobrança suportados para um SKU. Os valores com suporte são os nomes de membro encontrados em BillingCycleType. |
| pré-requisitos de compra | 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 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 das cadeias de caracteres | A lista de variáveis necessárias para executar uma verificação de inventário em um item. Os valores com suporte são: "CustomerId" – A 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. |
| variáveisDeProvisionamento | Matriz das cadeias de caracteres | A lista de variáveis que devem ser fornecidas no contexto de provisionamento de um item de linha do carrinho durante a compra desse item. Os valores com suporte são: Escopo – O escopo de uma compra de reserva do Azure: "Single", "Shared". "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: "1 Ano", "3 Anos". |
| 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 a criação de dependências fortes em chaves específicas existentes no valor de uma propriedade. |
| Links | Links de recursos | Os links de recurso contidos no SKU. |
| Propriedades de atestação | AttestationProperties | As propriedades de atestado de um SKU. |
| tipo de consumo | fio | Disponível apenas se o SKU fornecer suporte para consumo, como uso além do limite. |
| propriedadesDeOfertaEspecializada | Lista de propriedades da oferta especializada | Só estará disponível se o produto for subtipo de Oferta Especializada. |
| compromisso mínimo de compra | CompromissoDeCompraMínima | O valor fixo alocado nos serviços de computação. |
Atributos de SKU dinâmicos
Propriedades notáveis relevantes para novos produtos e serviços baseados em licenças de comércio.
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 | Tipo | Descrição |
|---|---|---|
| possuiRestrições | Booliano | Descreve se o SKU contém restrições de ativos |
| isAddon | Booliano | Descreve se o SKU é um complemento |
| pré-requisitosSkus | Matriz de cadeias de caracteres | Descreve produtos e skus com os quais o complemento pode funcionar |
| 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 para converter operações |
propriedadesDeOfertaEspecializada
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 somente para subTipos de produto "SpecializedOffers"
| Propriedade | Tipo | Descrição |
|---|---|---|
| Data de Início | fio | IDs de termos aos quais as instruções se aplicam |
| data de término | fio | Opções que definem renovações |
| políticas de preços | Lista de políticas de preços | Uma lista de políticas que definem os tipos e valores de desconto de promoção. |
Compromisso de Compra Mínima
Atributos da quantia mínima que pode ser comprometida nos serviços de computação.
| Propriedade | Tipo | Descrição |
|---|---|---|
| grão | fio | 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. |
| quantidade | Int | O valor mínimo que pode ser comprometido nos serviços de computação. |
Políticas de Preços
Descreva os tipos e valores de desconto de promoção.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tipo | fio | Descreva se o desconto é baseado em percentuais ou descontos de taxa fixa. |
| valor | fio | Define o valor do desconto aplicado. |
Disponibilidade
Representa uma configuração na qual um SKU está disponível para compra (como país/região, moeda e segmento do setor).
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | fio | O ID para essa disponibilidade. Essa ID é exclusiva apenas no contexto de seu produto pai e SKU. Nota As IDs de disponibilidade podem ser alteradas ao longo do tempo. Os parceiros só devem contar com esse valor em um curto período de tempo depois de recuperá-lo. |
| ID do produto | fio | A ID do produto que contém essa disponibilidade. |
| skuId | fio | O ID do SKU que contém esta disponibilidade. |
| catalogItemId | fio | O identificador exclusivo para este produto no catálogo. Essa ID deve ser preenchida nas propriedades OrderLineItem.OfferId ou CartLineItem.CatalogItemId ao comprar o SKU pai. Nota Essa ID pode ser alterada ao longo do tempo. Você só deve confiar nesse valor logo após recuperá-lo. Ele só deve ser acessado e usado no momento da compra. |
| moeda padrão | fio | A moeda padrão suportada para esta disponibilidade. |
| segmento | fio | O segmento da indústria para essa disponibilidade. Os valores com suporte são: Comercial, Educação, Governo, Sem Fins Lucrativos. |
| país | fio | O país ou região (no formato de código de país ISO) em que essa disponibilidade se aplica. |
| éComprável | Bool | Indica se essa disponibilidade é adquirível. |
| éRenovável | Bool | Indica se essa disponibilidade é renovável. |
| Instruções de Renovação | RenewalInstruction | Representa instruções de renovação para uma determinada disponibilidade. |
| produto | Produto | O produto ao qual essa disponibilidade corresponde. |
| Sku | Sku | A SKU à qual essa disponibilidade corresponde. |
| termos | Conjunto de recursos Termo | A coleção de termos aplicáveis a essa disponibilidade. |
| Links | Links de recursos | Os links de recurso 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 instruções de renovação para uma determinada disponibilidade.
| Propriedade | Tipo | Descrição |
|---|---|---|
| IdentificadoresTermosAplicáveis | Matriz das cadeias de caracteres | IDs de termos aos quais as instruções se aplicam |
| Opções de Renovação | Matriz de Opção de Renovação | 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 instruções de renovação para uma determinada disponibilidade.
| Propriedade | Tipo | Descrição |
|---|---|---|
| renewToId | fio | Representa o produto e o SKU a renovar |
| isAutoRenewable | Bool | Se a disponibilidade pode ou não ser renovada automaticamente |
Prazo
Representa um termo para o qual a disponibilidade pode ser adquirida.
| Propriedade | Tipo | Descrição |
|---|---|---|
| duração | fio | Uma representação ISO 8601 da duração do prazo. Os valores atuais com suporte são P1M (um mês), P1Y (um ano) e P3Y (três anos). |
| descrição | fio | A descrição do termo. |
| termLifeCycleState | fio | Uma descrição do ciclo de vida. Esses valores com suporte incluem GA (geralmente disponível, EndOfSale e EndofSaleWithConversions. Essa propriedade só é retornada se includeLifeCycleState for definido como true ao usar a API get availability by id. |
SolicitacaoDeVerificacaoDeInventario
Representa uma solicitação para verificar o inventário em relação a determinados itens de catálogo.
| Propriedade | Tipo | Descrição |
|---|---|---|
| targetItems | Matriz de InventoryItem | A lista de itens de catálogo que a verificação de inventário avalia. |
| contextoDoInventário | Pares chave/valor | O dicionário de valores de contexto necessários para realizar as verificações de inventário. Cada SKU dos produtos determina quais valores (se houver) são necessários para executar essa operação. |
| Links | Links de recursos | Os links de recurso contidos na solicitação de verificação de inventário. |
Item de inventário
Representa um único item em uma operação de verificação de inventário. 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 inventário.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ID do produto | fio | (Obrigatório) A ID do produto. |
| skuId | fio | O ID da SKU. Esse valor é opcional. Se esse valor não for fornecido, todas as SKUs no produto serão consideradas como itens de destino da operação de verificação de inventário. |
| éRestrito | Bool | Indica se esse item foi encontrado com um inventário restrito. |
| Restrições | Matriz de InventoryRestriction | Os detalhes de todas as restrições encontradas para este item. Essa propriedade só será 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 somente 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 razão | fio | O código que identifica o motivo da restrição. |
| descrição | fio | A descrição da restrição de inventário. |
| propriedades | Pares chave/valor | O dicionário de propriedades capaz de fornecer mais detalhes sobre a restrição. |
Tipo de Ciclo de Cobrança
Um [Enum/dotnet/api/system.enum) com valores que indicam um tipo de ciclo de cobrança.
| Valor | Posição | Descrição |
|---|---|---|
| Desconhecido | 0 | Inicializador de enumeração. |
| Mensalmente | 1 | Indica que o parceiro é cobrado mensalmente. |
| Anual | 2 | Indica que o parceiro é cobrado anualmente. |
| Nenhum | 3 | Indica que não há cobrança para o parceiro. Esse valor pode ser usado para itens de avaliação. |
| Onetime | 4 | Indica que o parceiro é cobrado uma única vez. |
| Trienal | 5 | Indica que o parceiro é cobrado a cada três anos. |
Propriedades de atestação
Representa um tipo de atestado e se ele é necessário para compra.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tipo de atestado | fio | Indica o tipo de atestado. Os produtos do Windows 365 têm o valor do Windows 365. O texto do 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 primário". |
| enforceAttestation | Booliano | Indica se o atestado é necessário para compra. |