KappS Base de conocimiento · Preguntas frecuentes

Declaración de permisos restringidos en Google Play

Preguntas frecuentes Permisos y API

1. Los permisos restringidos son el filtro adicional de Play para los permisos peligrosos, especiales, de firma y las familias documentadas en Permisos y API que acceden a información sensible. Los datos a los que se llega mediante esos permisos son personales y sensibles: solicita solo lo que necesite una función actual y publicada en la tienda, pide de forma incremental, respeta una denegación y nunca vendas los datos ni los uses para un fin no divulgado. El Formulario de declaración de permisos es la forma en que Play Console recopila esa justificación y aprobación antes de que un permiso de alto riesgo permanezca en un artefacto publicado. Política principal: Ayuda de Play Console, "Permisos y API que acceden a información sensible" (https://support.google.com/googleplay/android-developer/answer/16558241). Flujo del formulario: "Declara los permisos de tu app" (https://support.google.com/googleplay/android-developer/answer/9214102).

2. El formulario lo activa el binario, no una casilla que recuerdes marcar. Después de añadir un paquete de la app de Android, Play evalúa los permisos solicitados durante Preparar e implementar una versión (https://support.google.com/googleplay/android-developer/answer/9859348). Si el paquete solicita permisos de alto riesgo o sensibles —los ejemplos de la Ayuda son SMS o registro de llamadas— y no hay ninguna declaración registrada, el formulario de declaración de permisos aparece en ese flujo de publicación. Política → Contenido de la app → Permisos y API (o la declaración de permisos de alto riesgo o sensibles que Play muestra cuando el permiso ya está en el manifiesto combinado) es el lugar permanente para iniciar o gestionar el mismo formulario. Un paquete activo en producción, abierto, cerrado o interno que siga solicitando un permiso de alto riesgo no declarado genera una alerta de contenido de la app y puede bloquear la publicación, incluidas las ediciones de la ficha de la tienda, hasta que declares o elimines el permiso. Las implementaciones mediante la API de publicación dan error hasta que Play haya aprobado el uso; la Ayuda indica que completes el formulario en la interfaz web de Play Console y luego finalices la implementación allí. Siempre que la app solicite un nuevo permiso restringido, debes enviar un formulario revisado que aborde ese permiso.

3. Trátalo como un único proceso de formulario que cubre varias familias de permisos, no como sustituto de las entradas específicas de QUERY_ALL_PACKAGES o de las preguntas frecuentes sobre accesibilidad. Familias que suelen abrir el formulario: los grupos de SMS y registro de llamadas (READ_SMS, SEND_SMS, RECEIVE_SMS, READ_CALL_LOG y similares; se requiere ser el controlador predeterminado de SMS, Teléfono o Asistente — https://support.google.com/googleplay/android-developer/answer/10208820); AccessibilityService (completa la declaración de accesibilidad; solo las herramientas genuinas para discapacidad pueden establecer isAccessibilityTool=true); QUERY_ALL_PACKAGES (decláralo junto con cualquier otro permiso de alto riesgo; si basta, es preferible un manifiesto <queries> específico); Foto y vídeo READ_MEDIA_IMAGES / READ_MEDIA_VIDEO cuando la app tiene como objetivo API 33 o superior y el selector de fotos de Android no es suficiente para la funcionalidad principal (https://support.google.com/googleplay/android-developer/answer/14115180 y https://support.google.com/googleplay/android-developer/answer/15800983); acceso a todos los archivos (MANAGE_EXTERNAL_STORAGE); REQUEST_INSTALL_PACKAGES; y Health Connect / permisos de salud granulares. Audita el manifiesto combinado, incluidos los usos inyectados por SDK. Si una alternativa de alcance mínimo cubre la función —selector de fotos, SMS Retriever API, <queries> específicos, Storage Access Framework o MediaStore—, elimina el permiso restringido en lugar de declararlo.

4. Ruta en la consola y los siete pasos de la Ayuda: abre la app → Política → Contenido de la app → Permisos y API → Empezar (o Gestionar). O completa el mismo asistente cuando el flujo de publicación lo muestre tras la carga. Paso 1: evalúa los permisos que Play detectó en el artefacto; esta lista es la que los revisores te exigirán, no un borrador anterior. Paso 2: especifica la funcionalidad principal a partir de la lista de casos de uso admitidos; marca solo las casillas que correspondan. Paso 3: redacta instrucciones de revisión que lleven a un desconocido hasta la pantalla que necesita el permiso. Paso 4: aporta un vídeo breve que demuestre esa funcionalidad principal (y cualquier divulgación requerida dentro de la app). Paso 5: si la función está protegida por inicio de sesión, facilita credenciales de acceso a la app que funcionen e indicaciones de navegación. Paso 6 (solo con varios APK): solicita una excepción para los APK antiguos que ya no puedes modificar; la Ayuda documenta este campo para restos de SMS y registro de llamadas; indica los códigos de versión. Paso 7: confirma que la declaración es exacta y que aceptas los términos de uso adecuado. Después, termina de preparar la publicación. Los mismos pasos: https://support.google.com/googleplay/android-developer/answer/9214102.

5. Declara con exactitud. Play define la funcionalidad principal como el propósito central de la app: sin la función que requiere el permiso, el producto está "roto" o es inutilizable, y ese propósito junto con sus funciones principales debe documentarse de forma destacada en la ficha de la tienda. El formulario, la ficha y el código deben contar la misma historia. No elijas un caso de uso aprobado cercano solo porque sea más fácil pasar la revisión. No dejes texto de relleno sobre permisos en el manifiesto. Si cambias el uso de un permiso restringido, vuelve a enviar el formulario con la información actualizada. Los datos de permisos restringidos solo pueden usarse para las funciones principales declaradas, no para publicidad, marketing ni para mejorar apps no relacionadas. Cuando un usuario rechaza un permiso no crítico, respeta esa decisión y ofrece una alternativa razonable (por ejemplo, entrada manual en lugar de leer un registro).

6. Rechazos habituales y sus soluciones: (a) un SDK añadió silenciosamente SMS, registro de llamadas, QUERY_ALL_PACKAGES, READ_MEDIA_IMAGES o MANAGE_EXTERNAL_STORAGE: elimina o sustituye el SDK, o quita el permiso con tools:node="remove" y luego sube un nuevo paquete; (b) el formulario falta, está desactualizado o describe un uso distinto del que hace el código: actualiza Política → Contenido de la app y vuelve a enviar; (c) la ficha de la tienda describe una utilidad de propósito único mientras el binario solicita un permiso de controlador predeterminado o de acceso amplio: o la ficha o el permiso están mal; (d) se declara Foto/Video o visibilidad de paquetes cuando basta con el selector de fotos o <queries>: elimina el permiso; (e) faltan el video o las instrucciones de revisión, están desactualizados o no corresponden a la función; (f) una función principal está tras un inicio de sesión y el acceso a la app está vacío; (g) un APK antiguo sigue en un canal de pruebas con el permiso; (h) se intentó una implementación con la API de publicación antes de que se aprobara el formulario en la interfaz web; (i) cambió el uso y no se volvió a presentar el formulario. Las apps que no superan la prueba de políticas o que carecen del formulario de declaración de permisos pueden ser retiradas de Google Play. El uso engañoso o no declarado puede suspender la app o cerrar la cuenta de desarrollador.

7. Planifica la revisión adicional. Ayuda evalúa la declaración como parte de la revisión de la versión; un permiso de alto riesgo puede mantener el nuevo artefacto en publicación pendiente hasta que se apruebe el caso de uso. No intentes saltarte el formulario subiendo otra versión sobre una pendiente: Ayuda advierte que sobrescribir una publicación pendiente puede añadir retrasos. Si necesitas un arreglo urgente no relacionado con políticas, publica un paquete que ya no solicite el permiso no declarado. Mantén cada canal activo sin sorpresas: Play lee el manifiesto combinado en pruebas internas, cerradas, abiertas y producción, no solo en la compilación que querías que vieran los revisores.

8. Lista de verificación previa al envío: (a) vuelca el manifiesto fusionado en cada canal y enumera todos los permisos restringidos, incluidos los que haya añadido un SDK; (b) elimina cualquier permiso que pueda sustituirse por una alternativa de alcance mínimo; (c) completa Política → Contenido de la app → Permisos y API con casos de uso que coincidan con la ficha y el código; (d) adjunta un vídeo actual y notas para la revisión o instrucciones de acceso a la app que realmente lleguen a la función; (e) vuelve a enviar el formulario tras cualquier cambio de caso de uso; (f) no publiques un nuevo permiso de alto riesgo a través de la Publishing API hasta que se apruebe el formulario de la interfaz web; (g) vuelve a leer 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, y https://support.google.com/googleplay/android-developer/answer/14115180 después de cualquier cambio de manifiesto, SDK o rol de controlador.