REST Resource: inappproducts

Recurso: InAppProduct

Um produto no app. O recurso para InappproductsService.

Representação JSON
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
Campos
packageName

string

Nome do pacote do app principal.

sku

string

Unidade de manutenção de estoque (SKU) do produto, exclusiva em um app.

status

enum (Status)

O status do produto, por exemplo, se ele está ativo.

purchaseType

enum (PurchaseType)

O tipo de produto, por exemplo, uma assinatura recorrente.

defaultPrice

object (Price)

Preço padrão. Não pode ser zero, já que os produtos no app nunca são sem custo financeiro. Está sempre na moeda de pagamento na loja do desenvolvedor.

prices

map (key: string, value: object (Price))

Preços por região do comprador. Nenhum desses valores pode ser zero, já que os produtos no app nunca são sem custo financeiro. A chave do mapa é o código regional, conforme definido pelo ISO 3166-2.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

listings

map (key: string, value: object (InAppProductListing))

inappproducts.list com dados de descrição e título localizados. A chave do mapa é o idioma dos dados localizados, conforme definido pelo BCP-47, por exemplo, "en-US".

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

defaultLanguage

string

Idioma padrão dos dados localizados, conforme definido pelo BCP-47, por exemplo, "en-US".

subscriptionPeriod
(deprecated)

string

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

trialPeriod
(deprecated)

string

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

gracePeriod
(deprecated)

string

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Detalhes sobre tributos e conformidade legal. Aplicável somente para produtos gerenciados.

Fim dos campos mutuamente exclusivos.

Status

O status de um produto no app.

Tipos enumerados
statusUnspecified Status não especificado.
active O produto foi publicado e está ativo na loja.
inactive O produto não foi publicado e está inativo na loja.

PurchaseType

O tipo do produto.

Tipos enumerados
purchaseTypeUnspecified Tipo de compra não especificado.
managedUser O tipo de produto padrão: compra única.
subscription

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

InAppProductListing

Página de detalhes de um único produto no app.

Representação JSON
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Campos
title

string

Título da página de detalhes do app.

description

string

Descrição da página de detalhes do app.

benefits[]
(deprecated)

string

Descontinuado: as assinaturas não são mais compatíveis com a API InAppProducts. Use a API Subscriptions.

ManagedProductTaxAndComplianceSettings

Detalhes sobre tributos e conformidade legal para produtos gerenciados.

Representação JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Campos
eeaWithdrawalRightType

enum (WithdrawalRightType)

Classificação de conteúdo ou serviço digital para produtos distribuídos a usuários no Espaço Econômico Europeu (EEE). O regime de desistência sob as leis de defesa do consumidor no EEE depende dessa classificação. Consulte o artigo da Central de Ajuda para mais informações.

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Um mapeamento dos detalhes da taxa tributária por código regional. As chaves são códigos regionais, definidos pelo CLDR do Unicode.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isTokenizedDigitalAsset

boolean

Se este produto no app é declarado como um produto que representa um ativo digital tokenizado.

regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Informações regionais sobre classificação indicativa. No momento, esse campo só é aceito para o código de região US.

productTaxCategoryCode

string

Código da categoria fiscal do produto a ser atribuído ao produto no app. A categoria fiscal do produto determina as alíquotas tributárias sobre transações aplicadas ao item. Consulte o artigo da Central de Ajuda para mais informações.

Métodos

batchDelete

Exclui produtos no app (produtos gerenciados ou assinaturas).

batchGet

Lê vários produtos no app, que podem ser produtos gerenciados ou assinaturas.

batchUpdate

Atualiza ou insere um ou mais produtos no app (produtos gerenciados ou assinaturas).

delete

Exclui um produto no app (produto gerenciado ou assinatura).

get

Recebe um produto no app, que pode ser gerenciado ou uma assinatura.

insert

Cria um produto no app (produto gerenciado ou assinatura).

list

Lista todos os produtos no app, gerenciados e assinaturas.

patch

Adiciona patches a um produto no app (produto gerenciado ou assinatura).

update

Atualiza um produto no app (produto gerenciado ou assinatura).

Códigos de erro

As operações desse recurso retornam os seguintes códigos de erro HTTP:

Código do erro Motivo Descrição Resolução