Limiti e quote per le richieste API

Questo documento descrive i limiti e le quote per i quali sono richieste le API di gestione e le API di reporting.

Google Analytics viene utilizzato da milioni di siti. Poniamo limiti e quote sulle richieste API per proteggere il sistema dalla ricezione di più dati di quelli che è in grado di gestire e per garantire una distribuzione equa delle risorse del sistema. I limiti e le quote sono soggetti a modifica.

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

Limiti di quota generali

Le seguenti quote si applicano all'API di gestione, all'API di reporting principale v3, all'API di reporting MCF, all'API di metadati, all'API User Deletion e all'API di reporting in tempo reale:

  • 50.000 richieste per progetto al giorno, che possono aumentare.
  • 10 query al secondo (QPS) per indirizzo IP.
    • Nella Console API è presente una quota simile denominata Richieste per 100 secondi per utente. Per impostazione predefinita è impostato su 100 richieste ogni 100 secondi per utente e può essere impostato su un valore massimo di 1000. Tuttavia, il numero di richieste all'API è limitato a un massimo di dieci 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 per ogni richiesta per ottenere la quota QPS completa per ogni utente. Per informazioni dettagliate, consulta il riepilogo dei parametri di ricerca 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):

  • 50 richieste di scrittura per progetto al giorno, che possono aumentare
  • 1,5 query al secondo (QPS) per ID account

Errori di richiesta 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 continuamente una richiesta di scrittura non riuscita, implementa il backoff esponenziale per inviarla di nuovo.

API Data Import

Queste quote sono specifiche per la risorsa Uploads:

  • Limiti di archiviazione per l'importazione di dati estesa per tutta la durata (non si applicano 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 per il 2014-10-10 in un caricamento e 50 MB per il 2014-10-10 in un secondo caricamento, hai raggiunto il limite di 100 MB per il set di dati 2014-10-10.

API Experiment

Questa quota si applica solo agli esperimenti:

  • 12 esperimenti per vista (profilo)

Per questa quota vengono conteggiati gli esperimenti con uno dei seguenti statuses:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

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

API Report non campionati

Queste quote si applicano solo ai Report non campionati:

  • Le richieste API per la creazione di report non campionati vengono conteggiate nella quota di richieste di scrittura generale.
  • L'API utilizza lo stesso sistema di token per proprietà, al giorno che l'interfaccia web utilizza per creare report non campionati.
  • Il numero massimo consentito di report non campionati è 3500. Quando viene raggiunto questo limite, prova a creare altri report non campionati con i risultati dell'API nel 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 con 100 account Analytics a un nuovo account causa un errore.

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

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

Superare i limiti di quota

Se la quota di richiesta di un'API di Google Analytics viene superata, l'API restituisce un codice di errore 403 o 429 e un messaggio che l'account ha superato la quota. Per saperne di più, consulta 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 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 della quota massima, utilizza il modulo di richiesta di quota API di Analytics. Assicurati di controllare le informazioni e di seguire le istruzioni nel modulo di richiesta di quota prima di inviare la richiesta. Per l'API di reporting v4, il nome dell'API in Google API Console è API di reporting di Google Analytics. Tutte le altre API v3 (ad es. L'API di gestione 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 ulteriori informazioni sulla gestione della quota e su come ottimizzare la tua applicazione per l'utilizzo della quota, consulta Monitoraggio delle API e dell'utilizzo delle quote.