API Play Integrity: guia de vinculação e cota de projetos na nuvem

A API Google Play Integrity impõe um limite de 10.000 solicitações por dia no tráfego de projetos do Google Cloud que não estão vinculados a um app no Google Play Console ou a um SDK no Play SDK Console. Esse limite já está ativo na maioria dos projetos do Google Cloud. Um pequeno número de projetos com cota aumentada preexistente recebeu um prazo estendido até 16 de fevereiro de 2027 para concluir a vinculação antes que o limite seja aplicado.

Neste guia, explicamos como a vinculação de projetos afeta sua cota, como vincular seus projetos do Google Cloud ao app ou SDK e respondemos a perguntas frequentes.

Resumo rápido

Detalhe importante Descrição
Data de aplicação Já está ativo na maioria dos projetos.
16 de fevereiro de 2027 para projetos que receberam uma notificação de prazo.
Política As solicitações de API Play Integrity originadas de projetos na nuvem não vinculados ao app ou SDK são limitadas a 10.000 solicitações por dia, independentemente de qualquer cota personalizada mais alta configurada no projeto.
Quem é afetado Apps e SDKs que fazem mais de 10.000 solicitações por dia usando um projeto do Google Cloud que não está vinculado a esse app (no Play Console) ou SDK (no Play SDK Console).
Ação necessária Vincule seus projetos na nuvem do Google Cloud ao app no Google Play Console ou ao SDK no Google Play SDK Console.
Erro de cota excedida As solicitações não vinculadas que excedem 10.000 por dia falham com o erro TOO_MANY_REQUESTS (código do erro -8).

Perguntas frequentes

A API Play Integrity oferece a cada projeto na nuvem do Google Cloud uma cota padrão de 10.000 solicitações por dia. Os desenvolvedores que precisam de um volume maior podem solicitar um aumento de cota.

Para proteger seu app ou SDK e impedir que terceiros não autorizados esgotem sua cota, o aumento da cota diária é restrito exclusivamente aos projetos do Google Cloud vinculados ao seu app no Google Play Console ou ao seu SDK no SDK Console do Google Play.

Para apps (Google Play Console):

  1. Faça login no Google Play Console e selecione seu app.
  2. No menu de navegação à esquerda, acesse Protegido com o Google Play.
  3. Ao lado de API Play Integrity, selecione Começar (ou Gerenciar).
  4. Clique em Vincular projeto na nuvem (ou Adicionar projeto se você já tiver projetos vinculados).
  5. Selecione ou insira o número do projeto do Google Cloud que você quer vincular e confirme.

Para SDKs (Google Play SDK Console):

  1. Faça login no Google Play SDK Console e selecione seu SDK.
  2. No menu de navegação à esquerda, acesse Integridade do SDK.
  3. Ao lado de API Play Integrity, clique em Configurações.
  4. Clique em Vincular projeto na nuvem (ou em Adicionar outro se você já tiver projetos vinculados).
  5. Selecione ou insira o número do projeto do Google Cloud que você quer vincular e confirme.

Permissões necessárias:

  • Play Console (para apps): é preciso ter a permissão Enviar para produção, excluir dispositivos e usar a Assinatura de apps do Google Play para o app.
  • Play SDK Console (para SDKs): é preciso ter a permissão Gerenciar para o SDK.
  • Google Cloud (ambos): é preciso ter as permissões serviceusage.services.enable e resourcemanager.projects.get no projeto de destino do Google Cloud.

Para apps (Google Play Console):

  1. Abra o Google Play Console > Protegido com o Google Play > API Play Integrity > Gerenciar.
  2. Verifique a seção "Configuração do projeto".
  3. Verifique se o número do projeto listado corresponde ao usado para chamar a API Play Integrity.

Para SDKs (Google Play SDK Console):

  1. Abra o Google Play SDK Console > Integridade do SDK > Configurações.
  2. Verifique a seção "Configuração do projeto".
  3. Verifique se o número do projeto listado corresponde ao usado para chamar a API Play Integrity.

P4: Como faço para vincular meu projeto na nuvem se meu app ou SDK não está no Google Play?

A vinculação de um projeto na nuvem do Google Cloud está disponível apenas para apps gerenciados no Google Play Console e SDKs registrados no Google Play SDK Console.

Se o app for distribuído exclusivamente fora do Google Play ou o SDK não estiver no Play SDK Console, não será possível vincular um projeto do Google Cloud, e o tráfego da API Play Integrity será limitado ao padrão de 10.000 solicitações por dia. Para se qualificar para uma cota maior, publique seu app no Google Play ou registre seu SDK qualificado no Play SDK Console e vincule seu projeto na nuvem.

P5: Posso vincular vários projetos do Google Cloud ou compartilhar um projeto entre apps ou SDKs?

  • Vários projetos por app ou SDK:é possível vincular até cinco projetos do Google Cloud a um único app ou SDK.
  • Um projeto em vários apps:é possível vincular o mesmo projeto do Google Cloud a vários apps no Google Play Console. Não é possível vincular o mesmo projeto do Google Cloud a vários SDKs ou a um SDK e um app.

P6: E se eu gerenciar o app ou SDK, mas outra pessoa na minha organização for proprietária do projeto do Google Cloud?

Para concluir a vinculação, o usuário que realiza a ação no Play Console (ou no Play SDK Console) também precisa ter as permissões necessárias no projeto do Google Cloud. Você pode coordenar isso de duas maneiras:

  • Opção A:peça a alguém que possa gerenciar o acesso do IAM no projeto do Google Cloud para conceder temporariamente à sua Conta do Google as permissões serviceusage.services.enable e resourcemanager.projects.get. Depois de vinculadas, essas permissões não são mais necessárias para as operações diárias.
  • Opção B:conceda a um membro da equipe que já tenha serviceusage.services.enable e resourcemanager.projects.get no projeto do Google Cloud a permissão necessária do console para que ele possa realizar a etapa de vinculação:
    • Para apps (Play Console): conceda a permissão Enviar para produção, excluir dispositivos e usar a Assinatura de apps do Google Play para o app.
    • Para SDKs (Play SDK Console): conceda a permissão Gerenciar para o SDK.

P7: O que vai acontecer se eu não vincular meu projeto na nuvem antes de 16 de fevereiro de 2027?

Se um app ou SDK enviar solicitações da API Play Integrity usando um projeto do Google Cloud não vinculado após 16 de fevereiro de 2027:

  1. Até 10.000 solicitações por dia:as solicitações continuam sendo processadas normalmente com a cota básica padrão.
  2. Acima de 10.000 solicitações por dia:quando o projeto não vinculado atingir 10.000 solicitações por dia, as solicitações serão rejeitadas com o erro TOO_MANY_REQUESTS (código do erro -8).

Correção instantânea de autoatendimento:

Se o app ou SDK receber erros TOO_MANY_REQUESTS após o prazo porque um projeto na nuvem não foi vinculado, vincular o projeto do Google Cloud ausente no Play Console ou no Play SDK Console vai resolver o problema.

P8: Não estou usando a API Play Integrity. Por que recebi uma mensagem pedindo para vincular meu projeto na nuvem?

Você recebeu este aviso porque seu projeto na nuvem do Google Cloud está gerando mais de 10.000 solicitações de API Play Integrity não vinculadas por dia. Alguns motivos comuns:

  1. Uma biblioteca ou um SDK configurado com o número do seu projeto na nuvem: algumas bibliotecas chamam a API Play Integrity usando seu projeto do Google Cloud. Se o app ou SDK usa uma biblioteca desse tipo, vincule esse projeto ao app no Play Console ou ao SDK no Play SDK Console.
  2. Outro app ou equipe na sua organização:outra equipe pode estar usando esse projeto na nuvem do Google Cloud no app ou SDK dela. Verifique com suas equipes de engenharia para identificar o app ou SDK e vincule o projeto no Play Console ou no Play SDK Console.
  3. Tráfego não autorizado ou uma integração desativada:se apps não autorizados ou clonados estiverem enviando solicitações com o número do seu projeto ou se você não usar mais a API, nenhuma ação será necessária. Deixar o limite de 10.000 solicitações por dia sem vinculação entrar em vigor vai limitar o tráfego indesejado.

Contato e suporte

Se você tiver dúvidas sobre como vincular seu projeto na nuvem ou gerenciar sua cota da API Play Integrity: