KappS Base de conhecimento · Perguntas frequentes

Declaração de permissões restritas no Google Play

Perguntas frequentes Permissões e API

1. As permissões restritas são a barreira extra do Play para permissões Perigosas, Especiais, de Assinatura e as famílias documentadas em Permissões e APIs que acessam informações sensíveis. Os dados acessados por meio dessas permissões são pessoais e sensíveis: solicite apenas o que um recurso atual e listado na loja precisa, peça de forma incremental, respeite uma recusa e nunca venda os dados nem os use para uma finalidade não divulgada. O Formulário de Declaração de Permissões é como o Play Console coleta essa justificativa e aprovação antes que uma permissão de alto risco permaneça em um artefato publicado. Política principal: Ajuda do Play Console, "Permissions and APIs that Access Sensitive Information" (https://support.google.com/googleplay/android-developer/answer/16558241). Fluxo do formulário: "Declare permissions for your app" (https://support.google.com/googleplay/android-developer/answer/9214102).

2. O formulário é acionado pelo binário, não por uma caixa de seleção que você lembra de marcar. Depois que você adiciona um App Bundle do Android, o Play avalia as permissões solicitadas durante o Preparar e lançar uma versão (https://support.google.com/googleplay/android-developer/answer/9859348). Se o bundle pede permissões de alto risco ou sensíveis — os exemplos da Ajuda são SMS ou Registro de chamadas — e não há declaração registrada, o Formulário de declaração de permissões aparece nesse fluxo de lançamento. Política → Conteúdo do app → Permissões e APIs (ou a declaração de permissões de alto risco/sensíveis que o Play exibe quando a permissão já está no manifesto mesclado) é o local permanente para Iniciar ou Gerenciar o mesmo formulário. Um bundle ativo em produção, teste aberto, teste fechado ou teste interno que ainda solicita uma permissão de alto risco não declarada gera um alerta de Conteúdo do app e pode bloquear a publicação, incluindo edições da ficha do app na loja, até que você declare ou remova a permissão. Lançamentos pela API de publicação dão erro até o Play aprovar o uso; a Ajuda diz para concluir o formulário na interface web do Play Console e depois concluir o lançamento por lá. Sempre que o app solicitar uma nova permissão restrita, você deve enviar um formulário revisado que contemple essa permissão.

3. Trate isto como um único processo de formulário que cobre várias famílias de permissões — não como substituto das entradas dedicadas QUERY_ALL_PACKAGES ou do FAQ de Acessibilidade. Famílias que costumam abrir o formulário: grupos SMS e Registro de chamadas (READ_SMS, SEND_SMS, RECEIVE_SMS, READ_CALL_LOG e relacionados; é necessário ser o manipulador padrão de SMS, Telefone ou Assistente — https://support.google.com/googleplay/android-developer/answer/10208820); AccessibilityService (preencha a declaração de acessibilidade; apenas ferramentas genuínas de deficiência podem definir isAccessibilityTool=true); QUERY_ALL_PACKAGES (declare junto com quaisquer outras permissões de alto risco; prefira um <queries> direcionado no manifesto se isso for suficiente); Foto e vídeo READ_MEDIA_IMAGES / READ_MEDIA_VIDEO quando o app tem como destino a API 33+ e o Seletor de fotos do Android não é suficiente para a funcionalidade principal (https://support.google.com/googleplay/android-developer/answer/14115180 e https://support.google.com/googleplay/android-developer/answer/15800983); Acesso a todos os arquivos (MANAGE_EXTERNAL_STORAGE); REQUEST_INSTALL_PACKAGES; e Health Connect / permissões de saúde granulares. Audite o manifesto mesclado, incluindo usos injetados por SDK. Se uma alternativa de escopo mínimo cobre o recurso — Seletor de fotos, API SMS Retriever, <queries> direcionado, Storage Access Framework ou MediaStore — remova a permissão restrita em vez de declará-la.

4. O caminho no Console e os sete passos da Ajuda: abra o app → Política → Conteúdo do app → Permissões e APIs → Começar (ou Gerenciar). Ou conclua o mesmo assistente quando o fluxo de lançamento o exibe após o upload. Passo 1: avalie as permissões que o Play detectou no artefato — é essa lista que os revisores vão cobrar, não um rascunho antigo. Passo 2: especifique a funcionalidade principal a partir da lista de casos de uso aceitos; marque apenas as caixas que se aplicam. Passo 3: escreva instruções de revisão que levem um estranho até a tela que precisa da permissão. Passo 4: forneça um vídeo curto que demonstre essa funcionalidade principal (e qualquer divulgação no app exigida). Passo 5: se o recurso exige login, forneça credenciais de acesso ao app que funcionem e a navegação. Passo 6 (somente multi-APK): solicite uma exceção para APKs antigos que você não consegue mais alterar — a Ajuda documenta esse campo para resquícios de SMS/Registro de Chamadas; liste os códigos de versão. Passo 7: confirme que a declaração é precisa e que você concorda com os termos de uso apropriado. Depois, conclua a preparação do lançamento. Mesmos passos: https://support.google.com/googleplay/android-developer/answer/9214102.

5. Declare com precisão. O Play define funcionalidade principal como o propósito central do app: sem o recurso que precisa da permissão, o produto fica "quebrado" ou inutilizável, e esse propósito, junto com seus recursos principais, deve estar documentado em destaque na ficha do app na loja. O formulário, a ficha e o código precisam contar a mesma história. Não escolha um caso de uso aprovado próximo só porque é mais fácil passar pela revisão. Não deixe texto de permissão provisório no manifesto. Se você mudar a forma como uma permissão restrita é usada, envie o formulário novamente com as informações atualizadas. Os dados de permissões restritas só podem ser usados para as funcionalidades principais declaradas — não para publicidade, marketing ou melhoria de apps não relacionados. Quando o usuário recusar uma permissão não crítica, respeite essa escolha e ofereça uma alternativa razoável (entrada manual em vez de leitura de log, por exemplo).

6. Rejeições comuns e as correções habituais: (a) um SDK adicionou silenciosamente SMS, Registro de Chamadas, QUERY_ALL_PACKAGES, READ_MEDIA_IMAGES ou MANAGE_EXTERNAL_STORAGE — remova ou substitua o SDK, ou retire a permissão com tools:node="remove" e envie um novo bundle; (b) o formulário está ausente, desatualizado ou descreve um uso diferente do código — atualize Política → Conteúdo do app e reenvie; (c) a ficha do app na loja descreve um utilitário de finalidade única enquanto o binário solicita uma permissão de manipulador padrão ou de acesso amplo — ou a ficha ou a permissão está errada; (d) Foto/Vídeo ou visibilidade de pacotes declarada quando o Seletor de Fotos ou <queries> já bastam — remova a permissão; (e) vídeo ou instruções de revisão ausentes, desatualizados ou fora do recurso; (f) um recurso principal protegido por login com Acesso ao app vazio; (g) um APK antigo ainda em uma faixa de teste que carrega a permissão; (h) uma implantação pela API de Publicação tentada antes da aprovação do formulário na interface web; (i) o uso mudou e o formulário não foi preenchido novamente. Apps que não passam no teste de política ou não têm um Formulário de Declaração de Permissões podem ser removidos do Google Play. O uso enganoso ou não declarado pode suspender o app ou encerrar a conta de desenvolvedor.

7. Planeje a revisão extra. O Help avalia a declaração como parte da revisão de lançamento; uma permissão de alto risco pode manter o novo artefato em publicação pendente até que o caso de uso seja aprovado. Não tente burlar o formulário enviando outro lançamento por cima de um pendente — o Help avisa que substituir uma publicação pendente pode gerar atraso. Se você precisa de uma correção urgente sem relação com políticas, envie um bundle que não solicite mais a permissão não declarada. Mantenha todas as faixas ativas em conformidade: o Play lê o manifesto mesclado no teste interno, teste fechado, teste aberto e produção, não apenas na build que você queria mostrar aos revisores.

8. Checklist de pré-submissão: (a) extraia o manifesto mesclado em cada faixa e liste todas as permissões restritas, inclusive as adicionadas por um SDK; (b) remova qualquer permissão que uma alternativa de escopo mínimo possa substituir; (c) preencha Política → Conteúdo do app → Permissões e APIs com casos de uso que correspondam à ficha e ao código; (d) anexe um vídeo atualizado e instruções de revisão / Acesso ao app que realmente cheguem ao recurso; (e) reenvie o formulário após qualquer mudança de caso de uso; (f) não lance uma nova permissão de alto risco pela Publishing API antes de o formulário na interface web ser aprovado; (g) releia https://support.google.com/googleplay/android-developer/answer/16558241, https://support.google.com/googleplay/android-developer/answer/9214102, https://support.google.com/googleplay/android-developer/answer/10208820, e https://support.google.com/googleplay/android-developer/answer/14115180 após qualquer mudança de manifesto, SDK ou papel de handler.