API de Play Integrity: Guía de vinculación y cuota de proyectos de Cloud

La API de Play Integrity aplica un límite de 10,000 solicitudes por día al tráfico de los proyectos de Google Cloud que no están vinculados a una app en Google Play Console ni a un SDK en Play SDK Console. Este límite ya está activo para la mayoría de los proyectos de Google Cloud. A una pequeña cantidad de proyectos con cuotas aumentadas preexistentes se les otorgó una extensión del plazo hasta el 16 de febrero de 2027 para completar la vinculación antes de que se aplique el límite.

En esta guía, se explica cómo la vinculación de proyectos afecta tu cuota, cómo vincular tus proyectos de Google Cloud a tu app o SDK, y se responden preguntas frecuentes.

Resumen rápido

Detalles clave Descripción
Fecha de aplicación de medidas por incumplimiento Ya está activo para la mayoría de los proyectos.
16 de febrero de 2027 para los proyectos que recibieron una notificación de fecha límite
Política Las solicitudes a la API de Play Integrity que se originan en proyectos de Cloud no vinculados a tu app o SDK tienen un límite de 10,000 solicitudes por día, independientemente de cualquier cuota personalizada más alta configurada en el proyecto.
¿A quiénes afecta? Apps y SDKs que realizan más de 10,000 solicitudes por día con un proyecto de Google Cloud que no está vinculado a esa app (en Play Console) ni a ese SDK (en Play SDK Console)
Acción obligatoria Vincula tus proyectos de Google Cloud a tu app en Google Play Console o a tu SDK en Google Play SDK Console.
Error de cuota excedida Las solicitudes no vinculadas que superen las 10,000 por día fallarán con el error TOO_MANY_REQUESTS (código de error -8).

Preguntas frecuentes

La API de Play Integrity proporciona a cada proyecto de Google Cloud una cuota predeterminada de 10,000 solicitudes por día. Los desarrolladores que requieran un volumen más alto pueden solicitar un aumento de la cuota.

Para proteger tu app o SDK y evitar que terceros no autorizados agoten tu cuota, el aumento de la cuota diaria se restringe exclusivamente a los proyectos de Google Cloud vinculados a tu app en Google Play Console o a tu SDK en Google Play SDK Console.

Para apps (Google Play Console):

  1. Accede a Google Play Console y selecciona tu app.
  2. En el menú de navegación de la izquierda, ve a Protegido con Play.
  3. Junto a la API de Play Integrity, selecciona Comenzar (o Administrar).
  4. Haz clic en Vincular proyecto de Cloud (o Agregar proyecto si ya tienes proyectos vinculados).
  5. Selecciona o ingresa el número del proyecto de Google Cloud que deseas vincular y confirma.

Para SDKs (Google Play SDK Console):

  1. Accede a Google Play SDK Console y selecciona tu SDK.
  2. En el menú de navegación de la izquierda, ve a Integridad del SDK.
  3. Junto a la API de Play Integrity, haz clic en Configuración.
  4. Haz clic en Vincular proyecto de Cloud (o Agregar otro si ya tienes proyectos vinculados).
  5. Selecciona o ingresa el número del proyecto de Google Cloud que deseas vincular y confirma.

Permisos necesarios:

  • Play Console (para apps): Debes tener el permiso "Lanzar a producción, excluir dispositivos y usar la firma de apps de Play" para la app.
  • Play SDK Console (para SDKs): Debes tener el permiso "Administrar" para el SDK.
  • Google Cloud (ambos): Debes tener los permisos 'serviceusage.services.enable' y 'resourcemanager.projects.get' en el proyecto de Google Cloud de destino.

Para apps (Google Play Console):

  1. Abre Google Play Console > Protegido con Play > API de Play Integrity > Administrar.
  2. Consulta la sección Configuración del proyecto.
  3. Asegúrate de que el número de proyecto que aparece coincida con el que se usa para llamar a la API de Play Integrity.

Para SDKs (Google Play SDK Console):

  1. Abre Google Play SDK Console > Integridad del SDK > Configuración.
  2. Consulta la sección Configuración del proyecto.
  3. Asegúrate de que el número de proyecto que aparece coincida con el que se usa para llamar a la API de Play Integrity.

P4: ¿Cómo vinculo mi proyecto de Cloud si mi app o SDK no están en Google Play?

La vinculación de un proyecto de Google Cloud solo está disponible para las apps administradas en Google Play Console y los SDKs registrados en Google Play SDK Console.

Si tu app se distribuye exclusivamente fuera de Google Play o tu SDK no está en Play SDK Console, no podrás vincular un proyecto de Google Cloud, y el tráfico de la API de Play Integrity se limitará a las 10,000 solicitudes diarias predeterminadas. Para cumplir con los requisitos para obtener una cuota más alta, publica tu app en Google Play o registra tu SDK apto en Play SDK Console y vincula tu proyecto de Cloud.

P5: ¿Puedo vincular varios proyectos de Google Cloud o compartir un proyecto entre apps o SDK?

  • Varios proyectos por app o SDK: Puedes vincular hasta cinco proyectos de Google Cloud a una sola app o SDK.
  • Un proyecto en varias apps: Puedes vincular el mismo proyecto de Google Cloud a varias apps en Google Play Console. No se admite vincular el mismo proyecto de Google Cloud a varios SDKs o a un SDK y una app.

P6: ¿Qué sucede si administro la app o el SDK, pero otra persona de mi organización es propietaria del proyecto de Google Cloud?

Para completar la vinculación, el usuario que realiza la acción en Play Console (o Play SDK Console) también debe tener los permisos necesarios en el proyecto de Google Cloud. Puedes coordinar esto de dos maneras:

  • Opción A: Pídele a alguien que pueda administrar el acceso de IAM en el proyecto de Google Cloud que otorgue temporalmente a tu Cuenta de Google los permisos 'serviceusage.services.enable' y 'resourcemanager.projects.get'. Una vez vinculados, estos permisos ya no son necesarios para las operaciones diarias.
  • Opción B: Otorga a un miembro del equipo que ya tenga 'serviceusage.services.enable' y 'resourcemanager.projects.get' en el proyecto de Google Cloud el permiso de la consola requerido para que pueda realizar el paso de vinculación:
    • En el caso de las apps (Play Console): Otorga el permiso "Lanzar a producción, excluir dispositivos y usar la firma de apps de Play" para la app.
    • Para SDKs (Play SDK Console): Otorga el permiso "Administrar" para el SDK.

P7: ¿Qué sucede si no vinculo mi proyecto de Cloud antes del 16 de febrero de 2027?

Si una app o un SDK envía solicitudes a la API de Play Integrity con un proyecto de Google Cloud no vinculado después del 16 de febrero de 2027, ocurrirá lo siguiente:

  1. Hasta 10,000 solicitudes por día: Las solicitudes siguen teniendo éxito con normalidad en la cuota de referencia predeterminada.
  2. Más de 10,000 solicitudes por día: Una vez que el proyecto desvinculado alcanza las 10,000 solicitudes por día, las solicitudes se rechazan con el error TOO_MANY_REQUESTS (código de error -8).

Corrección instantánea de autoservicio:

Si tu app o SDK recibe errores TOO_MANY_REQUESTS después de la fecha límite porque no se vinculó un proyecto de Cloud, vincular el proyecto de Google Cloud faltante en Play Console o Play SDK Console resolverá el problema.

P8: No uso la API de Play Integrity. ¿Por qué recibí un mensaje en el que se me solicita que vincule mi proyecto de Cloud?

Recibiste este aviso porque tu proyecto de Google Cloud genera más de 10,000 solicitudes a la API de Play Integrity no vinculadas por día. Estos son algunos de los motivos comunes:

  1. Una biblioteca o un SDK configurados con tu número de proyecto de Cloud: Algunas bibliotecas llaman a la API de Play Integrity con tu proyecto de Google Cloud. Si tu app o SDK usa una biblioteca de este tipo, vincula ese proyecto a tu app en Play Console o a tu SDK en Play SDK Console.
  2. Otra app o equipo de tu organización: Es posible que otro equipo esté usando este proyecto de Google Cloud en su app o SDK. Consulta con tus equipos de ingeniería para identificar la app o el SDK y, luego, vincula el proyecto en Play Console o Play SDK Console.
  3. Tráfico no autorizado o una integración retirada: Si las apps no autorizadas o clonadas envían solicitudes con tu número de proyecto, o si ya no usas la API, no es necesario que realices ninguna acción. Si dejas que se aplique el límite de 10,000 solicitudes por día sin vincular, se limitará el tráfico no deseado.

Contacto y asistencia

Si tienes preguntas sobre cómo vincular tu proyecto de Cloud o administrar tu cuota de la API de Play Integrity, haz lo siguiente: