Nutzungsbeschränkungen

Nutzungslimits schützen die Google-Infrastruktur vor automatisierten Prozessen, bei denen die Display & Video 360 API auf unangemessene Weise genutzt wird. Sie sorgen dafür, dass sich die Aktionen eines Entwicklers nicht negativ auf die Community auswirken.

Kontingentlimits für API-Anfragen

In der Display & Video 360 API werden zwei Arten von Limits verwendet:

  • Gesamtkontingente, auf die alle relevanten Anfragen angerechnet werden.
  • Kontingentlimits für Schreibvorgänge, auf die alle relevanten Anfragen für Schreibmethoden angerechnet werden. Schreibmethoden sind als Methoden wie create, patch, delete oder bulkEdit definiert, die Ressourcen ändern. Beachten Sie, dass einige Methoden ein höheres Schreibkontingent verbrauchen als andere.

Wenn Ihr Projekt eines dieser Limits überschreitet, kann es zu einer Drosselung kommen.

Projektweites Kontingentlimit

Die folgenden standardmäßigen Kontingentlimits gelten für alle Ressourcen und Methoden der Display & Video 360 API:

  • Anfragen insgesamt pro Minute und Projekt:1500
  • Schreibanfragen pro Minute und Projekt: 700

Kontingentlimits für werbetreibendenspezifische Anfragen

Methoden, die eine Werbetreibenden-ID in der Anfrage-URL angeben, werden auf die zusätzlichen Kontingentlimits "pro Werbetreibendem und Projekt" angerechnet.

Alle Anfragen, bei denen im URL-Pfad eine Werbetreibenden-ID angegeben ist, z. B. an die Dienste advertisers.lineItems, advertisers.creatives oder advertisers.channels, werden auf die folgenden Kontingentlimits angerechnet:

  • Gesamtzahl der Anfragen pro Minute pro Werbetreibendem und Projekt: 300
  • Schreibanfragen pro Minute, Werbetreibendem und Projekt: 150

Schreibintensive Methoden

Die folgenden API-Methoden sind schreibintensiv. Sie verbrauchen also eine erhebliche Menge an Produktressourcen und verbrauchen somit mehr Kontingent für Schreibanfragen als andere Schreibanfragen.

Anfragen an schreibintensive Methoden werden beim Berechnen des Kontingentverbrauchs für Schreibanfragen als 5 Schreibabfragen gezählt. 100 Standardschreibanfragen und 21 schreibintensive Anfragen (keine Angabe eines Werbetreibenden), die innerhalb einer Minute gestellt werden, werden als 205 Schreibabfragen (100 + (21 * 5) = 205) gezählt und überschreiten das bestehende allgemeine Kontingentlimit für Anfragen von 200 Schreibabfragen pro Minute.

Die folgenden Methoden gelten als schreibintensiv:

Kontingentlimits überschritten

In dem unwahrscheinlichen Fall, dass Ihre Anfrage aufgrund einer Überschreitung des Limits für API-Anfragen fehlschlägt, gibt die API einen HTTP-Statuscode und die Ursache für den Fehler zurück. Darüber hinaus enthält der Text der Antwort eine detaillierte Beschreibung der Ursache des Fehlers.

Die folgende Liste enthält mögliche Fehler und empfohlene Maßnahmen für Anfragefehler, die durch Überschreitung der API-Anfragelimits verursacht werden.

Code RPC die Botschaft und Empfohlene Maßnahme
429 RESOURCE_EXHAUSTED Die Ressource ist erschöpft (z.B. Kontingent prüfen). Untersuchen Sie die Nutzung in der Google API Console und passen Sie Ihren Workflow an, um Anfragen unter verschiedenen Werbetreibenden besser zu parallelisieren oder die Senderate allgemein zu verlangsamen.

Für die Display & Video 360 API-Kontingentlimits können keine Erhöhungen angefordert werden.