Quote e limiti dell'API di dati

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.

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.