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.

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.