Quote

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.