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,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
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

string

Período de assinatura, especificado no formato ISO 8601. Os valores aceitos são P1W (uma semana), P1M (um mês), P3M (três meses), P6M (seis meses) e P1Y (um ano).
trialPeriod

string

Período de teste, especificado no formato ISO 8601. Os valores aceitos estão entre P7D (7 dias) e P999D (999 dias).
gracePeriod

string

Período de carência da assinatura, especificado no formato ISO 8601. Permite que os desenvolvedores ofereçam aos assinantes um período de carência quando o pagamento para o novo período de recorrência for recusado. Os valores aceitos são P0D (zero dia), P3D (3 dias), P7D (7 dias), P14D (14 dias) e P30D (30 dias).

Campo de união TaxAndComplianceType.

TaxAndComplianceType pode ser apenas de um dos tipos a seguir:
subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Detalhes sobre tributos e conformidade jurídica. Aplicável somente para produtos por assinatura.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Detalhes sobre tributos e conformidade jurídica. Aplicável somente para produtos gerenciados.

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 Produto no app com um período recorrente.

InAppProductListing

Página Detalhes do app de um único produto no app.

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

string

Título da página Detalhes do app.
description

string

Descrição da página Detalhes do app.
benefits[]

string

Benefícios do direito a uma assinatura localizados.

ManagedProductTaxAndComplianceSettings

Detalhes sobre tributos e conformidade jurídica para produtos gerenciados.

Representação JSON 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
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.

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 um produto 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 Resolução
5xx Erro genérico no servidor do Google Play. Tente fazer a solicitação novamente.

Se o problema persistir, entre em contato com seu gerente de contas do Google Play ou envie uma solicitação de suporte. Verifique o Painel de status do Google Play para conferir se há interrupções conhecidas.
409 Erro de atualização de simultaneidade.

Houve uma tentativa de atualizar um objeto que já estava sendo atualizado. Por exemplo, uma compra está sendo confirmada ao chamar o método acknowledgePurchase() da Biblioteca Play Faturamento e o purchases.products.acknowledge da API Play Developer ao mesmo tempo.

 Tente fazer a solicitação novamente.