Limiti di utilizzo

I limiti di utilizzo proteggono l'infrastruttura di Google dai processi automatizzati che utilizzano in modo inappropriato l'API Display & Video 360. Garantiscono che le azioni di un singolo sviluppatore non possano avere un impatto negativo sulla community più grande.

Limiti di quota per le richieste API

L'API Display & Video 360 utilizza due tipi di limiti:

  • Limiti di quota totale, che vengono conteggiati per tutte le richieste pertinenti.
  • Limiti di quota di scrittura, che vengono conteggiati per tutte le richieste pertinenti effettuate per i metodi di scrittura. I metodi di scrittura sono definiti come metodi, ad esempio create, patch, delete o bulkEdit, che modificano le risorse. Tieni presente che alcuni metodi consumano più quota di scrittura rispetto ad altri.

Se il tuo progetto supera uno di questi limiti, potrebbe verificarsi il throttling.

Limite di quota a livello di progetto

I seguenti limiti di quota predefiniti sono condivisi da tutte le risorse e da tutti i metodi dell'API Display & Video 360:

  • Richieste totali al minuto per progetto: 1500
  • Richieste di scrittura al minuto per progetto: 700

Limiti di quota delle richieste specifici per l'inserzionista

I metodi che specificano un ID inserzionista nell'URL della richiesta vengono conteggiati ai fini degli ulteriori limiti di quota "per inserzionista per progetto".

Tutte le richieste con un ID inserzionista specificato nel percorso dell'URL, ad esempio quelle ai servizi advertisers.lineItems, advertisers.creatives o advertisers.channels, verranno conteggiate ai fini dei seguenti limiti di quota:

  • Richieste totali al minuto per inserzionista per progetto: 300
  • Richieste di scrittura al minuto per inserzionista per progetto: 150

Metodi che richiedono un'intensa attività di scrittura

I seguenti metodi API richiedono un'intensa attività di scrittura, il che significa che utilizzano una quantità significativa di risorse del prodotto e, di conseguenza, consumano più quota per le richieste di scrittura rispetto ad altre richieste di scrittura.

Le richieste inviate a metodi con un'elevata intensità di scrittura vengono conteggiate come 5 query di scrittura quando si calcola il consumo della quota delle richieste di scrittura. Ad esempio, 100 richieste di scrittura standard e 21 richieste con un'intensità di scrittura elevata (nessuna delle quali specifica un inserzionista) effettuate in un minuto verrebbero conteggiate come 205 query di scrittura (100 + (21 * 5) = 205) e supererebbero il limite di quota di richieste generali esistente di 200 query di scrittura al minuto.

I seguenti metodi sono considerati con un'intensità di scrittura elevata:

Superamento dei limiti di quota

Nell'improbabile caso in cui la richiesta non vada a buon fine a causa del superamento di un limite di richieste API, l'API restituisce un codice di stato HTTP e il motivo dell'errore. Inoltre, il corpo della risposta contiene una descrizione dettagliata della causa dell'errore.

L'elenco seguente mostra i possibili errori e le azioni consigliate per i fallimenti delle richieste causati dal superamento dei limiti di richieste dell'API.

Codice RPC Messaggio Azione consigliata
429 RESOURCE_EXHAUSTED La risorsa è stata esaurita (ad es. controlla la quota). Esamina il tuo utilizzo da Google API Console e modifica il tuo flusso di lavoro per eseguire meglio in parallelo le richieste effettuate per conto di diversi inserzionisti o, più in generale, per rallentare la frequenza con la quale invii le richieste.

Non è possibile richiedere aumenti per i limiti di quota dell'API Display & Video 360.