Quote

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.