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 uno sviluppatore non possano influire negativamente sulla community più ampia.
Limiti di quota
I seguenti limiti di quota predefiniti sono condivisi da tutte le risorse e i metodi dell'API Campaign Manager 360.
- 50.000 richieste per progetto al giorno,aumentabili.
- 1 query al secondo (QPS) per progetto.
- Nella console API di Google questa quota è denominata Query al 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 riportata di seguito.
Superamento dei limiti di quota
Nell'improbabile eventualità che 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. Consulta la guida Messaggi di errore per un esempio di risposta di errore.
Il seguente elenco mostra i possibili errori e le azioni consigliate per gli errori di richiesta 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 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 generare 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 che non ti servono prima di riprovare a inviare 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 questa richiesta. |
| 403 | quotaExceeded | Questo profilo utente ha superato la quota di x report pianificati attivi. | Disattiva i report pianificati che non ti servono prima di riprovare a inviare 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 per utente superato | Aumenta il limite per utente nella console API di Google o rallenta la velocità con cui invii le 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 seguenti istruzioni si applicano solo ai progetti che hanno riscontrato un errore dailyLimitExceeded. Le azioni consigliate per altri errori relativi alla quota sono
descritte nella tabella riportata sopra.
- Vai all'API Campaign Manager 360 nella console API di Google.
- Controlla le statistiche di utilizzo nella pagina Metriche per assicurarti che la tua applicazione si comporti come previsto. Presta particolare attenzione ai metodi che sono stati chiamati e risolvi qualsiasi utilizzo imprevisto o eccessivo prima di procedere.
- Se l'utilizzo sembra normale, vai alla pagina Quote, fai clic sull'icona di modifica accanto a Query al giorno e fai clic sul link "Richiedi una quota più alta".
Prima di inviare una richiesta di aumento, assicurati di esaminare le informazioni e seguire le istruzioni riportate nel modulo di richiesta di quota.