API Play Integrity : guide sur l'association de projets Cloud et les quotas

L'API Google Play Integrity applique une limite de 10 000 requêtes par jour au trafic provenant de projets Google Cloud qui ne sont pas associés à une application dans la Google Play Console ou à un SDK dans la Play SDK Console. Cette limite est déjà active pour la plupart des projets Google Cloud. Un petit nombre de projets dont le quota avait déjà été augmenté ont bénéficié d'un délai supplémentaire jusqu'au 16 février 2027 pour effectuer l'association avant que la limite ne soit appliquée.

Ce guide explique l'impact de l'association de projets sur votre quota, comment associer vos projets Google Cloud à votre application ou SDK, et répond aux questions fréquentes.

Récapitulatif sur le lancement

Détail de la clé Description
Date d'application Déjà actif pour la plupart des projets.
16 février 2027 pour les projets ayant reçu une notification de date limite.
Règlement Les requêtes de l'API Play Integrity provenant de projets Cloud non associés à votre application ou à votre SDK sont limitées à 10 000 requêtes par jour, quel que soit le quota personnalisé plus élevé configuré sur le projet.
Qui est concerné ? Applications et SDK effectuant plus de 10 000 requêtes par jour à l'aide d'un projet Google Cloud qui n'est pas associé à cette application (dans la Play Console) ou à ce SDK (dans la Play SDK Console).
Action requise Associez vos projets Google Cloud à votre application dans la Google Play Console ou à votre SDK dans la Google Play SDK Console.
Erreur en cas de dépassement de quota Les requêtes non associées au-delà de 10 000 par jour échouent avec l'erreur TOO_MANY_REQUESTS (code d'erreur -8).

Questions fréquentes

L'API Play Integrity fournit à chaque projet Google Cloud un quota par défaut de 10 000 requêtes par jour. Les développeurs qui ont besoin d'un volume plus élevé peuvent demander une augmentation de quota.

Pour protéger votre application ou votre SDK et empêcher des tiers non autorisés d'épuiser votre quota, l'augmentation du quota quotidien est réservée exclusivement aux projets Google Cloud associés à votre application dans la Google Play Console ou à votre SDK dans la Google Play SDK Console.

Pour les applications (Google Play Console) :

  1. Connectez-vous à la Google Play Console et sélectionnez votre application.
  2. Dans le menu de navigation de gauche, accédez à Protégé avec Play.
  3. À côté de l'API Play Integrity, sélectionnez Premiers pas (ou Gérer).
  4. Cliquez sur Associer un projet Cloud (ou sur Ajouter un projet si vous avez déjà associé des projets).
  5. Sélectionnez ou saisissez le numéro du projet Google Cloud que vous souhaitez associer, puis confirmez.

Pour les SDK (Google Play SDK Console) :

  1. Connectez-vous à la Google Play SDK Console et sélectionnez votre SDK.
  2. Dans le menu de navigation de gauche, accédez à Intégrité du SDK.
  3. À côté de l'option API Play Integrity, cliquez sur Paramètres.
  4. Cliquez sur Associer un projet Cloud (ou sur Ajouter si vous avez déjà associé des projets).
  5. Sélectionnez ou saisissez le numéro du projet Google Cloud que vous souhaitez associer, puis confirmez.

Autorisations requises :

  • Play Console (pour les applications) : vous devez disposer de l'autorisation Mettre les applications à disposition de tous les utilisateurs, exclure des appareils et utiliser la signature d'application Play pour l'application.
  • Play SDK Console (pour les SDK) : vous devez disposer de l'autorisation Gérer pour le SDK.
  • Google Cloud (les deux) : vous devez disposer des autorisations serviceusage.services.enable et resourcemanager.projects.get sur le projet Google Cloud cible.

Pour les applications (Google Play Console) :

  1. Ouvrez Google Play Console > Protégé avec Play > API Play Integrity > Gérer.
  2. Consultez la section "Configuration du projet".
  3. Assurez-vous que le numéro de projet indiqué correspond à celui utilisé pour appeler l'API Play Integrity.

Pour les SDK (Google Play SDK Console) :

  1. Ouvrez Google Play SDK Console > Intégrité du SDK > Paramètres.
  2. Consultez la section "Configuration du projet".
  3. Assurez-vous que le numéro de projet indiqué correspond à celui utilisé pour appeler l'API Play Integrity.

Q4 : Comment associer mon projet Cloud si mon application ou mon SDK ne sont pas sur Google Play ?

L'association d'un projet Google Cloud n'est disponible que pour les applications gérées dans la Google Play Console et les SDK enregistrés dans la Google Play SDK Console.

Si votre application est distribuée exclusivement en dehors de Google Play ou si votre SDK ne figure pas dans la Play SDK Console, vous ne pouvez pas associer de projet Google Cloud. Le trafic de l'API Play Integrity sera limité à 10 000 requêtes par jour par défaut. Pour pouvoir bénéficier d'un quota plus élevé, publiez votre application sur Google Play ou enregistrez votre SDK éligible dans la Play SDK Console, puis associez votre projet Cloud.

Q5 : Puis-je associer plusieurs projets Google Cloud ou partager un projet entre plusieurs applications ou SDK ?

  • Plusieurs projets par application ou SDK : vous pouvez associer jusqu'à cinq projets Google Cloud à une même application ou un même SDK.
  • Un projet pour plusieurs applications : vous pouvez associer le même projet Google Cloud à plusieurs applications dans la Google Play Console. Il n'est pas possible d'associer le même projet Google Cloud à plusieurs SDK, ni à un SDK et une application.

Q6 : Que se passe-t-il si je gère l'application ou le SDK, mais que quelqu'un d'autre dans mon organisation est propriétaire du projet Google Cloud ?

Pour finaliser l'association, l'utilisateur qui effectue l'action dans la Play Console (ou la Play SDK Console) doit également disposer des autorisations requises sur le projet Google Cloud. Vous pouvez procéder de deux manières :

  • Option A : Demandez à une personne pouvant gérer l'accès IAM sur le projet Google Cloud d'accorder temporairement à votre compte Google les autorisations serviceusage.services.enable et resourcemanager.projects.get. Une fois l'association effectuée, ces autorisations ne sont plus nécessaires pour les opérations quotidiennes.
  • Option B : Accordez à un membre de l'équipe qui dispose déjà des autorisations serviceusage.services.enable et resourcemanager.projects.get sur le projet Google Cloud l'autorisation requise dans la console pour qu'il puisse effectuer l'association :
    • Pour les applications (Play Console) : accordez l'autorisation Mettre les applications à disposition de tous les utilisateurs, exclure des appareils et utiliser la signature d'application Play pour l'application.
    • Pour les SDK (Play SDK Console) : accordez l'autorisation Gérer pour le SDK.

Q7 : Que se passe-t-il si je n'associe pas mon projet Cloud avant le 16 février 2027 ?

Si une application ou un SDK envoie des requêtes API Play Integrity à l'aide d'un projet Google Cloud non associé après le 16 février 2027 :

  1. Jusqu'à 10 000 requêtes par jour : les requêtes continuent d'aboutir normalement dans le cadre du quota de base par défaut.
  2. Au-delà de 10 000 requêtes par jour : une fois que le projet non associé atteint 10 000 requêtes par jour, les requêtes sont rejetées avec l'erreur TOO_MANY_REQUESTS (code d'erreur -8).

Correction instantanée en libre-service :

Si votre application ou votre SDK reçoit des erreurs TOO_MANY_REQUESTS après la date limite parce qu'un projet Cloud n'a pas été associé, associer le projet Google Cloud manquant dans la Play Console ou la Play SDK Console résoudra le problème.

Q8 : Je n'utilise pas l'API Play Integrity. Pourquoi ai-je reçu un message me demandant d'associer mon projet Cloud ?

Vous avez reçu cette notification,car votre projet Google Cloud génère plus de 10 000 requêtes API Play Integrity non associées par jour. Voici les raisons les plus courantes :

  1. Une bibliothèque ou un SDK configuré avec votre numéro de projet Cloud : certaines bibliothèques appellent l'API Play Integrity à l'aide de votre projet Google Cloud. Si votre application ou votre SDK utilise une telle bibliothèque, associez ce projet à votre application dans la Play Console ou à votre SDK dans la Play SDK Console.
  2. Une autre application ou équipe de votre organisation : une autre équipe utilise peut-être ce projet Google Cloud dans son application ou son SDK. Contactez vos équipes d'ingénieurs pour identifier l'application ou le SDK, puis associez le projet dans la Play Console ou la Play SDK Console.
  3. Trafic non autorisé ou intégration obsolète : si des applications non autorisées ou clonées envoient des requêtes avec votre numéro de projet, ou si vous n'utilisez plus l'API, aucune action n'est requise. Laisser la limite de 10 000 requêtes par jour non associées prendre effet limitera le trafic indésirable.

Contact et assistance

Si vous avez des questions sur l'association de votre projet Cloud ou la gestion de votre quota pour l'API Play Integrity :