O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Como se preparar

Este tópico lista e descreve as etapas de configuração necessárias para poder vender produtos no seu aplicativo. Em um nível alto, essa configuração inclui a criação de uma conta de desenvolvedor, a criação e configuração dos produtos que você quer vender e a ativação e configuração das APIs usadas para vender e gerenciar seus produtos. Este tópico também descreve como configurar as notificações do desenvolvedor em tempo real para serem enviadas sempre que o status de um produto for modificado.

Configurar uma conta de desenvolvedor do Google Play

Para publicar seus apps e jogos no Google Play, use o Google Play Console. Você também pode usar o Google Play Console para gerenciar seus produtos e configurações relacionados ao faturamento.

Para acessar o Google Play Console, configure uma conta de desenvolvedor do Google Play.

Para vender apps pagos e compras no aplicativo no Google Play, é preciso configurar um perfil na central de pagamentos do Google e vinculá-lo à sua conta de desenvolvedor do Google Play. Para aprender a vincular o perfil à sua conta ou para verificar se você já tem uma conta e um perfil vinculados, consulte Vincular uma conta de desenvolvedor do Google Play ao seu perfil para pagamentos.

Ativar recursos relacionados ao faturamento no Google Play Console

Depois de configurar uma conta de desenvolvedor, publique uma versão do seu aplicativo que inclua a biblioteca do Google Play Faturamento. Essa etapa é necessária para ativar recursos relacionados ao faturamento no Google Play Console, como a configuração dos produtos que você quer vender.

Adicionar dependência da biblioteca

Para integrar o sistema de faturamento do Google Play, primeiro adicione uma dependência à biblioteca do Google Play Faturamento no seu app. Essa biblioteca fornece acesso às APIs do Android que conectam você ao Google Play. Lá, você pode acessar informações das compras, consultar atualizações sobre elas, pedir para um usuário fazer novas compras e muito mais.

A biblioteca do Google Play Faturamento está disponível no repositório Maven do Google. Adicione a dependência ao arquivo build.gradle do seu app da seguinte maneira:

dependencies {
    def billing_version = "3.0.0"

    implementation 'com.android.billingclient:billing:$billing_version'
}

Se você usa o Kotlin, o módulo KTX da biblioteca do Google Play Faturamento tem compatibilidade com extensões e corrotinas de Kotlin que permitem escrever Kotlin idiomático ao usar o sistema de faturamento do Google Play. Para incluir essas extensões no projeto, adicione a seguinte dependência ao arquivo build.gradle do app, como mostrado:

dependencies {
    def billing_version = "3.0.0"

    implementation 'com.android.billingclient:billing-ktx:$billing_version'
}

Fazer upload do seu app

Depois de adicionar a biblioteca, crie e publique o aplicativo. Nesta etapa, crie seu aplicativo e o publique em qualquer faixa, incluindo a faixa de teste interno.

Criar e configurar seus produtos

Depois de ativar os recursos do Google Play Faturamento para seu app, você precisará configurar os produtos para venda.

As etapas para criar assinaturas e produtos de aquisição única são semelhantes. Para cada produto, é necessário fornecer um ID do produto exclusivo, um título, uma descrição e informações sobre os preços. As assinaturas precisam conter mais informações, como o período de renovação, se você está oferecendo um teste gratuito e se a assinatura tem uma oferta inicial.

O Google Play Console tem uma interface da Web que pode ser usada para gerenciar seus produtos.

  • Para criar e configurar produtos de aquisição única, consulte Criar um produto gerenciado. Observe que o Google Play Console se refere a produtos de aquisição única como produtos gerenciados.

  • Para criar e configurar assinaturas, consulte Criar uma assinatura.

Como alternativa à interface da Web, também é possível gerenciar seus produtos usando o recurso REST inappproducts na API Google Play Developer.

Configurar a API Google Play Developer

A API Google Play Developer é uma API de servidor para servidor que complementa a biblioteca do Google Play Faturamento no Android. Essa API oferece funcionalidades que não estão disponíveis na biblioteca do Google Play Faturamento, como a verificação segura de compras e a emissão de reembolsos aos usuários.

Como parte da integração do sistema de faturamento do Google Play ao seu app, você precisa configurar o acesso à API Google Play Developer pelo Google Play Console. Para ver instruções, consulte Primeiros passos com a API Google Play Developer.

Depois de configurar o acesso à API Google Play Developer, verifique se você concedeu a permissão Ver dados financeiros, que é necessária para acessar os recursos relacionados ao faturamento. Para mais informações sobre práticas recomendadas e sobre como configurar permissões, consulte Adicionar usuários de contas de desenvolvedor e gerenciar permissões.

Configurar notificações do desenvolvedor em tempo real

As notificações do desenvolvedor em tempo real (RTDN, na sigla em inglês) são um mecanismo para receber notificações do Google sempre que houver mudanças na titularidade de um usuário no seu app. As RTDN aproveitam o uso do Google Cloud Pub/Sub, que permite receber dados enviados para um URL definido ou pesquisados usando uma biblioteca de cliente. Essas notificações permitem que você reaja imediatamente às mudanças de estado da assinatura, evitando a necessidade de pesquisar a API Google Play Developer. O uso ineficiente da API Google Play Developer pode levar a restrições de cota da API.

O Cloud Pub/Sub é um serviço de mensagens em tempo real totalmente gerenciado que pode ser usado para enviar e receber mensagens entre aplicativos independentes. O Google Play usa o Cloud Pub/Sub para publicar notificações push sobre tópicos que você assina.

Para receber notificações, crie um servidor de back-end para consumir as mensagens enviadas ao seu tópico. Seu servidor pode consumir essas mensagens respondendo a solicitações HTTPS a um endpoint registrado ou usando as bibliotecas de cliente do Cloud Pub/Sub. Essas bibliotecas estão disponíveis em várias linguagens. Veja mais informações na seção Criar uma assinatura do Pub/Sub neste tópico.

Configurar o Cloud Pub/Sub

Para ativar as notificações do desenvolvedor em tempo real, é preciso configurar o Cloud Pub/Sub usando seu próprio projeto do Google Cloud Platform (GCP) e, em seguida, ativar as notificações para seu app.

Para usar o Cloud Pub/Sub, é preciso ter um projeto do GCP com a API Cloud Pub/Sub ativada. Se você não conhece o GCP e o Cloud Pub/Sub, leia o Guia de início rápido.

Criar um tópico

Para começar a receber notificações, é preciso criar um tópico, no qual o Google Play publicará as notificações. Para criar um tópico, siga as instruções em Criar um tópico.

Criar uma assinatura do Pub/Sub

Para receber mensagens publicadas em um tópico, crie uma assinatura do Pub/Sub para esse tópico. Para criar uma assinatura do Pub/Sub, faça o seguinte:

  1. Leia o Guia do assinante do Cloud Pub/Sub para determinar se é preciso configurar a assinatura como de push ou de pull.
    • Uma assinatura de push permite que o Cloud Pub/Sub envie notificações para seu back-end seguro emitindo solicitações HTTPS.
    • Uma assinatura de pull requer que seu servidor de back-end seguro inicie solicitações ao servidor do Cloud Pub/Sub para recuperar mensagens.
  2. Siga as instruções em Adicionar uma assinatura para criá-la.

Conceder direitos de publicação no tópico

O Cloud Pub/Sub requer que você conceda privilégios ao Google Play para publicar notificações no seu tópico.

  1. Abra o Console do Google Cloud.
  2. Selecione seu projeto e clique em Pub/Sub na navegação à esquerda.
  3. Localize seu tópico e abra os detalhes das permissões.

    Como acessar a configuração do tópico Permissões
    Figura 1. Como acessar a configuração do tópico Permissões.
  4. Adicione a conta de serviço google-play-developer-notifications@system.gserviceaccount.com e conceda a ela a função de Editor do Pub/Sub.

    Adição de uma conta de serviço do Google Play como editora do Pub/Sub.
    Figura 2. Adição de uma conta de serviço do Google Play como editora do Pub/Sub.
  5. Clique em Salvar para concluir a configuração do tópico.

    Um tópico configurado
    Figura 3. Um tópico configurado.

Ativar notificações do desenvolvedor em tempo real para o app

Para ativar as notificações do desenvolvedor em tempo real no seu app, faça o seguinte:

  1. Abra o Google Play Console.
  2. Selecione seu app.
  3. Acesse Ferramentas de desenvolvimento > Serviços e API.
  4. Role até a seção Notificações do desenvolvedor em tempo real na parte inferior da página.

    Seção de notificações do desenvolvedor em tempo real
    Figura 4. Seção de notificações do desenvolvedor em tempo real.
  5. No campo Nome do tópico, insira o nome completo do tópico do Cloud Pub/Sub que você configurou anteriormente. O nome do tópico precisa estar no formato projects/{project_id}/topics/{topic_name}, em que project_id é o identificador exclusivo do seu projeto e topic_name é o nome do tópico criado anteriormente.

  6. Clique em Enviar mensagem de teste. Realizar uma publicação de teste ajuda a garantir que tudo esteja configurado corretamente. Se essa publicação for bem-sucedida, uma mensagem será exibida informando isso. Se você tiver um assinante para este tópico, ele receberá a mensagem de teste.

    Se a publicação falhar, um erro será exibido. Verifique se o nome do tópico está correto e se a conta de serviço google-play-developer-notifications@system.gserviceaccount.com tem acesso de Editor do Pub/Sub ao tópico.

  7. Clique em Atualizar tópico.

Como verificar a configuração

Para receber notificações de desenvolvedor em tempo real, crie um servidor de back-end seguro para consumir as mensagens enviadas ao seu tópico do Cloud Pub/Sub.

É possível testar sua configuração usando o botão Enviar mensagem de teste no Google Play Console, conforme descrito na seção anterior. Se você não configurou um servidor de back-end para consumir notificações, use a ferramenta de linha de comando gcloud para verificar a configuração. Para instruções sobre o processamento de mensagens usando gcloud, consulte Solicitar a mensagem da assinatura.

A seguir