Limiti di utilizzo

I limiti di utilizzo proteggono l'infrastruttura di Google dai processi automatizzati che utilizzano l'API Display & Video 360 in modo inappropriato. Assicurano che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.

Limiti di quota per le richieste API

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

  • Limiti di quota totali in base ai quali vengono conteggiate tutte le richieste pertinenti.
  • Limiti di quota di scrittura, in base ai quali vengono conteggiate tutte le richieste pertinenti effettuate per scrivere metodi. 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 progetto supera uno qualsiasi di questi limiti, potrebbe verificarsi una limitazione.

Limite di quota a livello di progetto

I seguenti limiti di quota predefiniti sono condivisi da tutte le risorse e 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 per le richieste specifiche degli inserzionisti

I metodi che specificano un ID inserzionista nell'URL della richiesta vengono conteggiati ai fini del calcolo dei 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 nei seguenti limiti di quota:

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

Metodi ad alta intensità di scrittura

I seguenti metodi dell'API richiedono un uso intensivo della scrittura, ovvero utilizzano una notevole quantità di risorse di prodotto e, di conseguenza, consumano più quota di richieste di scrittura rispetto ad altre richieste di scrittura.

Le richieste effettuate a metodi ad alta intensità di scrittura vengono conteggiate come 5 query di scrittura quando si calcola il consumo della quota per le richieste di scrittura. Ad esempio, 100 richieste di scrittura standard e 21 richieste di scrittura con uso intensivo della scrittura (nessuna delle quali specifica un inserzionista) effettuate nell'arco di un minuto verrebbero conteggiate come 205 query di scrittura (100 + (21 * 5) = 205) e supererebbero il limite esistente di quota generale di 200 query di scrittura al minuto.

I seguenti metodi sono considerati ad alta intensità di scrittura:

Superamento dei limiti di quota

Nell'improbabile eventualità che la tua richiesta non vada a buon fine a causa del superamento del 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 di ciò che ha causato l'errore.

Il seguente elenco mostra i possibili errori e le azioni consigliate per gli errori delle richieste causati dal superamento dei limiti per le richieste API.

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

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