Limiti e quote per le richieste API

Questo documento descrive i limiti e le quote per richiedere le API di gestione e le API di reporting.

Google Analytics è utilizzato da milioni di siti. Impostiamo limiti e quote per le richieste API per impedire al sistema di ricevere più dati di quanto possa gestire e per garantire una distribuzione equa delle risorse di sistema. I limiti e le quote sono soggetti a modifica.

Questo video illustra le best practice per la gestione delle quote delle richieste dell'API Google Analytics.

Limiti di quota generali

Le seguenti quote si applicano a API di gestione, API Core Reporting v3, API MCF Reporting, API metadata, API User Deletion e API di reporting in tempo reale:

  • 50.000 richieste per progetto al giorno, che possono essere aumentate.
  • 10 query al secondo (QPS) per indirizzo IP.
    • Nella console API, esiste una quota simile denominata Richieste per 100 secondi per utente. Per impostazione predefinita, il valore è impostato su 100 richieste ogni 100 secondi per utente e può essere regolato fino a un valore massimo di 1000. Tuttavia, il numero di richieste all'API è limitato a un massimo di 10 richieste al secondo per utente.
    • Se la tua applicazione effettua tutte le richieste API da un singolo indirizzo IP (ad esempio per conto dei tuoi utenti), utilizza il parametro userIP o quotaUser con ogni richiesta per ottenere la quota QPS completa per ogni utente. Per maggiori dettagli, consulta il riepilogo dei parametri di query standard.

Reporting APIs

Le seguenti quote si applicano a tutte le API di reporting, tra cui API Core Reporting v3, API Analytics Reporting v4, API Real Time v3 e API Multi-channel Funnel v3:

  • 10.000 richieste per vista (profilo) al giorno (non è possibile aumentarlo)
  • 10 richieste in parallelo per vista (profilo) (non è possibile aumentarle)

Errori relativi alle richieste delle API di reporting

Se la tua richiesta all'API di reporting non va a buon fine e si verifica un errore del server, riceverai un codice di risposta 500 o 503. Puoi inviare nuovamente la richiesta, ma non inviarla nuovamente più di una volta se l'esito viene risolto ripetutamente. Google Analytics consente:

  • 10 richieste di errori del server non riuscite per progetto per vista (profilo) all'ora
  • 50 richieste di errori del server non riuscite per progetto per vista (profilo) al giorno

Se il numero di richieste non riuscite supera queste quote, verrà visualizzato il seguente errore:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Per ridurre le probabilità che si verifichi un errore nel server di richiesta, semplifica la richiesta riducendo l'intervallo di date, il numero di dimensioni nella richiesta o il numero di metriche nella richiesta.

Non inviare continuamente una richiesta non andata a buon fine. Implementa il backoff esponenziale per inviarlo nuovamente.

Le quote di frequenza di errore del server vengono applicate in finestre temporali continue per ciascuna delle quote di frequenza di errore oraria e giornaliera. Un'ora dopo il primo errore del server di un progetto e della coppia di visualizzazioni, la quota viene reimpostata. Se una coppia di progetto e visualizzazione invia 10 errori del server in un'ora, la coppia progetto e visualizzazione viene bloccata dall'API fino all'ora successiva a quando scade il primo errore del server.

Ad esempio, se una coppia di progetto e visualizzazione non ha inviato un errore del server nelle ultime 24 ore, il progetto e la vista avranno utilizzato 0 delle sue 50 quote. Supponiamo che questo progetto e la visualizzazione inviino un errore del server alle 06:12. Se il progetto e la visualizzazione inviano altri 49 errori del server prima delle 6:12 del giorno successivo, il progetto e la visualizzazione verranno bloccati fino alle 6:12 del giorno successivo. Alle 06:12 del giorno successivo, la quota di frequenza di errori del server verrà reimpostata completamente per questo progetto e questa visualizzazione.

API Analytics Reporting v4

Queste quote si applicano solo all'API Analytics Reporting v4:

  • Numero di richieste al giorno per progetto: 50.000
  • Numero di richieste per visualizzazione (profilo) al giorno: 10.000 (non può essere aumentato)
  • Numero di richieste per 100 secondi per progetto: 2000
  • Numero di richieste per 100 secondi per utente per progetto: 100 (può essere aumentato nella console API di Google a 1000).

Puoi visualizzare le quote del tuo progetto nella console API di Google.

Quota basata sulle risorse

L'API Analytics Reporting v4 è inoltre regolata dalla quota basata sulle risorse facoltativa, che consente di utilizzare soglie di campionamento più elevate per i clienti di Analytics 360.

Superamento dei limiti di quota

Se viene superata la quota di richiesta di un'API Google Analytics, l'API restituisce un codice di errore 403 o 429 e un messaggio che indica che l'account ha superato la quota. Per ulteriori informazioni, leggi i Termini di servizio.

Richiesta di quota aggiuntiva

Puoi richiedere solo di aumentare:

Per visualizzare o modificare i limiti di utilizzo relativi al progetto o per richiedere un incremento della quota, procedi come segue:

  1. Se non hai ancora un account di fatturazione per il progetto, creane uno.
  2. Visita la pagina API abilitate della libreria API nella console API e seleziona un'API dall'elenco.
  3. Per visualizzare e modificare le impostazioni relative alla quota, seleziona Quote. Per visualizzare le statistiche sull'utilizzo, seleziona Utilizzo.

Per richiedere un aumento della quantità massima della quota, utilizza il modulo di richiesta della quota dell'API Analytics. Assicurati di esaminare le informazioni e di seguire le istruzioni riportate nel modulo di richiesta della quota prima di inviare la richiesta. Per l'API di reporting v4, il nome dell'API nella console API di Google è API Google Analytics Reporting. Tutte le altre API v3 (ad es. API Management v3, API Core Reporting v3, API Real Time Reporting v3, API User Deletion v3) sono elencate in API Analytics nella Console API di Google.

Per saperne di più sulla gestione delle quote e su come ottimizzare l'applicazione per l'utilizzo della quota, consulta Monitoraggio delle API e limitazione dell'utilizzo.