Nutzungsbeschränkungen

Mit Nutzungslimits wird die Google-Infrastruktur vor automatisierten Prozessen geschützt, die die Display & Video 360 API auf unangemessene Weise verwenden. So wird verhindert, dass die Handlungen eines Entwicklers sich negativ auf die gesamte Community auswirken.

Limits für API-Anfragekontingente

Die Display & Video 360 API verwendet zwei Arten von Limits:

  • Gesamtkontingentlimits, auf die alle relevanten Anfragen angerechnet werden.
  • Schreibkontingentlimits, die auf alle relevanten Schreibanfragen für Schreibmethoden angerechnet werden. Schreibmethoden sind Methoden wie create, patch, delete oder bulkEdit, mit denen Ressourcen geändert werden. Beachten Sie, dass einige Methoden mehr Schreibkontingent verbrauchen als andere.

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

Projektweites Kontingentlimit

Die folgenden Standardkontingentlimits gelten für alle Display & Video 360 API-Ressourcen und ‑Methoden:

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

Werbetreibendenspezifische Kontingentlimits für Anfragen

Bei Methoden, bei denen in der Anfrage-URL eine Werbetreibenden-ID angegeben ist, werden zusätzliche Kontingentlimits pro Werbetreibenden und pro Projekt berücksichtigt.

Alle Anfragen mit einer im URL-Pfad angegebenen Werbetreibenden-ID, z. B. Anfragen an die Dienste advertisers.lineItems, advertisers.creatives oder advertisers.channels, werden auf die folgenden Kontingentlimits angerechnet:

  • Anfragen insgesamt pro Minute und Werbetreibenden und Projekt:300
  • Schreibanfragen pro Minute und Werbetreibenden und Projekt:150

Schreibintensive Methoden

Die folgenden API-Methoden sind schreibintensiv, d. h., sie verbrauchen eine erhebliche Menge an Produktressourcen und belegen daher mehr Kontingent für Schreibanfragen als andere Schreibanfragen.

Anfragen an schreibintensive Methoden werden bei der Berechnung des Kontingentverbrauchs für Schreibanfragen als 5 Schreibabfragen gezählt. Wenn beispielsweise innerhalb einer Minute 100 Standardschreibanfragen und 21 schreibintensive Anfragen (für die kein Werbetreibender angegeben ist) gesendet werden, werden diese als 205 Schreibanfragen (100 + (21 * 5) = 205) gezählt und das bestehende allgemeine Kontingentlimit von 200 Schreibanfragen pro Minute wird überschritten.

Die folgenden Methoden gelten als schreibintensiv:

Kontingentlimits überschritten

Für den unwahrscheinlichen Fall, dass Ihre Anfrage fehlschlägt, weil das Limit für API-Anfragen überschritten wurde, gibt die API einen HTTP-Statuscode und den Grund für den Fehler zurück. Außerdem enthält der Antworttext eine ausführliche Beschreibung der Ursache des Fehlers.

In der folgenden Liste sind die möglichen Fehler und empfohlenen Maßnahmen für Fehler bei Anfragen aufgeführt, die durch das Überschreiten der Limits für API-Anfragen verursacht wurden.

Code RPC Nachricht Empfohlene Maßnahme
429 RESOURCE_EXHAUSTED Die Ressource ist erschöpft (z.B. Kontingent prüfen). Prüfen Sie Ihre Nutzung in der Google API Console und ändern Sie Ihren Workflow, um Anfragen von verschiedenen Werbetreibenden besser zu parallelisieren oder die Rate, mit der Sie Anfragen senden, allgemein zu verlangsamen.

Eine Erhöhung des Kontingents für die Display & Video 360 API ist nicht möglich.