Ogni richiesta API verifica che le quote non siano state esaurite e consuma le quote. Se una quota è esaurita, la richiesta non riesce 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 ha 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 in tempo reale. Una richiesta non utilizzerà le quote Core e In tempo reale. Di seguito sono riportati i metodi e le categorie dell'API:
| Categoria quota | Metodi dell'API |
|---|---|
| Nucleo | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| In tempo reale | runRealtimeReport |
| Canalizzazione | runFunnelReport |
Quote delle proprietà Analytics
Tutte le richieste consumano quote di proprietà.
| Nome quota | Limite di proprietà standard | Limite delle proprietà di 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 del server principali 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 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 |
| Canalizzazioni richieste in parallelo per proprietà | 10 | 50 |
| Errori del server di 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 quelle precedenti prima di inviare altre richieste.
- Gli errori del server sono codici 500 e 503. Le quote per gli errori del server vengono addebitate solo in caso di errori del server di richiesta. Quando le quote per gli errori del server sono esaurite per una coppia di progetto e proprietà, tutte le richieste alla proprietà provenienti dal progetto 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 a una proprietà deve accedere più di tre 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 con soglia potenziale all'ora. Le dimensioni userAgeBracket, userGender, brandingInterest, audienceId e audienceName hanno una soglia potenziale. 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, questi fattori sono spesso responsabili:
- 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 della quota della proprietà. Questo stato contiene sia la quantità consumata da questa richiesta sia la quantità rimanente per ogni gruppo di quota. Ad esempio, valuta la possibilità di specificare questo parametro in
RunReportRequest.