All'API Data si applicano i seguenti limiti e quote.
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 principali vengono addebitate alle quote principali. Le richieste API ai metodi in tempo reale comportano l'addebito delle quote in tempo reale. Ogni richiesta utilizza solo un tipo di quota.
Categoria quota | Metodi API |
---|---|
Principale | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
In tempo reale | runRealtimeReport |
Canalizzazione | runFunnelReport |
Quote per le proprietà Analytics
Tutte le richieste consumano le quote della proprietà.
Nome quota | Limite di proprietà standard | Limite di 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 di core per progetto, per proprietà, all'ora | 14.000 | 140.000 |
Richieste in parallelo 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 in tempo reale in parallelo per proprietà | 10 | 50 |
Errori del server in tempo reale per progetto, per proprietà e per ora | 10 | 50 |
Token canalizzazione 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 in parallelo della canalizzazione per proprietà | 10 | 50 |
Errori del server della canalizzazione per progetto, per proprietà e per ora | 10 | 50 |
- Le richieste in parallelo vengono misurate in base al numero di richieste eseguite contemporaneamente. Per ridurre la concorrenza 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 relative agli errori del server sono esaurite per una coppia di progetti e 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 acceduta da più di 3 progetti prima che la quota "Token per proprietà per ora" possa essere esaurita prima della quota "Token per progetto per proprietà per ora".
Le proprietà sono autorizzate a inviare 120 richieste con soglia potenziale all'ora. Le dimensioni userAgeBracket
, userGender
, brandingInterest
, audienceId
e audienceName
sono potenzialmente con 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 calcolati con ogni richiesta, a seconda della complessità della richiesta. La maggior parte delle richieste prevede l'addebito di massimo 10 token. Quando una richiesta consuma un numero elevato di token di quota, spesso la causa è uno dei 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 corrente dei token di quota della proprietà. Questo stato contiene sia la quantità utilizzata da questa richiesta sia la quantità rimanente per ogni gruppo di quota. Ad esempio, puoi specificare questo parametro in
RunReportRequest
.