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.

API di gestione

Google Analytics applica le quote alle richieste alle seguenti API di gestione:

API di scrittura

Queste quote si applicano alle richieste di scrittura (insert, update, patch e delete):

Errori nelle richieste di scrittura

Se la richiesta di scrittura non va a buon fine e ricevi un codice di risposta 500 o 503, puoi inviarla di nuovo. Google Analytics consente:

  • 50 richieste di scrittura non riuscite all'ora.

Se tenti di inviare più di 50 richieste di scrittura non riuscite all'ora, verrà visualizzato il seguente errore:

Quota Error: The number of recent failed writes is too high.

Anziché inviare di nuovo continuamente una richiesta di scrittura non riuscita, implementa il backoff esponenziale per inviarla nuovamente.

API Data Import

Queste quote sono specifiche per la risorsa Uploads:

  • Limiti di archiviazione per l'importazione di dati estesi per tutta la durata (non si applica ai dati sugli hit inviati da SDK e API di raccolta):
  • 50 set di dati per proprietà
  • 50 operazioni di caricamento per proprietà al giorno
  • 1 GB per file caricato
  • Limiti specifici per i Dati di costo:
    • 100 MB per data (ga:date) per set di dati. Ad esempio, se importi 50 MB di dati per il 10/10/2014 in un caricamento e 50 MB di dati per il 10/10/2014 in un secondo caricamento, hai raggiunto il limite di 100 MB per il 10/10/2014 per quel set di dati.

API esperimenti

Questa quota si applica solo agli esperimenti:

  • 12 esperimenti per vista (profilo)

Gli esperimenti con uno dei seguenti statuses vengono conteggiati ai fini di questa quota:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Gli esperimenti terminati (stato = ENDED) per più di un giorno non vengono conteggiati ai fini di questa quota.

API non campionata di report

Queste quote si applicano solo ai report non campionati:

  • Le richieste API per creare report non campionati vengono conteggiate nella quota generale di richieste di scrittura.
  • L'API utilizza lo stesso sistema di token per proprietà, al giorno, utilizzato dall'interfaccia web per creare report non campionati.
  • Il numero massimo consentito di report non campionati è 3.500. Quando viene raggiunto questo limite, il tentativo di creare ulteriori report non campionati con l'API genera il seguente errore: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

API User Permission

Questa quota si applica solo alle autorizzazioni dell'utente:

  • Un utente può avere al massimo 100 account Analytics. L'aggiunta di un utente che ha 100 account Analytics a un nuovo account provoca un errore.

Le seguenti quote si applicano alle richieste di scrittura in batch (delete, insert, update) alle autorizzazioni utente:

  • 300 richieste di scrittura di autorizzazioni utente per richiesta batch
  • 30 richieste di scrittura di autorizzazioni utente in batch conteggiate come 1 richiesta di scrittura

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.