All'API Data 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 descritte in questa pagina. Le quote vengono utilizzate 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 quattro categorie di quote per le richieste: Core, Realtime, Funnel e Chat.
Le richieste API ai metodi principali vengono addebitate in base alle quote principali. Le richieste API ai metodi Realtime vengono addebitate in base alle quote Realtime. Le richieste API ai metodi Funnel addebitano quote Funnel. Le richieste API ai metodi di Chat addebitano le quote di Chat. 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 |
| Chat | properties.chat |
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 principali per proprietà | 10 | 50 |
| Errori del server principale 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 del funnel 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 |
| Token della chat per proprietà al giorno | 3.750.000 | 3.750.000 |
| Token di chat per proprietà all'ora | 500.000 | 500.000 |
- 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 e proprietà, tutte le richieste alla proprietà dal progetto vengono bloccate. Per un elenco completo delle risposte di errore, consulta Risposte di errore.
- 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".
Alle proprietà sono consentite 120 richieste potenzialmente soggette a soglia 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 consumati a ogni richiesta all'API Google Analytics Data v1.
Il numero di token addebitati dipende dalla complessità della richiesta. Mentre la maggior parte
delle richieste addebiterà 10 o meno token, quelle più complesse (come le query
di Analytics Advisor chat) ne utilizzeranno di più.
Fattori che influenzano il consumo di token
Il costo esatto dei token per una richiesta viene determinato al momento dell'esecuzione, rendendo difficile il precalcolo 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:richiedi 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 tempo 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 maggiore di eventi 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 tue chiamate API specifiche
è includere il parametro "returnPropertyQuota": true nel corpo della richiesta.
La risposta dell'API includerà quindi l'oggetto PropertyQuota, che descrive in dettaglio i
token consumati da quella richiesta specifica e i saldi della quota rimanenti.
Consumo e monitoraggio dei token di chat
Per le richieste di Analytics Advisor chat, i token rappresentano i costi di calcolo, ragionamento e recupero dei dati sottostanti del modello. Il consumo di token di chat è influenzato da:
- Ambito di query e analisi:complessità e ampiezza dell'analisi richiesta.
- Token di input e output del modello: volume di dati contestuali elaborati e narrativa della risposta generata.
- Token di pensiero:passaggi di ragionamento del modello necessari per sintetizzare i risultati.
- Latenza di esecuzione: tempo di elaborazione necessario per l'esplorazione dei dati in più passaggi.
Per monitorare l'utilizzo dei token di chat, imposta "returnPropertyQuota": true
nel tuo
ChatRequest. La risposta includerà l'oggetto PropertyChatQuota contenente i campi tokensPerDay e tokensPerHour con i saldi consumati e rimanenti.