Quote e limiti dell'API di dati

All'API Data si applicano i seguenti limiti e quote.

Come vengono applicate le quote

Tutte le richieste all'API di dati di Google Analytics v1 richiedono un progetto Google Cloud e sono soggette alle quote descritte in questa pagina. Le quote vengono consumate indipendentemente dal metodo utilizzato per identificare il progetto chiamante, tra cui:

  • Richieste autenticate con le credenziali OAuth 2.0.
  • Richieste autenticate utilizzando solo una chiave API.

Le chiavi API vengono utilizzate per associare una richiesta a un progetto Google Cloud specifico ai fini di quota e fatturazione. Tutte le chiamate API effettuate utilizzando le credenziali o una chiave API del tuo progetto verranno conteggiate ai fini delle quote applicabili del progetto e della proprietà Google Analytics.

Categorie di quote

L'API di dati ha tre categorie di quote per le richieste: Core, Realtime e Funnel. Le richieste API ai metodi Core vengono addebitate in base alle quote Core. Le richieste API ai metodi in tempo reale vengono addebitate in base alle quote in tempo reale. Ogni richiesta consuma un solo tipo di quota.

Categoria di quota Metodi dell'API
Definizione runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports
In tempo reale runRealtimeReport
Canalizzazione runFunnelReport

Quote delle proprietà Analytics

Tutte le richieste consumano le quote della proprietà.

Nome quota Limite delle proprietà standard Limite delle proprietà Analytics 360
Token core per proprietà al giorno 200.000 2.000.000
Token core per proprietà all'ora 40.000 400.000
Token core per progetto per proprietà all'ora 14.000 140.000
Richieste simultanee principali per proprietà 10 50
Errori del server principali per progetto, per proprietà e per ora 10 50
Token in tempo reale per proprietà al giorno 200.000 2.000.000
Token in tempo reale per proprietà all'ora 40.000 400.000
Token in tempo reale per progetto, per proprietà, all'ora 14.000 140.000
Richieste simultanee in tempo reale per proprietà 10 50
Errori del server in tempo reale per progetto, per proprietà e per ora 10 50
Token del funnel per proprietà al giorno 200.000 2.000.000
Token canalizzazione per proprietà all'ora 40.000 400.000
Token canalizzazione per progetto, per proprietà, all'ora 14.000 140.000
Richieste simultanee di canalizzazione per proprietà 10 50
Errori del server del funnel per progetto, per proprietà e per ora 10 50
  • Le richieste simultanee vengono misurate in base al numero di richieste eseguite contemporaneamente. Per ridurre la concorrenza delle richieste, attendi il completamento delle richieste precedenti prima di inviarne altre.
  • Gli errori del server sono i codici 500 e 503. Le quote per gli errori del server vengono addebitate solo quando una richiesta genera un errore del server. Quando le quote per gli errori del server sono esaurite per una coppia progetto-proprietà, tutte le richieste alla proprietà dal progetto vengono bloccate.
  • Ogni richiesta consuma la quota sia per i token per proprietà all'ora sia per i token per progetto per proprietà all'ora. Ciò significa che una proprietà deve essere accessibile da più di 3 progetti prima che la quota "Token per proprietà all'ora" possa esaurirsi prima della quota "Token per progetto per proprietà all'ora".

Le proprietà possono inviare 120 richieste con soglia potenziale all'ora. Le dimensioni userAgeBracket, userGender, brandingInterest, audienceId e audienceName sono potenzialmente soggette a soglie. Le soglie vengono applicate per impedire a chiunque visualizzi un report di dedurre i dati demografici o gli interessi dei singoli utenti.

Quota di token di proprietà

I token vengono calcolati a ogni richiesta a seconda della sua complessità. La maggior parte delle richieste addebiterà 10 o meno token. Quando un numero elevato di token di quota viene consumato da una richiesta, spesso sono responsabili i seguenti fattori:

  • Numero elevato di righe
  • Numero elevato di colonne
  • Criteri di filtro complessi
  • Intervallo di date lungo

Con ogni richiesta API, puoi specificare "returnPropertyQuota": true nel corpo della richiesta per restituire lo stato attuale dei token di quota della proprietà. Questo stato contiene sia la quantità consumata da questa richiesta sia la quantità rimanente per ogni gruppo di quote. Ad esempio, valuta la possibilità di specificare questo parametro in RunReportRequest.