Kontingente schützen die Google-Infrastruktur vor automatisierten Prozessen, die die Campaign Manager 360 API auf unangemessene Weise verwenden. Sie sorgen dafür, dass die Aktionen eines Entwicklers keine negativen Auswirkungen auf die größere Community haben.
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 ist standardmäßig auf 60 festgelegt. Dieses Limit kann nach Bedarf auf maximal 600 (10 Abfragen pro Sekunde) erhöht werden.
Im Berichterstellungs-Tool gelten zusätzliche Kontingentlimits, die je nach Konto variieren. Weitere Informationen finden Sie in diesem Hilfeartikel und in der Tabelle unten.
Kontingentlimits überschreiten
In dem unwahrscheinlichen Fall, dass Ihre Anfrage aufgrund einer Überschreitung des Kontingentlimits fehlschlägt, gibt die API einen HTTP-Statuscode und einen Grund für den Fehler zurück. Außerdem enthält der Antworttext eine detaillierte Beschreibung der Ursache des Fehlers. Ein Beispiel für eine Fehlerantwort finden Sie im Leitfaden zu Fehlermeldungen.
In der folgenden Liste sind die möglichen Fehler und empfohlenen Maßnahmen für Anfragenfehler aufgeführt, die durch eine Überschreitung des Kontingentlimits verursacht werden.
| Code | Grund | Nachricht | Empfohlene Maßnahme |
|---|---|---|---|
| 403 | dailyLimitExceeded | Tageslimit überschritten | Wiederholen Sie den Vorgang nur, wenn das Problem behoben ist. Prüfen Sie die Nutzung in der Google API Console und ändern Sie Ihren Workflow, um weniger Anfragen zu stellen. 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 auszuführen. 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 auszuführen. 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 benötigen, bevor Sie diese Anfrage wiederholen. |
| 403 | quotaExceeded | Für das Nutzerprofil, 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 wiederholen. |
| 403 | quotaExceeded | Für dieses Nutzerprofil wurde das Kontingent von „x“ aktiven geplanten Berichten überschritten. | Deaktivieren Sie geplante Berichte, die Sie nicht benötigen, bevor Sie diese Anfrage wiederholen. |
| 403 | quotaExceeded | Die Aktion kann nicht abgeschlossen werden, da eines Ihrer Kontingente überschritten wurde. Wenden Sie sich an Ihren Account Manager. | Wenden Sie sich an Ihren Account Manager. |
| 403 | userRateLimitExceeded | Ratenlimit für Nutzer überschritten | Erhöhen Sie das Limit pro Nutzer in der Google API Console oder verlangsamen Sie die Rate, mit der Sie Anfragen senden, indem Sie den exponentiellen Backoff verwenden. Es wird nicht empfohlen, gleichzeitige Schreibanfragen zu stellen oder mit dieser API ein Ratenlimit von mehr als 10 Abfragen pro Sekunde zu verwenden. |
Zusätzliches Tageskontingent anfordern
Wenn Sie der Meinung sind, dass Ihre Anwendung ein zusätzliches Tageskontingent benötigt, können Sie mehr anfordern. Folgen Sie dazu der Anleitung unten.
Die folgende Anleitung gilt nur für Projekte, bei denen der Fehler
dailyLimitExceeded aufgetreten ist. Empfohlene Maßnahmen für andere Kontingentfehler sind
in der Tabelle obenaufgeführt.
- Rufen Sie die Campaign Manager 360 API in der Google API Console auf.
- Prüfen Sie auf der Seite Messwerte die Nutzungsstatistiken, 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 aussieht, rufen Sie die Seite Kontingente auf, klicken Sie neben Abfragen pro Tag auf das Symbol „Bearbeiten“ und dann auf den Link „Höheres Kontingent beantragen“.
Lesen Sie die Informationen im Kontingentanfrageformular und folgen Sie der Anleitung, bevor Sie eine Erhöhung beantragen.