All'API di dati si applicano i seguenti limiti e quote.
Come vengono applicate le quote
Tutte le richieste all'API Google Analytics Data v1 richiedono un progetto Google Cloud e sono soggette alle quote indicate 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 a 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, In tempo reale e Canalizzazione. Le richieste API ai metodi Core addebitano le quote Core. Le richieste API ai metodi in tempo reale addebitano le quote in tempo reale. Ogni richiesta consuma un solo tipo di quota.
| Categoria di quota | Metodi dell'API |
|---|---|
| Tronco | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| In tempo reale | runRealtimeReport |
| Canalizzazione | runFunnelReport |
Quote delle proprietà Analytics
Tutte le richieste consumano le quote delle 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 Core per proprietà | 10 | 50 |
| Errori del server Core per progetto per proprietà all'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à all'ora | 10 | 50 |
| Token di canalizzazione per proprietà al giorno | 200.000 | 2.000.000 |
| Token di canalizzazione per proprietà all'ora | 40.000 | 400.000 |
| Token di canalizzazione per progetto per proprietà all'ora | 14.000 | 140.000 |
| Richieste simultanee di canalizzazione per proprietà | 10 | 50 |
| Errori del server di canalizzazione per progetto per proprietà all'ora | 10 | 50 |
- Le richieste simultanee vengono misurate in base al numero di richieste eseguite contemporaneamente. Per ridurre la simultaneità delle richieste, attendi il completamento delle richieste precedenti prima di inviare richieste aggiuntive.
- 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 essere esaurita prima della quota "Token per progetto per proprietà all'ora".
Alle proprietà sono consentite 120 richieste potenzialmente soggette a soglia all'ora. Le dimensioni userAgeBracket, userGender, brandingInterest, audienceId e audienceName sono potenzialmente soggette a soglia. 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 della proprietà
I token vengono consumati con ogni richiesta all'API Google Analytics Data v1. Il numero di token addebitati dipende dalla complessità della richiesta. Sebbene la maggior parte delle richieste addebiti 10 o meno token, le richieste più complesse ne consumeranno di più.
Fattori che influenzano il consumo di token
Il costo esatto dei token per una richiesta viene determinato al momento dell'esecuzione, il che rende difficile il pre-calcolo preciso. Il costo è influenzato da una combinazione di fattori correlati alla richiesta stessa e ai dati sottostanti nella proprietà Google Analytics. Questi fattori possono comportare costi più elevati:
- Numero di righe: richiesta di un numero maggiore di righe.
- Numero di dimensioni e metriche: inclusione di un numero maggiore di dimensioni e metriche.
- Complessità del filtro: utilizzo di espressioni di filtro complesse.
- Durata dell'intervallo di date: esecuzione di query su periodi di date più lunghi.
- Cardinalità dei dati: le dimensioni con cardinalità elevata (molti valori unici, come
pagePath, dimensioni personalizzate) possono aumentare notevolmente il costo dei token. - Volume di eventi della proprietà: le query sulle proprietà con un volume di eventi più elevato potrebbero consumare più token rispetto alla stessa query su una proprietà con meno dati.
Monitoraggio dell'utilizzo dei token
Il modo più efficace per determinare il costo dei token per le chiamate API specifiche
è includere il parametro "returnPropertyQuota": true nel corpo della richiesta.
La risposta dell'API includerà l'oggetto PropertyQuota, che descrive in dettaglio i token consumati dalla richiesta specifica e i saldi delle quote rimanenti.