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. Abbiamo stabilito limiti e quote per le richieste API per impedire al sistema di ricevere più dati di quanti sia in grado di 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 per le 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 su 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 (ovvero per conto dei tuoi utenti), utilizza il parametro userIP o quotaUser con ogni richiesta per ottenere la quota QPS completa per ogni utente. Per ulteriori dettagli, consulta il riepilogo dei parametri di query standard.

Superamento dei limiti di quota

Se viene superata la quota per la 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 di aumentare solo:

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 di 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 dell'importo massimo della quota, utilizza il modulo di richiesta della quota dell'API di Analytics. Assicurati di esaminare le informazioni e di seguire le istruzioni 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 di reporting di Google Analytics. Tutte le altre API v3 (ad es. le API Management v3, l'API Core Reporting v3, l'API Real Time Reporting v3, l'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.