As ferramentas e os recursos abaixo ajudarão você a aproveitar ao máximo a API Play Integrity como parte da sua estratégia antiabuso.
Monitorar o status da API Play Integrity
O painel de status do Google Play mostra o status da API Play Integrity. Publicaremos informações sobre o status do serviço, incluindo interrupções e falhas temporárias. Se você tiver um problema que não está listado na página, entre em contato com o suporte ao desenvolvedor do Google Play.
Testar diferentes respostas da API Play Integrity no app
É possível criar testes para avaliar como a API Play Integrity interage com o app. Para endereços de e-mail especificados, você pode selecionar os vereditos de integridade ou o código de erro que eles vão receber dos servidores do Google Play no app. Isso permite testar como o app reage a todas as respostas e erros possíveis.
Você pode configurar um teste no Play Console. No menu à esquerda, acesse Protegido com o Google Play. Ao lado de API Play Integrity, clique em Gerenciar e encontre a opção Teste para começar. Para instruções detalhadas, consulte a Central de Ajuda do Play Console.
Para respostas de teste, um campo extra testingDetails aparece no
payload retornado.
"testingDetails": { "isTestingResponse": true }
Analisar as respostas da API Play Integrity que o app está recebendo
Você pode acessar os relatórios da API Play Integrity no Play Console para entender as respostas que o app está recebendo e identificar possíveis problemas. Para conferir o relatório, acesse Protegido com o Google Play e clique no ícone de seta à direita na seção Monitorar a API Play Integrity.
O relatório mostra:
- O volume de solicitações padrão e clássicas que o app está fazendo.
- Um detalhamento de cada resposta de veredito para detalhes do dispositivo, do app e da conta. Os vereditos opcionais ainda não aparecem no relatório.
- Os códigos de erro mais comuns que o app está encontrando.
- Os certificados mais comuns de versões de apps não reconhecidas.
Você pode filtrar o relatório por versão do app, país e versão do SO Android para ter uma visão mais detalhada dos vereditos de integridade. Os dados não são mostrados quando o volume de solicitações é baixo para proteger a privacidade do usuário.
Verificar o veredito de integridade do dispositivo de qualquer dispositivo
Se você precisar verificar qual veredito de integridade a API Play Integrity retorna para o app em um dispositivo específico, como ao depurar ou resolver um problema relatado pelo usuário, você pode usar o app da Play Store para gerar um veredito da API Play Integrity para o dispositivo.
Primeiro, ative as opções do desenvolvedor da Play Store no dispositivo. Toque no ícone do seu perfil e em Configurações. Abra o menu Sobre e toque na linha Versão da Play Store sete vezes para ativar o modo de desenvolvedor.
Para gerar um veredito em um dispositivo Android, abra o app da Play Store. Toque no ícone do perfil e em Configurações. Abra o menu Geral e toque em Opções do desenvolvedor. Nas configurações da Play Integrity, toque em Verificar integridade para gerar um veredito.
Verificar a integridade em um dispositivo remoto
Você também pode iniciar uma verificação de integridade em um dispositivo Wear OS, Android Automotive OS ou dispositivo Android TV conectado diretamente pelo smartphone principal. Isso permite extrair vereditos de integridade do dispositivo nesses formatos.
Para fazer uma verificação de integridade remota:
- Confira se o smartphone principal e o dispositivo de destino, como um relógio, carro ou TV, estão conectados à mesma Conta do Google.
- No smartphone principal, abra o app Google Play Store e acesse Configurações > Geral > Opções do desenvolvedor.
- Na seção Play Integrity, toque na seta de expansão no botão dividido Verificar integridade para conferir os dispositivos conectados.
- Selecione o dispositivo de destino na lista suspensa.
O smartphone aciona a verificação no dispositivo remoto e mostra o veredito resultante quando a operação é concluída.
Ajudar os usuários a corrigir problemas de integridade
A API Play Integrity oferece várias caixas de diálogo de correção do Google Play que podem ser acionadas no app para ajudar os usuários a resolver problemas específicos de veredito.
Para orientar os usuários a resolver problemas de integridade do dispositivo, você pode direcioná-los ao recurso de solução de problemas no app Google Play Store. Para corrigir os problemas de integridade do dispositivo, instrua o usuário a seguir estas etapas:
- Abra o app Google Play Store.
- No canto superior direito, toque no ícone do perfil.
- Toque em Configurações > Sobre > Certificação do Play Protect.
- Toque em Corrigir problema. Esse botão só fica visível para usuários cujos dispositivos não passam nas verificações de integridade do dispositivo do Google Play. O usuário vai receber uma série de comandos que vão ajudar a resolver o problema do dispositivo e, se possível, corrigi-lo.
Considere soluções completas contra fraude empresarial
Clientes empresariais que procuram uma solução completa de gerenciamento de fraudes e bots podem adquirir o reCAPTCHA Enterprise para dispositivos móveis, que conta com SDKs para Android com pontuações de risco de fraude. O reCAPTCHA Enterprise inclui automaticamente os indicadores da API Play Integrity e os combina com a rede reCAPTCHA e indicadores de aplicativos para clientes, fornecendo uma solução de gerenciamento de fraudes simples e descomplicada. Ele também pode fornecer proteção para apps Android em que a API Play Integrity não está disponível.
Receber suporte
Para informar um veredito inesperado da API Play Integrity, envie um problema com todas as informações pedidas.
Para fazer perguntas ou enviar feedback sobre a API Play Integrity, você pode:
- Entrar em contato com o suporte ao desenvolvedor do Google Play diretamente pelo Play Console.
- Preencher este formulário na Central de Ajuda do Play Console.
Se você estiver pedindo para aumentar o número de solicitações diárias que seu app faz, o processo pode levar até uma semana. Recomendamos monitorar o uso da API Play Integrity no Google Play Console ou no console do Google Cloud, em que também é possível configurar alertas de cotas para evitar interrupções no serviço.