Recursos de produtos

Artigo
07/19/2022
8 minutos para ler

Recursos que representam bens ou serviços puráveis. Inclui recursos para descrever o tipo e forma do produto (SKU), e para verificar a disponibilidade do produto num inventário.

Produto

Representa um bem ou serviço purivel. Um produto por si só não é um item puriável.

Propriedade	Tipo	Descrição
ID	String	A identificação de um produto.
título	String	O título do produto.
descrição	String	A descrição do produto.
productType	ItemType	Um objeto que descreve o tipo de categorização deste produto.
isMicrosoftProduct	Booleano	Indica se o produto é um produto Microsoft.
publisherName	String	O nome do editor do produto, se disponível.
ligações	Ligações de Produtos	As ligações de recursos contidas no produto.

TipoItem

Representa o tipo de produto.

Propriedade	Tipo	Descrição
ID	String	O tipo de identificador.
displayName	String	O nome do visor para um tipo de item.
subTipo	ItemType	Opcional. Um objeto que descreve uma categorização do subtipo para um tipo de item.

Ligações de Produtos

Contém uma lista de links para um Produto.

Propriedade	Tipo	Description
skus	Ligação	A ligação para o acesso aos SKUs subjacentes.
ligações	RecursosLinks	As ligações de recursos contidas num recurso.

Sku

Representa uma unidade de armazenamento de stock (SKU) em um produto.

Propriedade	Tipo	Descrição
ID	String	A identificação do SKU. O ID é único apenas no contexto do seu produto-mãe.
título	String	O título do SKU.
descrição	String	A descrição do SKU.
productId	String	O ID do produto-mãe que contém um SKU.
mínimoQuantidade	int	A quantidade mínima permitida para compra.
máximaQuantidade	int	A quantidade máxima permitida para compra.
isTrial	Booleano	Indica se um SKU é um item de teste.
suportadosBillingCycles	Matriz de cordas	A lista de ciclos de faturação suportados para um SKU. Os valores suportados são os nomes dos membros encontrados no BillingCycleType.
aquisiçãoPrerequites	Matriz de cordas	A lista de etapas ou ações pré-requisitos que são necessárias antes da compra de um item. Os valores suportados são: "InventoryCheck" - Indica que o inventário do artigo deve ser avaliado antes de tentar comprar um item. "AzureSubscriptionRegistration" - Indica que uma subscrição Azure é necessária e deve ser registada antes de tentar comprar um item.
inventárioVariables	Matriz de cordas	A lista de variáveis necessárias para executar uma verificação de inventário num item. Os valores suportados são: "CustomerId" - A identificação do cliente para a a que a compra seria. "AzureSubscriptionId" - O ID da subscrição Azure que seria usado para uma compra de reserva Azure. "ArmRegionName" - A região para a qual verificar o inventário. Este valor deve coincidir com o "ArmRegionName" dos DynamicAttributes do SKU.
provisionamentoVariables	Matriz de cordas	A lista de variáveis que devem ser fornecidas no contexto de provisionamento de um item da linha do carrinho na compra de um item. Os valores suportados são: Âmbito - O âmbito para uma compra de reserva Azure: "Single", "Shared". "SubscriptionId" - O ID da subscrição Azure que seria usado para uma compra de reserva Azure. "Duração" - A duração da reserva Azure: "1 Ano", "3º Ano".
dynamicAttributes	pares chave/valor	O dicionário de propriedades dinâmicas que se aplicam a um item. As propriedades num dicionário são dinâmicas e podem mudar sem aviso prévio. Os parceiros devem evitar criar fortes dependências de chaves específicas existentes no valor de um imóvel.
ligações	RecursosLinks	As ligações de recursos contidas no SKU.
AttestationProperties	AttestationProperties	As propriedades do atestado para um SKU.
tipo de consumo	String	Só está disponível se o sku suportar o consumo, como excesso de idade.
especialistasOfferProperties	Lista de OferProperties especializadas	Só está disponível se o produto for subTipo de SpecializedOffer.

Atributos Dinâmicos SKU

Imóveis notáveis relevantes para novos produtos e serviços baseados em licenças de comércio.

Nota

As novas experiências de comércio para serviços baseados em licenças incluem muitas novas capacidades e estão disponíveis para todos os Cloud Solution Provider (CSPs). Para mais informações, consulte novas experiências de comércio.

Propriedade	Tipo	Description
temConstratas	Booleano	Descreve se o SKU contém activosContraints
isAddon	Booleano	Descreve se o SKU é um addon
pré-requisitoSkus	matriz de cadeias (de carateres)	Descreve produtos e skus com o que o add-on pode trabalhar com
upgradeTargetOffers	matriz de cadeias (de carateres)	Uma lista de produtos e skus o item pode atualizar para
conversãoInstruturas	Lista de conversõesInstruções	Lista de instruções aplicáveis à conversão de operações

especialistasOfferProperties

Nota

Apenas aplicáveis aos subtiTypes de produtos "SpecializedOffers"

Propriedade	Tipo	Description
startDate	String	IDs de prazo as instruções se aplicam a
endDate	String	Opções que definem renovações
preçosPolícias	Lista de preçosPolícias	Uma lista de políticas que definem os tipos e valores de desconto de promoção.

PreçosPolícias

Descreva os tipos e valores de desconto de promoção.

Propriedade	Tipo	Descrição
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 em que um SKU está disponível para compra (como país, moeda e segmento da indústria).

Propriedade	Tipo	Descrição
ID	String	O ID para esta disponibilidade. Este ID é único apenas no contexto do seu produto-mãe e SKU. Nota Os IDs de disponibilidade podem ser alterados ao longo do tempo. Os parceiros só devem confiar neste valor num curto espaço de tempo após a sua recuperação.
productId	String	O ID do produto que contém esta disponibilidade.
skuId	String	O ID do SKU que contém esta disponibilidade.
catalogItemId	String	O identificador único para este item no catálogo. Este ID deve ser preenchido nas propriedades OrderLineItem.OfferId ou CartLineItem.CatalogItemId ao comprar o SKU-mãe. Nota Esta identificação pode mudar com o tempo. Só deve confiar neste valor num curto espaço de tempo após a sua recuperação. Só deve ser acedido e utilizado no momento da compra.
incumprimentoSidade	String	A moeda predefinida suportada para esta disponibilidade.
segmento	String	O segmento da indústria para esta disponibilidade. Os valores suportados são: Comercial, Educação, Governo, Não Lucrativo.
país	String	O país ou região (em formato de código de país ISO) onde esta disponibilidade se aplica.
isCompessível	Booleano	Indica se esta disponibilidade é purável.
isRenewable	Booleano	Indica se esta disponibilidade é renovável.
RenovaçãoInstruções	RenovaçãoInstrução	Representa instruções de renovação para uma determinada disponibilidade.
produto	Produto	O produto a que esta disponibilidade corresponde.
sku	Sku	O SKU esta disponibilidade corresponde a.
termos	Matriz de recursos de prazo	A recolha de termos que são aplicáveis a esta disponibilidade.
ligações	RecursosLinks	As ligações de recursos contidas na disponibilidade.

Instrução de renovação

Nota

Representa instruções de renovação para uma determinada disponibilidade.

Propriedade	Tipo	Description
aplicaçãoTermIds	Matriz de cordas	IDs de prazo as instruções se aplicam a
Opções de Renovação	Matriz de RenovaçãoOption	Opções que definem renovações

Renovação

Nota

Representa instruções de renovação para uma determinada disponibilidade.

Propriedade	Tipo	Description
renovarToId	String	Representa o produto e sku para renovar para
isAutoRenewable	Booleano	Se a disponibilidade pode ou não ser renovada automaticamente

Termo

Representa um termo para o qual a disponibilidade pode ser adquirida.

Propriedade	Tipo	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 um pedido de verificação do inventário em certos itens de catálogo.

Propriedade	Tipo	Description
targetItems	Matriz de InventárioItem	A lista de itens de catálogo que o cheque de inventário irá avaliar.
inventárioContexto	Pares chave/valor	O dicionário de valores de contexto necessários para a realização do(s) verificação de inventário. Cada SKU dos produtos definirá quais os valores (se houver) necessários para realizar esta operação.
ligações	RecursosLinks	As ligações de recursos contidas no pedido de verificação de inventário.

InventárioItem

Representa um único item numa operação de verificação de inventário. Este recurso é utilizado para especificar os itens-alvo num pedido de entrada e é também utilizado para representar os resultados da operação de verificação de inventário.

Propriedade	Tipo	Description
productId	String	(Obrigatório) A identificação do produto.
skuId	String	A identificação do SKU. Ao utilizar este recurso como entrada para um pedido de inventário, este valor é opcional. Se este valor não for fornecido, todos os SKUs ao abrigo do produto serão considerados como itens-alvo da operação de verificação de inventário.
isRestrited	Booleano	Indica se este item foi encontrado com um inventário restrito.
Restrições	Matriz de InventárioRestricação	Os detalhes de quaisquer restrições que sejam encontradas para este item. Esta propriedade só será povoada se forRestricted = "true".

InventárioRestrics

Representa os detalhes de uma restrição de inventário. Estes detalhes são aplicáveis apenas para os resultados da verificação de inventário, e não para pedidos de entrada.

Propriedade	Tipo	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 podem fornecer mais detalhes sobre a restrição.

BillingCycleType

Um [Enum/dotnet/api/system.enum) com valores que indicam um tipo de ciclo de faturação.

Valor	Posição	Description
Desconhecido	0	Inicializador Enum.
Mensalmente	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á carregado. Este valor pode ser utilizado para itens de ensaio.
OneTime	4	Indica que o parceiro será carregado uma vez.
Trienal	5	Indica que o parceiro será cobrado de três em três anos.

AttestationProperties

Representa um tipo de atestado e se for necessário para compra.

Propriedade	Tipo	Description
attestationType	String	Indica o tipo de atestado. Os produtos Windows 365 terão o valor do Windows365. O texto de atestado do Windows 365 é "Entendo que cada pessoa que utiliza o Windows 365 Business with Windows Hybrid Benefit também precisa de ter uma cópia válida do Windows 10/11 Pro instalada no seu dispositivo de trabalho primário."
impor Attestation	Booleano	Indica se o atestado é necessário para compra.