Recursos de produtosProducts resources

Aplica-se aApplies To

  • Partner CenterPartner Center

Recursos que representam bens ou serviços compráveiss.Resources that represent purchasable goods or services. Inclui recursos para descrever o tipo de produto e a forma (SKU) e para verificar a disponibilidade do produto em um inventário.Includes resources for describing the product type and shape (SKU), and for checking the availability of the product in an inventory.

ProdutoProduct

Representa um bom ou serviço compráveis.Represents a purchasable good or service. Um produto por si só não é um item compráveis.A product by itself isn't a purchasable item.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring A ID deste produto.The ID for this product.
títulotitle stringstring O título do produto.The product title.
descriçãodescription stringstring A descrição do produto.The product description.
productTypeproductType ItemTypeItemType Um objeto que descreve a categorização de tipo deste produto.An object that describes the type categorization(s) of this product.
isMicrosoftProductisMicrosoftProduct boolbool Indica se este é um produto da Microsoft.Indicates whether this is a Microsoft product.
publisherNamepublisherName stringstring O nome do Publicador do produto, se disponível.The name of the product's publisher if available.
linkslinks ProductLinksProductLinks Os links de recursos contidos no produto.The resource links contained within the product.

ItemTypeItemType

Representa o tipo de um produto.Represents the type of a product.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring O identificador de tipo.The type identifier.
displayNamedisplayName stringstring O nome para exibição deste tipo.The display name for this type.
SubtiposubType ItemTypeItemType Opcional.Optional. Um objeto que descreve uma categorização de subtipo para esse tipo de item.An object that describes a sub-type categorization for this item type.

Contém uma lista de links para um produto.Contains a list of links for a Product.

PropriedadeProperty TipoType DescriçãoDescription
SKUsskus LinkLink O link para acessar os SKUs subjacentes.The link for accessing the underlying SKUs.
linkslinks ResourceLinksResourceLinks Os links de recurso contidos neste recurso.The resource links contained within this resource.

SkuSku

Representa uma SKU (unidade de manutenção de estoque) compráveis em um produto.Represents a purchasable Stock Keeping Unit (SKU) under a product. Elas representam as diferentes formas do produto.These represent the different shapes of the product.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring A ID desta SKU.The ID for this SKU. Essa ID é exclusiva somente dentro do contexto de seu produto pai.This ID is unique only within the context of its parent product.
títulotitle stringstring O título da SKU.The title of the SKU.
descriçãodescription stringstring A descrição da SKU.The description of the SKU.
productIdproductId stringstring A ID do produto pai que contém este SKU.The ID of the parent Product that contains this SKU.
minimumQuantityminimumQuantity INTint A quantidade mínima permitida para compra.The minimum quantity allowed for purchase.
maximumQuantitymaximumQuantity INTint A quantidade máxima permitida para compra.The maximum quantity allowed for purchase.
isTrialisTrial boolbool Indica se este SKU é um item de avaliação.Indicates whether this SKU is a trial item.
supportedBillingCyclessupportedBillingCycles Matriz de cadeias de caracteresarray of strings A lista de ciclos de cobrança com suporte para esta SKU.The list of supported billing cycles for this SKU. Os valores suportados são os nomes de membros encontrados em BillingCycleType.Supported values are the member names found in BillingCycleType.
purchasePrerequisitespurchasePrerequisites Matriz de cadeias de caracteresarray of strings A lista de etapas ou ações de pré-requisito que são necessárias antes de comprar este item.The list of prerequisite steps or actions that are needed prior to purchasing this item. Os valores com suporte são:The supported values are:
"InventoryCheck" – indica que o inventário do item deve ser avaliado antes de tentar comprar este item."InventoryCheck" - Indicates that the item's inventory should be evaluated before attempting to purchase this item.
"AzureSubscriptionRegistration" – indica que uma assinatura do Azure é necessária e deve ser registrada antes de tentar comprar este item."AzureSubscriptionRegistration" - Indicates that an Azure subscription is needed and must be registered before attempting to purchase this item.
inventoryVariablesinventoryVariables Matriz de cadeias de caracteresarray of strings A lista de variáveis necessárias para executar uma verificação de inventário neste item.The list of variables needed to execute an inventory check on this item. Os valores com suporte são:The supported values are:
"CustomerId" – a ID do cliente para a qual a compra seria."CustomerId" - The ID of the customer that the purchase would be for.
"AzureSubscriptionId" – a ID da assinatura do Azure que seria usada para uma compra de reserva do Azure."AzureSubscriptionId" - The ID of the Azure subscription that would be used for an Azure reservation purchase.
"ArmRegionName" – a região para a qual verificar o inventário."ArmRegionName" - The region for which to verify inventory. Esse valor deve corresponder a "ArmRegionName" do Dynamicattributes da SKU.This value must match the "ArmRegionName" from the SKU's DynamicAttributes.
provisioningVariablesprovisioningVariables Matriz de cadeias de caracteresarray of strings A lista de variáveis que deve ser fornecida no contexto de provisionamento de um item de linha do carrinho ao comprar este item.The list of variables that must be provided into the provisioning context of a cart line item when purchasing this item. Os valores com suporte são:The supported values are:
Escopo-o escopo de uma compra de reserva do Azure: "único", "compartilhado".Scope - The scope for an Azure reservation purchase: "Single", "Shared".
"SubscriptionId" – a ID da assinatura do Azure que seria usada para uma compra de reserva do Azure."SubscriptionId" - The ID of the Azure subscription that would be used for an Azure reservation purchase.
"Duration" – a duração da reserva do Azure: "1Year", "3Year"."Duration" - The duration of the Azure reservation: "1Year", "3Year".
dinâmicoattributesdynamicAttributes pares de chave/valorkey/value pairs O dicionário de propriedades dinâmicas que se aplica a este item.The dictionary of dynamic properties that apply to this item. Observe que as propriedades nesse dicionário são dinâmicas e podem ser alteradas sem aviso prévio.Please note that the properties in this dictionary are dynamic and can change without notice. Você não deve criar dependências fortes em chaves específicas existentes no valor dessa propriedade.You should not create strong dependencies on particular keys existing in the value of this property.
linkslinks ResourceLinksResourceLinks Os links de recursos contidos no SKU.The resource links contained within the SKU.

DisponibilidadeAvailability

Representa uma configuração na qual um SKU está disponível para compra (como país, moeda e segmento do setor).Represents a configuration in which a SKU is available for purchase (such as country, currency, and industry segment).

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring A ID dessa disponibilidade.The ID for this availability. Essa ID é exclusiva somente dentro do contexto de seu produto pai e SKU.This ID is unique only within the context of its parent product and SKU. Observação Essa ID pode mudar ao longo do tempo.Note This ID can change over time. Você só deve contar com esse valor dentro de um curto período de tempo depois de recuperá-lo.You should only rely on this value within a short time span after retrieving it.
productIdproductId stringstring A ID do produto que contém essa disponibilidade.The ID of the product that contains this availability.
skuIdskuId stringstring A ID do SKU que contém essa disponibilidade.The ID of the SKU that contains this availability.
catalogItemIdcatalogItemId stringstring O identificador exclusivo para este item no catálogo.The unique identifier for this item in the catalog. Essa é a ID que deve ser preenchida nas propriedades OrderLineItem. OfferId ou CartLineItem. CatalogItemId ao adquirir o SKUpai.This is the ID that must be populated into the OrderLineItem.OfferId or CartLineItem.CatalogItemId properties when purchasing the parent SKU. Observação Essa ID pode mudar ao longo do tempo.Note This ID can change over time. Você só deve contar com esse valor dentro de um curto período depois de recuperá-lo.You should only rely on this value within a short time after retrieving it. Ele só deve ser acessado e usado no momento da compra.It should only be accessed and used at the time of purchase.
defaultcurrencydefaultCurrency stringstring A moeda padrão com suporte para esta disponibilidade.The default currency supported for this availability.
segmentosegment stringstring O segmento do setor para essa disponibilidade.The industry segment for this availability. Os valores com suporte são: comercial, educação, governo, sem fins lucrativos.Supported values are: Commercial, Education, Government, NonProfit.
countrycountry stringstring O país ou a região (no formato de código ISO Country) em que essa disponibilidade se aplica.The country or region (in ISO country code format) where this availability applies.
isPurchasableisPurchasable boolbool Indica se essa disponibilidade é compráveis.Indicates whether this availability is purchasable.
isrenovávelisRenewable boolbool Indica se esta disponibilidade é renovável.Indicates whether this availability is renewable.
productproduct ProductProduct O produto ao qual essa disponibilidade corresponde.The product this availability corresponds to.
skusku SkuSku A SKU à qual essa disponibilidade corresponde.The SKU this availability corresponds to.
termsterms recursos de matriz de termoarray of Term resources A coleção de termos que se aplica a essa disponibilidade.The collection of terms that are applicable to this availability.
linkslinks ResourceLinksResourceLinks Os links de recursos contidos na disponibilidade.The resource links contained within the availability.

TermoTerm

Representa um termo para o qual a disponibilidade pode ser comprada.Represents a term for which the availability can be purchased.

PropriedadeProperty TipoType DescriçãoDescription
durationduration stringstring Uma representação ISO 8601 da duração do termo.An ISO 8601 representation of the term's duration. Os valores atuais com suporte são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).The current supported values are P1M (1 month), P1Y (1 year) and P3Y (3 years).
descriçãodescription stringstring A descrição do termo.The description of the term.

InventoryCheckRequestInventoryCheckRequest

Representa uma solicitação para verificar o inventário em determinados itens de catálogo.Represents a request to check inventory against certain catalog items.

PropriedadeProperty TipoType DescriçãoDescription
targetItemstargetItems matriz de InventoryItemarray of InventoryItem A lista de itens de catálogo que será avaliada pela verificação de inventário.The list of catalog items that the inventory check will evaluate.
inventoryContextinventoryContext pares de chave/valorkey/value pairs O dicionário de valores de contexto que são necessários para realizar as verificações de estoque.The dictionary of context values that are needed to carry out the inventory check(s). Cada SKU dos produtos definirá quais valores (se houver) serão necessários para realizar essa operação.Each SKU of the products will define which values (if any) are needed to carry out this operation.
linkslinks ResourceLinksResourceLinks Os links de recursos contidos na solicitação de verificação de inventário.The resource links contained within the inventory check request.

InventoryItemInventoryItem

Representa um único item em uma operação de verificação de inventário.Represents a single item in an inventory check operation. 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.This resource is used for specifying the target items in an input request and is also used to represent the output results of the inventory check operation.

PropriedadeProperty TipoType DescriçãoDescription
productIdproductId stringstring Necessária A ID do produto.(Required) The ID of the product.
skuIdskuId stringstring A ID do SKU.The ID of the SKU. Ao usar esse recurso como entrada para uma solicitação de inventário, esse valor é opcional.When using this resource as input to an inventory request, this value is optional. 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.If this value isn't provided, then all SKUs under the product will be considered as target items of the inventory check operation.
IsRestrictedisRestricted boolbool Indica se este item foi encontrado para ter um inventário restrito.Indicates whether this item was found to have a restricted inventory.
restriçõesrestrictions matriz de InventoryRestrictionarray of InventoryRestriction Os detalhes das restrições encontradas para este item.The details of any restrictions that are found for this item. Essa propriedade só será populada se IsRestricted = "true".This property will only be populated if isRestricted = "true".

InventoryRestrictionInventoryRestriction

Representa os detalhes de uma restrição de inventário.Represents the details of an inventory restriction. Isso só é aplicável para resultados de saída de verificação de inventário, não para solicitações de entrada.This is only applicable for inventory check output results, not for input requests.

PropriedadeProperty TipoType DescriçãoDescription
reasonCodereasonCode stringstring O código que identifica o motivo da restrição.The code that identifies the reason for the restriction.
descriçãodescription stringstring A descrição da restrição de inventário.The description of the inventory restriction.
propertiesproperties pares de chave/valorkey/value pairs O dicionário de propriedades que pode fornecer mais detalhes sobre a restrição.The dictionary of properties that may provide further details on the restriction.

BillingCycleTypeBillingCycleType

Um [enum/dotnet/API/System. Enum) com valores que indicam um tipo de ciclo de cobrança.An [Enum/dotnet/api/system.enum) with values that indicate a type of billing cycle.

ValorValue PosiçãoPosition DescriçãoDescription
UnknownUnknown 00 Inicializador de enumeração.Enum initializer.
MensalmenteMonthly 11 Indica que o parceiro será cobrado mensalmente.Indicates that the partner will be charged monthly.
AnualAnnual 22 Indica que o parceiro será cobrado anualmente.Indicates that the partner will be charged annually.
NenhumNone 33 Indica que o parceiro não será cobrado.Indicates that the partner will not be charged. Esse valor pode ser usado para itens de avaliação.This value may be used for trial items.
OneTimeOneTime 44 Indica que o parceiro será cobrado uma vez.Indicates that the partner will be charged one time.