Kontingente schützen die Google-Infrastruktur vor automatisierten Prozessen, die die Campaign Manager 360 API auf unangemessene Weise verwenden. So wird verhindert, dass die Handlungen eines Entwicklers sich negativ auf die gesamte Community auswirken.
Kontingentlimits
Die folgenden Standardkontingentlimits gelten für alle Campaign Manager 360 API-Ressourcen und ‑Methoden.
- 50.000 Anfragen pro Projekt und Tag – kann erhöht werden.
- 1 Abfrage pro Sekunde pro Projekt
- In der Google API Console wird dieses Kontingent als Abfragen pro Minute pro Nutzer bezeichnet und standardmäßig auf 60 festgelegt. Dieses Limit kann bei Bedarf auf bis zu 600 (10 Abfragen pro Sekunde) erhöht werden.
Für Report Builder gelten zusätzliche Kontingentlimits, die je nach Konto variieren. Weitere Informationen finden Sie in diesem Hilfeartikel und in der Tabelle unten.
Kontingentlimits überschritten
Für den unwahrscheinlichen Fall, dass Ihre Anfrage fehlschlägt, weil ein Kontingent überschritten wird, gibt die API einen HTTP-Statuscode und den Grund für den Fehler zurück. Außerdem enthält der Antworttext eine detaillierte Beschreibung der Ursache des Fehlers. Im Leitfaden Fehlermeldungen finden Sie ein Beispiel für eine Fehlerantwort.
In der folgenden Liste sind die möglichen Fehler und empfohlenen Maßnahmen für Fehler bei Anfragen aufgeführt, die durch das Überschreiten von Kontingentlimits verursacht wurden.
| Code | Grund | Nachricht | Empfohlene Maßnahme |
|---|---|---|---|
| 403 | dailyLimitExceeded | Tageslimit überschritten | Wiederholen Sie den Vorgang nur, wenn das Problem behoben ist. Prüfen Sie Ihre Nutzung in der Google API Console und ändern Sie Ihren Workflow, damit weniger Anfragen gestellt werden. Wenn Sie der Meinung sind, dass Ihre Nutzung angemessen ist, können Sie ein zusätzliches Kontingent anfordern. |
| 403 | quotaExceeded | Für dieses Konto wurde das Kontingent von x Berichten pro Tag überschritten. | Versuchen Sie an diesem Tag nicht, weitere Berichte für dieses Konto zu erstellen. Wenden Sie sich an Ihren Account Manager. |
| 403 | quotaExceeded | Für dieses Nutzerprofil wurde das Kontingent von x Berichten pro Tag überschritten. | Versuchen Sie an diesem Tag nicht, weitere Berichte für dieses Nutzerprofil zu erstellen. Wechseln Sie zu einem anderen Nutzerprofil oder wenden Sie sich an Ihren Account Manager. |
| 403 | quotaExceeded | Für dieses Konto wurde das Kontingent von x aktiven geplanten Berichten überschritten. | Deaktivieren Sie geplante Berichte, die Sie nicht mehr benötigen, bevor Sie diese Anfrage wiederholen. |
| 403 | quotaExceeded | Für das Nutzerprofil, zu dem dieser Bericht gehört, wurde das Kontingent von x aktiven geplanten Berichten überschritten. | Bitten Sie den Inhaber dieses Berichts, geplante Berichte zu deaktivieren, die er nicht benötigt, bevor Sie diese Anfrage noch einmal senden. |
| 403 | quotaExceeded | Für dieses Nutzerprofil wurde das Kontingent von x aktiven geplanten Berichten überschritten. | Deaktivieren Sie geplante Berichte, die Sie nicht mehr benötigen, bevor Sie diese Anfrage wiederholen. |
| 403 | quotaExceeded | Die Aktion kann nicht abgeschlossen werden, da eines Ihrer Kontingente überschritten wurde. Bitte wenden Sie sich an Ihren Account Manager. | Wenden Sie sich an Ihren Account Manager. |
| 403 | userRateLimitExceeded | Nutzerratenlimit überschritten | Erhöhen Sie das Limit pro Nutzer in der Google API Console oder verlangsamen Sie die Rate, mit der Sie Anfragen senden, mithilfe des exponentiellen Backoffs. Es wird nicht empfohlen, mit dieser API gleichzeitige Schreibanfragen zu senden oder eine Ratenbegrenzung von mehr als 10 Anfragen pro Sekunde zu verwenden. |
Zusätzliches Tageskontingent anfordern
Wenn Sie der Meinung sind, dass für Ihre Anwendung ein zusätzliches Tageskontingent erforderlich ist, können Sie wie unten beschrieben vorgehen, um ein solches zu beantragen.
Die folgende Anleitung gilt nur für Projekte, bei denen ein dailyLimitExceeded-Fehler aufgetreten ist. Empfohlene Maßnahmen bei anderen Kontingentfehlern finden Sie in der Tabelle oben.
- Rufen Sie in der Google API Console die Campaign Manager 360 API auf.
- Prüfen Sie Ihre Nutzungsstatistiken auf der Seite Messwerte, um sicherzustellen, dass sich Ihre Anwendung wie erwartet verhält. Achten Sie genau auf die aufgerufenen Methoden und beheben Sie alle unerwarteten oder übermäßigen Nutzungen, bevor Sie fortfahren.
- Wenn die Nutzung normal erscheint, rufen Sie die Seite Kontingente auf, klicken Sie neben Abfragen pro Tag auf das Bearbeitungssymbol und dann auf den Link „Höheres Kontingent beantragen“.
Lesen Sie sich die Informationen durch und folgen Sie der Anleitung im Formular für die Kontingentanfrage, bevor Sie eine Erhöhung beantragen.