Kontingente schützen die Infrastruktur von Google vor automatisierten Prozessen, die die Campaign Manager 360 API auf unangemessene Weise verwenden. Sie sorgen dafür, dass die Aktionen eines Entwicklers nicht die gesamte Community beeinträchtigen.
Kontingentlimits
Die folgenden standardmäßigen Kontingentlimits gelten für alle Ressourcen und Methoden der Campaign Manager 360 API.
- 50.000 Anfragen pro Projekt und Tag – kann erhöht werden.
- 1 Abfrage pro Sekunde (Abfragen 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 eingestellt. Dieses Limit kann bei Bedarf auf bis zu 600 (10 Abfragen pro Sekunde) erhöht werden.
In Report Builder gelten zusätzliche Kontingentlimits, die je nach Konto variieren. Weitere Informationen finden Sie in diesem Hilfeartikel und in der Tabelle unten.
Kontingentlimits überschreiten
Falls Ihre Anfrage aufgrund einer Kontingentüberschreitung fehlschlägt, gibt die API einen HTTP-Statuscode und den Grund für den Fehler zurück. Außerdem enthält der Text der Antwort eine detaillierte Beschreibung der Ursache des Fehlers. Ein Beispiel für eine Fehlerantwort finden Sie im Leitfaden Fehlermeldungen.
Die folgende Liste enthält die potenziellen Fehler und empfohlenen Maßnahmen bei Anfragefehlern, die durch das Überschreiten des Kontingentlimits entstehen.
| Code | Grund | die Botschaft und | Empfohlene Maßnahme |
|---|---|---|---|
| 403 | Tageslimit überschritten | Tageslimit überschritten | Wiederholen Sie den Vorgang nur, wenn das Problem behoben ist. Prüfen Sie die Nutzung über die Google API Console und ändern Sie den Workflow, um die Zahl der Anfragen zu verringern. Sie können zusätzliche Kontingente anfordern, wenn Sie der Meinung sind, dass Ihre Nutzung sinnvoll ist. |
| 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. Bitten Sie Ihren Account Manager um Unterstützung. |
| 403 | quotaExceeded | Für dieses Nutzerprofil wurde das Kontingent von x Berichten pro Tag überschritten. | Versuchen Sie, an diesem Tag keine weiteren 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 benötigen, bevor Sie die Anfrage noch einmal ausführen. |
| 403 | quotaExceeded | Für das Nutzerprofil dieses Berichts 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 er diese Anfrage noch einmal sendet. |
| 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 die Anfrage noch einmal ausführen. |
| 403 | quotaExceeded | Diese Aktion kann nicht abgeschlossen werden, da eines Ihrer Kontingente überschritten wurde. Wenden Sie sich an Ihren Account Manager. | Bitten Sie Ihren Account Manager um Unterstützung. |
| 403 | NutzerrateLimitÜberschritten | Nutzerlimit überschritten | Erhöhen Sie das Limit pro Nutzer in der Google API Console oder verringern Sie die Geschwindigkeit, mit der Sie Anfragen über den exponentiellen Backoff senden. Es wird nicht empfohlen, gleichzeitige Schreibanfragen zu senden oder eine Ratenbegrenzung von mehr als 10 Abfragen pro Sekunde anzuwenden. |
Zusätzliches Tageskontingent anfordern
Wenn Sie der Meinung sind, dass Ihre Anwendung ein zusätzliches Tageskontingent erfordert, können Sie wie unten beschrieben zusätzliche anfordern.
Die folgende Anleitung gilt nur für Projekte, bei denen der Fehler dailyLimitExceeded aufgetreten ist. Die empfohlenen Maßnahmen für andere Kontingentfehler werden in der Tabelle oben behandelt.
- Rufen Sie in der Google API Console die Campaign Manager 360 API auf.
- Überprüfen Sie auf der Seite Messwerte Ihre Nutzungsstatistiken, um sicherzustellen, dass Ihre Anwendung wie erwartet funktioniert. Prüfen Sie die aufgerufenen Methoden genau und beheben Sie unerwartete oder übermäßige Nutzung, bevor Sie fortfahren.
- Wenn die Nutzung normal erscheint, rufen Sie die Seite Kontingente auf, klicken Sie auf das Bearbeitungssymbol neben Abfragen pro Tag und dann auf den Link „Höheres Kontingent beantragen“.
Lesen Sie die Informationen und folgen Sie der Anleitung im Formular für das Kontingent, bevor Sie einen Erhöhungsantrag einreichen.