Quota

La quota dell'API Display & Video 360 limita la velocità con cui un progetto può effettuare richieste all'API.

Segui queste best practice per utilizzare al meglio la quota dell'API Display & Video 360.

Effettuare richieste per più inserzionisti contemporaneamente

La quota dell'API Display & Video 360 è impostata per progetto e per inserzionista. I limiti di quota del progetto limitano le richieste effettuate da un progetto. La quota dell'inserzionista limita le richieste effettuate da un progetto a un inserzionista.

Per utilizzare tutta la quota del progetto, effettua richieste per più inserzionisti contemporaneamente.

Utilizzare i parametri di query list

Utilizza i parametri di query del metodo list per includere solo le risorse che ti interessano. Meno risorse richiedono meno richieste per l'elenco.

I metodi list offrono tre parametri chiave:

  • pageSize imposta il numero di risorse che possono essere restituite dalla richiesta. Le dimensioni della pagina predefinite dipendono dal metodo. Imposta questo valore sul valore più alto per elencare più risorse per richiesta.
  • filter limita le risorse elencate in base ai criteri forniti. Imposta questo valore su per elencare solo un sottoinsieme di risorse. Per saperne di più, consulta Richieste di filtri per gli elenchi.
  • orderBy ordina le risorse elencate in base alla proprietà specificata. Imposta questo valore per recuperare il limite superiore o inferiore dell'elenco delle risorse con meno richieste.

Utilizzare funzioni collettive e a livello di risorsa

Le funzioni collettive e a livello di risorsa eseguono attività complesse. Una singola richiesta a questi metodi può sostituire più richieste ad altri.

Per saperne di più su questi metodi, consulta la sezione Richieste collettive.

ID cache

Molte azioni dell'API Display & Video 360 richiedono ID recuperati utilizzando l'API. Alcuni esempi includono ID opzione di targeting e ID segmento di pubblico Google. Memorizza gli ID localmente in modo da non doverli recuperare continuamente.

L'utilizzo di ID per risorse ritirate o eliminate può restituire un errore. Devi recuperare gli ID memorizzati nella cache settimanalmente per confermarne lo stato.

Utilizza il backoff esponenziale

Il backoff esponenziale è una strategia di gestione degli errori. Ritenta le richieste per un periodo di tempo sempre più lungo.

Durante il polling di un'attività a esecuzione prolungata, ad esempio un'attività di download SDF, una strategia di backoff esponenziale può ridurre il numero di richieste inviate.

I nostri esempi di codice per il download di SDF utilizzano il backoff esponenziale con le nostre librerie client. Di seguito è riportato un esempio di flusso di backoff esponenziale:

  • Recupera l'oggetto Operation con la richiesta get.
    • Se done non è vero, l'attività è ancora in esecuzione.
    • Attendi 5 secondi più un numero casuale di secondi, poi riprova.
  • Recupera l'operazione.
    • Se done non è vero, l'attività è ancora in esecuzione.
    • Attendi 10 secondi più un numero casuale di secondi, poi riprova.
  • Recupera l'operazione.
    • Se done non è vero, l'attività è ancora in esecuzione.
    • Attendi 20 secondi più un numero casuale di secondi, poi riprova.
  • Recupera l'operazione.
    • Se done non è vero, l'attività è ancora in esecuzione.
    • Attendi 40 secondi più un numero casuale di secondi, poi riprova.
  • Recupera l'operazione.
    • Se done non è vero, l'attività è ancora in esecuzione.
    • Attendi 80 secondi più un numero casuale di secondi, poi riprova.
  • Continua questo schema finché done non è vero o non è trascorso un tempo massimo.