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 possono 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: possono essere aumentate.
- 1 query al secondo (QPS) per progetto.
- Nella console API di Google, questa quota è nota come 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 caso che la tua 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.
Nel seguente elenco vengono mostrati i possibili errori e le azioni consigliate per gli errori delle richieste causati dal superamento dei limiti di quota.
| Codice | Motivo | Messaggio | Azione consigliata |
|---|---|---|---|
| 403 | giornoLimitesuperato | 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 | quotaSuperata | Questo account ha superato la quota di x report al giorno. | In questo giorno non tentare di eseguire altri report per questo account. Contatta il tuo account manager per avere supporto. |
| 403 | quotaSuperata | Questo profilo utente ha superato la quota di x report al giorno. | In questo giorno non tentare di eseguire altri report per questo profilo utente. Passa a un altro profilo utente o contatta il tuo account manager per avere supporto. |
| 403 | quotaSuperata | Questo account ha superato la quota di x report pianificati attivi. | Disattiva i report pianificati che non ti servono prima di riprovare questa richiesta. |
| 403 | quotaSuperata | 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 non necessari prima di riprovare questa richiesta. |
| 403 | quotaSuperata | Questo profilo utente ha superato la quota di x report pianificati attivi. | Disattiva i report pianificati che non ti servono prima di riprovare questa richiesta. |
| 403 | quotaSuperata | Impossibile completare questa azione perché una delle tue quote è stata superata. Per ricevere assistenza, contatta il tuo account manager. | Contatta il tuo account manager per avere supporto. |
| 403 | Limite di utenti superato | Limite di frequenza utente superato | Aumenta il limite per utente nella console API di Google o rallenta la velocità con cui invii 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. |
Richiedere una quota giornaliera aggiuntiva
Se ritieni che la tua applicazione richieda una quota giornaliera aggiuntiva, puoi richiederne altre 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 di quota sono indicate nella tabella riportata sopra.
- Vai all'API Campaign Manager 360 nella console API di Google.
- Esamina le statistiche sull'utilizzo nella pagina Metriche per assicurarti che l'applicazione funzioni come previsto. Presta 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".
Assicurati di leggere le informazioni e segui le istruzioni incluse nel modulo di richiesta di quota prima di inviare una richiesta di aumento.