Crie um produto gerido

A Faturação do Google Play permite-lhe oferecer produtos na aplicação que cobram os utilizadores uma única vez, conhecidos como produtos geridos. Os produtos geridos podem incluir itens, como bens virtuais (exemplo: níveis de jogos ou poções) e serviços premium na sua aplicação no Google Play.

• Também pode criar uma subscrição, que cobra aos utilizadores de forma recorrente.

Importante: as Políticas do Programa para Programadores e as taxas de transação do Google Play aplicam-se a todos os produtos na aplicação, incluindo produtos geridos e subscrições.

Disponibilidade

Se estiver numa localização que suporta o registo de comerciantes, pode utilizar a Faturação do Google Play.

Se estiver numa localização suportada e pretender começar a utilizar as funcionalidades da Faturação do Google Play nas suas aplicações, configure um perfil de pagamentos e consulte a documentação da API de Faturação do Google Play.

Depois de criar um produto gerido, este fica disponível para utilizadores com a versão mais recente da Google Play Store.

Autorizações necessárias

Para oferecer um produto gerido, tem de declarar a autorização com.android.vending.BILLING no ficheiro de manifesto do APK da sua aplicação. Se distribuir a sua aplicação em todo o mundo, pode continuar a publicar aplicações que utilizam a autorização com.android.vending.BILLING em todos os países.

Crie produtos geridos

Crie um único produto gerido

Antes de criar um produto gerido, certifique-se de que planeia os IDs do produto cuidadosamente. Os IDs do produto têm de ser exclusivos para a sua aplicação e, depois de os criar, não os pode alterar nem reutilizar.

• Os IDs do produto têm de começar por uma letra minúscula ou um número e apenas podem conter letras minúsculas (a-z), números (0-9), carateres de sublinhado (_) e pontos (.).
• Nota: o ID do produto android.test não está disponível para utilização, tal como todos os IDs do produto que começam por android.test.

Para criar um produto gerido:

1. Inicie sessão na Play Console.
2. Selecione uma aplicação.
3. No menu do lado esquerdo, clique em Presença na Google Play Store > Produtos na aplicação > Produtos geridos.
4. Clique em Criar produto gerido.
5. Introduza os detalhes do produto.
   • Título: nome abreviado do artigo (até 55 carateres, mas recomendamos que os títulos tenham até 25 carateres para que sejam corretamente apresentados em todos os contextos), tais como "Poção do sono".
   • Descrição: uma descrição longa do item (até 80 carateres), como "Adormece criaturas imediatamente".
   • Preço: introduza um preço na sua moeda local ou selecione um modelo de preços.
6. Junto a "Estado", selecione Ativo ou Inativo.
   • Para estar disponível para compra, um produto tem de estar ativo e a respetiva aplicação publicada.
   • Se estiver a utilizar uma conta de teste, os itens ativos estão disponíveis em aplicações não publicadas. Para saber mais, aceda ao nosso site Programadores do Android.
7. Clique em Guardar.

Idiomas e traduções

Os produtos geridos utilizam o mesmo idioma predefinido que a respetiva aplicação. Para adicionar traduções em idiomas específicos, selecione um produto gerido e, em seguida, clique em Adicionar traduções. Saiba mais acerca da tradução da sua aplicação.

Crie um lote de vários produtos geridos

Para criar vários produtos geridos em simultâneo, pode carregar um ficheiro CSV que inclua detalhes sobre cada um dos produtos.

Os ficheiros CSV utilizam vírgulas (,) e pontos e vírgula (;) para separar os valores de dados. As vírgulas separam valores de dados principais e os pontos e vírgula separam subvalores.

Quando estiver a criar um ficheiro CSV com produtos geridos, especifique a sintaxe do CSV na primeira linha, seguida dos detalhes dos produtos nas linhas seguintes.

Importante: cada item deve aparecer totalmente numa única linha no ficheiro CSV.

Carregue um ficheiro CSV de produtos geridos

1. Inicie sessão na Play Console.
2. Selecione uma aplicação.
3. No menu do lado esquerdo, clique em Presença na Google Play Store > Produtos na aplicação > Produtos geridos.
4. Clique em Importar/Exportar > Importar produtos geridos a partir de um ficheiro CSV.
   • Para substituir produtos geridos existentes na sua lista de produtos, selecione a caixa de verificação Substituir os produtos existentes. Esta ação substitui os produtos existentes apenas se o valor de um Product ID no ficheiro CSV corresponder ao Product ID de um produto gerido existente na lista de produtos. A substituição de um produto não elimina produtos geridos que não estejam incluídos no ficheiro CSV.
5. Clique em Procurar ficheiros e selecione o seu ficheiro CSV.

Exporte um ficheiro CSV de produtos geridos existentes

Se tiver criado produtos geridos individualmente na Play Console, exportar um ficheiro CSV pode ser uma excelente forma de começar a criá-los com um ficheiro CSV.

1. Inicie sessão na Play Console.
2. Selecione uma aplicação.
3. No menu do lado esquerdo, clique em Presença na Google Play Store > Produtos na aplicação > Produtos geridos.
4. Clique em Importar/Exportar > Exportar produtos na aplicação para ficheiro CSV.

Veja um ficheiro CSV de exemplo

Segue-se um exemplo da sintaxe do CSV a utilizar e três exemplos de produtos geridos:

• O primeiro exemplo define um título e uma descrição em dois idiomas diferentes (en_US e pt_PT). Um modelo de preços define o preço do artigo.
• O segundo exemplo não utiliza um modelo de preços. Em vez disso, especifica um preço para o país predefinido (EUA). A Play Console utiliza as taxas de câmbio atuais e os padrões de preços relevantes localmente para definir automaticamente os preços em todos os outros países onde a aplicação é distribuída.
• O terceiro exemplo também não utiliza um modelo de preços. O preço do artigo é especificado manualmente para cada país onde a aplicação é distribuída.

Sintaxe do CSV de exemplo

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Exemplos de produtos geridos

Exemplo 1

basic_sleeping_potion,publicado,managed_by_android,falso,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; pt_PT; Poção básica para dormir; Faz com que as criaturas pequenas vão dormir.,false,,4637138456024710495

Exemplo 2

standard_sleeping_potion, publicado,managed_by_android,falso,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Exemplo 3

invisibility_potion,publicado, managed_by_android,falso,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Valores de dados para ficheiros CSV 

Cada linha num ficheiro CSV de produtos geridos pode conter os seguintes valores, mas, pelo menos um destes valores não está definido em cada linha:  

Product ID	A definição deste valor no ficheiro CSV tem o mesmo efeito que introduzir um ID do produto ao criar um novo produto gerido. Se especificar um Product ID atribuído a um produto gerido que já exista na lista de produtos e tiver selecionado a caixa de verificação Substituir os produtos existentes na caixa de diálogo "Importar produtos na aplicação", os dados do produto gerido existente são substituídos pelos valores especificados no ficheiro CSV.
Publish State	Tem de definir este valor como published ou unpublished. É o mesmo que definir um produto gerido como Ativo ou Inativo.
Purchase Type	Tem de definir este valor como managed_by_android.
Auto Translate	Tem de definir este valor como false porque a tradução automática de detalhes de produtos geridos não é suportada. Se pretender fornecer traduções do título e da descrição de um produto gerido, especifique essas traduções explicitamente no valor Locale.
Locale, Title, e Description	Se incluir apenas um local para um artigo, tem de especificar o local predefinido da aplicação, bem como o título e a descrição predefinidos do artigo: app_default_locale; item_default_title; item_default_description; Quando definir o valor Locale, pode utilizar qualquer um dos códigos de idioma que aparecem ao adicionar traduções da ficha da loja. Nota: quando especificar os valores de Title e Description, utilize barras invertidas como caráter de escape dos carateres de ponto e vírgula (\;) e barra invertida (\\). Se pretender incluir versões traduzidas do título e da descrição do artigo, tem de indicar o local, o título e a descrição predefinidos, seguidos dos locais, títulos e descrições para cada tradução. No exemplo seguinte, o produto gerido usa en_US (inglês dos Estados Unidos) como o local predefinido e pt_PT (português de Portugal) como a tradução: en_US; Invisibility Cloak; Makes you invisible.; pt_PT; Capote invisível; Torna-o invisível. Nota: uma aplicação contém um único idioma predefinido, mas cada produto gerido mantém a sua própria lista de traduções. Embora o primeiro local no valor de Locale de cada artigo tenha de ser o mesmo em todo o ficheiro CSV, os outros locais podem ser diferentes para cada um dos artigos.
Auto Fill Prices, Country e Price	Pode definir Auto Fill Prices como true ou false. Se um produto gerido utilizar um modelo de preços, tem de definir Auto Fill Prices como false e não deverá definir um valor para Price. Nota: quando especificar o preço de um artigo num ficheiro CSV, indique um preço em microunidades, em que 1 000 000 de microunidades é equivalente a 1 unidade de moeda real. Use preços preenchidos automaticamente As secções seguintes descrevem como o valor de Auto Fill Prices afeta a sintaxe e o significado dos valores de Country e Price. Se definir Auto Fill Prices como true, está a especificar apenas o preço predefinido do artigo; não está a incluir um valor de Country. Por exemplo, nas seguintes condições: O local predefinido da aplicação é en_US. O preço predefinido de um produto gerido, sem impostos, é de 1,99 $. Pretende que os preços para outros países sejam preenchidos automaticamente. Deverá definir os valores de Auto Fill Prices e Price no final de uma coluna no ficheiro CSV do seguinte modo: true,1990000, Defina o preço por país   Se definir Auto Fill Prices como false, pode especificar uma série de valores de Country e Price para todos os países onde distribui a aplicação, incluindo o país correspondente ao local predefinido da sua aplicação. Cada valor de Country corresponde ao código ISO do país de duas letras maiúsculas que representa um país onde a aplicação é distribuída. Nota: tem de indicar um código do país e um preço para cada país a que a aplicação se destina. Para ver e editar a lista de países a que a sua aplicação se destina, abra a página Preços e distribuição da aplicação. Cada valor de Price representa o custo do artigo em microunidades da moeda utilizada nesse país. Por exemplo, se estiver a disponibilizar a sua aplicação para os seguintes preços (todos os impostos incluídos) noutros países: 6,99 R$ no Brasil  129 ₽ na Rússia 130 ₹ na Índia 27 000 Rp na Indonésia 37 $ no México Pode definir os valores de Auto Fill Prices, Country e Price no final de uma linha no ficheiro CSV do seguinte modo: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Se um artigo estiver associado a um modelo de preços, deve definir Auto Fill Prices como false e não deve definir um valor para a coluna Price. Se o artigo não estiver associado a um modelo de preços, não deverá definir um valor para Pricing Template ID. Em vez disso, deverá definir Auto Fill Prices, Country e Price com base na forma como pretende definir os preços do produto gerido. Se importar um ficheiro CSV e tiver assinalado a caixa de verificação Substituir os produtos existentes na caixa de diálogo "Importar produtos na aplicação", pode atualizar os links entre os produtos geridos e os modelos de preços. Para associar o produto a um modelo de preços específico, defina o valor Pricing Template ID para o ID desse modelo de preços. Para desassociar um produto gerido de todos os modelos de preços, não defina qualquer valor para o Pricing Template ID. Pode associar até 1000 preços de aplicações ou preços de produtos geridos a um determinado modelo de preços. Assim, não especifique o mesmo valor de Pricing Template ID em mais de 1000 linhas de um ficheiro CSV.