Le quote proteggono l'infrastruttura di Google dai processi automatizzati che utilizzano l'API Campaign Manager 360 in modo inappropriato. Garantiscono che le azioni di un singolo sviluppatore non possano avere un impatto negativo sulla community più ampia.
Limiti di quota
I seguenti limiti di quota predefiniti sono condivisi da tutte le risorse e da tutti i metodi dell'API Campaign Manager 360.
- 50.000 richieste per progetto al giorno. Questo valore può essere aumentato.
- 1 query al secondo (QPS) per progetto.
- Nella console API di Google questa quota è indicata come Query per minuto per utente ed è impostata su 60 per impostazione predefinita. Questo limite può essere aumentato in base alle esigenze, fino a un massimo di 600 (10 QPS).
Report Builder applica limiti di quota aggiuntivi che variano in base all'account. Per saperne di più, consulta questo articolo del Centro assistenza e la tabella di seguito.
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 quota, 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. Per un esempio di risposta di errore, consulta la guida Messaggi di errore.
Il seguente elenco mostra i possibili errori e le azioni consigliate per i fallimenti delle richieste causati dal superamento dei limiti di quota.
| Codice | Motivo | Messaggio | Azione consigliata |
|---|---|---|---|
| 403 | dailyLimitExceeded | Limite giornaliero superato | Non riprovare senza risolvere il problema. Esamina il tuo utilizzo dalla console API di Google e modifica il tuo flusso di lavoro per effettuare meno richieste. Se ritieni che il tuo utilizzo sia ragionevole, puoi richiedere una quota aggiuntiva. |
| 403 | quotaExceeded | Questo account ha superato la quota di x report al giorno. | Non tentare di eseguire altri report per questo account in questo giorno. Contatta il tuo account manager per ricevere assistenza. |
| 403 | quotaExceeded | Questo profilo utente ha superato la quota di x report al giorno. | Non tentare di eseguire altri report per questo profilo utente in questo giorno. Passa a un altro profilo utente o contatta il tuo account manager per ricevere assistenza. |
| 403 | quotaExceeded | Questo account ha superato la quota di x report pianificati attivi. | Disattiva i report pianificati di cui non hai bisogno prima di riprovare a effettuare questa richiesta. |
| 403 | quotaExceeded | Il profilo utente proprietario di questo report ha superato la quota di x report pianificati attivi. | Chiedi al proprietario di questo report di disattivare i report pianificati di cui non ha bisogno prima di riprovare a inviare la richiesta. |
| 403 | quotaExceeded | Questo profilo utente ha superato la quota di x report pianificati attivi. | Disattiva i report pianificati di cui non hai bisogno prima di riprovare a effettuare questa richiesta. |
| 403 | quotaExceeded | Impossibile completare l'azione perché una delle tue quote è stata superata. Per assistenza, contatta il tuo account manager. | Contatta il tuo account manager per ricevere assistenza. |
| 403 | userRateLimitExceeded | Limite di frequenza utenti superato | Aumenta il limite per utente nella console API di Google o rallenta la frequenza di invio delle richieste utilizzando il backoff esponenziale. Non è consigliabile effettuare richieste di scrittura simultanee o utilizzare un limite di frequenza superiore a 10 QPS con questa API. |
Richiesta di quota giornaliera aggiuntiva
Se ritieni che la tua applicazione richieda una quota giornaliera aggiuntiva, puoi richiederne di più seguendo le istruzioni riportate di seguito.
Le istruzioni riportate di seguito si applicano solo ai progetti che hanno riscontrato un
dailyLimitExceeded errore. Le azioni consigliate per altri errori relativi alle quote sono riportate nella tabella sopra.
- Vai all'API Campaign Manager 360 nella console API di Google.
- Esamina le statistiche di utilizzo dalla pagina Metriche per assicurarti che la tua applicazione funzioni come previsto. Presta molta attenzione ai metodi che sono stati chiamati e risolvi eventuali utilizzi imprevisti o eccessivi prima di procedere.
- Se l'utilizzo sembra normale, vai alla pagina Quote, fai clic sull'icona di modifica accanto a Query al giorno e poi sul link "Richiedi una quota più alta".
Prima di inviare una richiesta di aumento, assicurati di esaminare le informazioni e di seguire le istruzioni incluse nel modulo di richiesta della quota.