API Play Integrity: guida al collegamento dei progetti cloud e alle quote

L'API Google Play Integrity applica un limite di 10.000 richieste al giorno al traffico proveniente da progetti Google Cloud non collegati a un'app in Google Play Console o a un SDK in Play SDK Console. Questo limite è già attivo per la maggior parte dei progetti Google Cloud. A un numero limitato di progetti con una quota aumentata preesistente è stata concessa una scadenza estesa fino al 16 febbraio 2027 per completare il collegamento prima dell'applicazione del limite.

Questa guida spiega in che modo il collegamento dei progetti influisce sulla tua quota, come collegare i tuoi progetti Google Cloud alla tua app o al tuo SDK e risponde alle domande frequenti.

Breve riepilogo

Dettaglio chiave Descrizione
Data di applicazione Già attivo per la maggior parte dei progetti.
16 febbraio 2027 per i progetti che hanno ricevuto una notifica della scadenza.
Norme Le richieste dell'API Play Integrity provenienti da progetti cloud non collegati alla tua app o al tuo SDK sono limitate a 10.000 richieste al giorno, indipendentemente da una quota personalizzata più elevata configurata nel progetto.
Chi è interessato App e SDK che effettuano più di 10.000 richieste al giorno utilizzando un progetto Google Cloud non collegato all'app (in Play Console) o all'SDK (in Play SDK Console).
Azione richiesta Collega i tuoi progetti Google Cloud alla tua app in Google Play Console o al tuo SDK in Google Play SDK Console.
Errore di superamento della quota Le richieste non collegate che superano le 10.000 al giorno non vanno a buon fine con l'errore TOO_MANY_REQUESTS (codice di errore -8).

Domande frequenti

L'API Play Integrity fornisce a ogni progetto Google Cloud una quota predefinita di 10.000 richieste al giorno. Gli sviluppatori che richiedono un volume più elevato possono richiedere un aumento della quota.

Per proteggere la tua app o il tuo SDK e impedire a terze parti non autorizzate di esaurire la tua quota, una quota giornaliera aumentata è limitata esclusivamente ai progetti Google Cloud collegati alla tua app in Google Play Console o al tuo SDK in Google Play SDK Console.

Per le app (Google Play Console):

  1. Accedi a Google Play Console e seleziona la tua app.
  2. Nel menu di navigazione a sinistra, vai a Protetto con Play.
  3. Accanto ad API Play Integrity, seleziona Inizia (o Gestisci).
  4. Fai clic su Collega progetto Cloud (o Aggiungi progetto se hai già progetti collegati).
  5. Seleziona o inserisci il numero del progetto Google Cloud che vuoi collegare e conferma.

Per gli SDK (Google Play SDK Console):

  1. Accedi a Google Play SDK Console e seleziona il tuo SDK.
  2. Nel menu di navigazione a sinistra, vai a Integrità dell'SDK.
  3. Accanto ad API Play Integrity, fai clic su Impostazioni.
  4. Fai clic su Collega progetto Cloud (o Aggiungi un altro se hai già progetti collegati).
  5. Seleziona o inserisci il numero del progetto Google Cloud che vuoi collegare e conferma.

Autorizzazioni richieste:

  • Play Console (per le app): devi disporre dell'autorizzazione "Rilascio per il gruppo di produzione, esclusione di dispositivi e utilizzo della funzionalità firma dell'app di Google Play" per l'app.
  • Play SDK Console (per gli SDK): devi disporre dell'autorizzazione "Gestione" per l'SDK.
  • Google Cloud (entrambi): devi disporre delle autorizzazioni "serviceusage.services.enable" e "resourcemanager.projects.get" per il progetto Google Cloud di destinazione.

Per le app (Google Play Console):

  1. Apri Google Play Console > Protetto con Play > API Play Integrity > Gestisci.
  2. Controlla la sezione Configurazione del progetto.
  3. Assicurati che il numero di progetto elencato corrisponda a quello utilizzato per chiamare l'API Play Integrity.

Per gli SDK (Google Play SDK Console):

  1. Apri Google Play SDK Console > Integrità dell'SDK > Impostazioni.
  2. Controlla la sezione Configurazione del progetto.
  3. Assicurati che il numero di progetto elencato corrisponda a quello utilizzato per chiamare l'API Play Integrity.

D4: Come faccio a collegare il mio progetto cloud se la mia app o il mio SDK non sono su Google Play?

Il collegamento di un progetto Google Cloud è disponibile solo per le app gestite in Google Play Console e per gli SDK registrati in Google Play SDK Console.

Se la tua app viene distribuita esclusivamente al di fuori di Google Play o il tuo SDK non è presente in Play SDK Console, non puoi collegare un progetto Google Cloud e il traffico dell'API Play Integrity sarà limitato alle 10.000 richieste predefinite al giorno. Per diventare idoneo per una quota più elevata, pubblica la tua app su Google Play o registra il tuo SDK idoneo in Play SDK Console e collega il tuo progetto Cloud.

D5: Posso collegare più progetti Google Cloud o condividere un progetto tra app o SDK?

  • Più progetti per app o SDK:puoi collegare fino a cinque progetti Google Cloud a una singola app o SDK.
  • Un progetto per più app:puoi collegare lo stesso progetto Google Cloud a più app in Google Play Console. Il collegamento dello stesso progetto Google Cloud a più SDK o a un SDK e un'app non è supportato.

D6: Cosa succede se gestisco l'app o l'SDK, ma un'altra persona della mia organizzazione è proprietaria del progetto Google Cloud?

Per completare il collegamento, l'utente che esegue l'azione in Play Console (o Play SDK Console) deve disporre anche delle autorizzazioni richieste per il progetto Google Cloud. Puoi coordinare questa operazione in uno dei due modi seguenti:

  • Opzione A: chiedi a qualcuno che può gestire l'accesso IAM nel progetto Google Cloud di concedere temporaneamente al tuo Account Google le autorizzazioni "serviceusage.services.enable" e "resourcemanager.projects.get". Una volta collegati, queste autorizzazioni non sono più necessarie per le operazioni quotidiane.
  • Opzione B: concedi a un membro del team che dispone già di "serviceusage.services.enable" e "resourcemanager.projects.get" nel progetto Google Cloud l'autorizzazione della console richiesta per eseguire il passaggio di collegamento:
    • Per le app (Play Console): concedi l'autorizzazione "Rilascio per il gruppo di produzione, esclusione di dispositivi e utilizzo della funzionalità firma dell'app di Google Play" per l'app.
    • Per gli SDK (Play SDK Console): concedi l'autorizzazione "Gestisci" per l'SDK.

D7: Cosa succede se non collego il mio progetto Cloud prima del 16 febbraio 2027?

Se un'app o un SDK invia richieste dell'API Play Integrity utilizzando un progetto Google Cloud non collegato dopo il 16 febbraio 2027:

  1. Fino a 10.000 richieste al giorno:le richieste continuano a essere eseguite normalmente con la quota di base predefinita.
  2. Oltre 10.000 richieste al giorno: una volta che il progetto non collegato raggiunge 10.000 richieste al giorno, le richieste vengono rifiutate con l'errore TOO_MANY_REQUESTS (codice di errore -8).

Risoluzione self-service istantanea:

Se la tua app o il tuo SDK riceve errori TOO_MANY_REQUESTS dopo la scadenza perché non è stato collegato un progetto Cloud, il problema verrà risolto collegando il progetto Google Cloud mancante in Play Console o Play SDK Console.

D8: Non utilizzo l'API Play Integrity. Perché ho ricevuto un messaggio che mi chiede di collegare il mio progetto cloud?

Hai ricevuto questa comunicazione perché il tuo progetto Google Cloud genera più di 10.000 richieste API Play Integrity non collegate al giorno. Alcuni dei motivi più comuni sono:

  1. Una libreria o un SDK configurati con il numero del tuo progetto Cloud:alcune librerie chiamano l'API Play Integrity utilizzando il tuo progetto Google Cloud. Se la tua app o il tuo SDK utilizza una libreria di questo tipo, collega il progetto alla tua app in Play Console o al tuo SDK in Play SDK Console.
  2. Un'altra app o un altro team della tua organizzazione: un altro team potrebbe utilizzare questo progetto Google Cloud nella propria app o nel proprio SDK. Rivolgiti ai tuoi team di progettazione per identificare l'app o l'SDK, quindi collega il progetto in Play Console o Play SDK Console.
  3. Traffico non autorizzato o un'integrazione ritirata: se app non autorizzate o clonate inviano richieste con il numero del tuo progetto o se non utilizzi più l'API, non è richiesta alcuna azione. Se lasci che il limite di 10.000 richieste al giorno non collegate abbia effetto,il traffico indesiderato verrà limitato.

Contatti e assistenza

Se hai domande sul collegamento del progetto Cloud o sulla gestione della quota dell'API Play Integrity: