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.

API di gestione

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

Scrivi API

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

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

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 di:

  • 50 richieste di scrittura non riuscite all'ora.

Se tenti di inviare più di 50 richieste di scrittura non riuscite all'ora, riceverai 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 complessivi per l'Importazione dati estesa (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 ogni 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 Experiments

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 per questa quota.

API non campionata per i 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 di report non campionati consentiti è 3.500. Quando questo limite viene raggiunto, il tentativo di creare ulteriori report non campionati con i risultati dell'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 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) 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 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.