Ogni richiesta API verifica le quote che non sono state esaurite e utilizza le quote. Se una quota è esaurita, la richiesta non va a buon fine e viene visualizzato un messaggio di errore pertinente. Ogni richiesta dell'API di dati controlla diversi bucket di quota.
Categorie di quota
Ai fini della quota, l'API di dati dispone di tre categorie di richieste: principali, in tempo reale e canalizzazione. Per le richieste API ai metodi Core vengono addebitate le quote Core. Le richieste API per i metodi Realtime addebitano le quote Realtime. Una richiesta non utilizzerà le quote Core e Realtime. Di seguito sono riportati i metodi e le categorie dell'API:
Categoria quota | Metodi API |
---|---|
Principale | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
In tempo reale | runRealtimeReport |
Canalizzazione | runFunnelReport |
Quote delle proprietà Analytics
Tutte le richieste utilizzano le quote delle proprietà.
Nome quota | Limite proprietà standard | Limite proprietà Analytics 360 |
---|---|---|
Token principali per proprietà al giorno | 200.000 | 2.000.000 |
Token principali per proprietà all'ora | 40.000 | 400.000 |
Token principali per progetto per proprietà all'ora | 14.000 | 140.000 |
Richieste simultanee principali per proprietà | 10 | 50 |
Errori principali del server 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 per la canalizzazione per proprietà | 10 | 50 |
Errori del server della canalizzazione per progetto per proprietà all'ora | 10 | 50 |
- Le richieste in parallelo sono misurate in base al numero di richieste eseguite contemporaneamente. Per ridurre la contemporaneità delle richieste, attendi il completamento di richieste precedenti prima di inviare altre richieste.
- Gli errori del server sono i codici 500 e 503. Le quote Errori del server vengono addebitate solo quando si verifica un errore del server di una richiesta. Quando le quote Errori del server vengono esaurite per una coppia di progetto e proprietà, tutte le richieste dal progetto alla proprietà vengono bloccate.
- Ogni richiesta utilizza la quota sia per i token per proprietà all'ora che per i token per progetto per proprietà all'ora. Ciò significa che più di tre progetti devono accedere a una proprietà prima che la quota "Token per proprietà all'ora" possa essere esaurita prima della quota "Token per progetto per proprietà per ora".
Alle proprietà sono consentite 120 richieste con soglia potenziale all'ora. Le
dimensioni userAgeBracket
, userGender
, brandingInterest
, audienceId
e audienceName
hanno potenzialmente una soglia. Le soglie vengono applicate per impedire a chiunque visualizzi un report di dedurre i dati demografici o gli interessi dei singoli utenti.
Quota token proprietà
I token vengono calcolati con ogni richiesta a seconda della complessità della richiesta da completare. La maggior parte delle richieste addebita un massimo di 10 token. Quando una richiesta consuma un numero elevato di token di quota, i seguenti fattori sono spesso responsabili:
- Numero elevato di righe
- Numero elevato di colonne
- Criteri di filtro complessi
- Intervallo di date lungo
Per ogni richiesta API, puoi specificare "returnPropertyQuota": true
nel
corpo della richiesta per restituire lo stato attuale dei token 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.