Fehlermeldungen und Warnungen

Auf dieser Seite werden die verschiedenen Fehler- und Warnmeldungen beschrieben, die Sie die Sie beim Verwenden der Display- und Video 360 API

API-Fehler

Bei Anfragen an die API, die nicht abgeschlossen werden können, wird eine Fehlermeldung zurückgegeben. Anfragen, die Fehler zurückgeben, werden auf das Nutzerkontingent angerechnet und in bei der Überprüfung von Anträgen auf Kontingenterhöhungen. Fehlerantworten verarbeitet und verarbeitet werden, um zukünftige Fehler zu vermeiden.

Eine Fehlerantwort hat das folgende Format und enthält einen HTTP-Antwortcode: eine Fehlermeldung und den Status Google RPC-Code:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Nachfolgend finden Sie eine Liste der häufigsten API-Fehler zusammen mit den empfohlenen Maßnahmen. wenn sie zurückgegeben werden:

Code RPC Empfohlene Maßnahme
400 INVALID_ARGUMENT Es gibt ein Problem mit Ihrer Anfrage. Lesen Sie die in der Fehlerantwort und ändern Sie entsprechend ändern.
401 UNAUTHENTICATED Ihre Anfrage konnte nicht ordnungsgemäß authentifiziert werden. Achten Sie darauf, dass Sie gültiges OAuth verwenden. Anmeldedaten verwenden. Weitere Informationen finden Sie in unserem Startleitfaden.
403 PERMISSION_DENIED Sie haben nicht die erforderlichen Berechtigungen Ihre Anfrage. Prüfen Sie, ob Ihr Nutzerkonto die entsprechenden Berechtigungen für den entsprechenden Partner oder Werbetreibenden.
404 NOT_FOUND Die Ressource, die Sie abrufen möchten, kann nicht gefunden werden können. Prüfen Sie, ob die von Ihnen verwendete ID korrekt und für den abgerufenen Ressourcentyp.
409 ABORTED Die Ressource, die Sie ändern möchten, wird gerade die an anderer Stelle geändert wurden. Warten Sie einige Sekunden und Wiederholen Sie die Anfrage.
429 RESOURCE_EXHAUSTED Sie haben Ihr ein Ratenlimit oder ein tägliches Anfragekontingent. Untersuchen Sie Ihre API-Nutzung mithilfe des Google API Console und ändern Sie die Workflow zur Ausführung mit dem vorhandenen Kontingent Beschränkungen. Weitere Informationen findest du auf unserer Seite zur Kontingentoptimierung

Wenn Ihre Vorgänge nicht innerhalb Ihres können Sie aufgrund des Tageskontingents zusätzliche Kontingente anfordern

500 INTERNAL Bei der API ist ein interner Fehler aufgetreten. Warte ein paar Minuten Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler dauerhaft, wenden Sie sich bitte an den Support.
504 DEADLINE_EXCEEDED Die API-Ausführung der Anfrage hat zu lange gedauert. Warten Sie einige Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin besteht, wenden Sie sich bitte an den Support.

Fehler in strukturierten Datendateien

Die Display- und Für die Video 360 API wird eine asynchrone Methode Strukturierte Datendateien (Structured Data Files, SDFs) generieren und herunterladen. In diesem Fall Grund: Fehler, die während der Erstellung der SDF gemeldet werden, werden in der abgeschlossenen Datei zurückgegeben. herunterladen. Ein Aufgabe zum Herunterladen einer strukturierten Datendatei, der in error abgeschlossen wird, ist als erledigt markiert, enthält aber anstelle des Namens einer Medienressource ein ausgefülltes Fehlerfeld in das Feld response ein, wie in diesem abgeschnittenen Beispiel gezeigt:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Wenn Sie beim Versuch, strukturierte Datendateien zu erstellen, eine Fehlermeldung mit umsetzbaren Informationen erhalten, können Sie sich entsprechend anpassen sollte. Lässt sich die Fehlermeldung nicht eindeutig beheben, empfehlen folgende Maßnahmen:

  • Überprüfen Sie, ob Ihr Nutzer die erforderlichen Berechtigungen für den übergeordneten Partner- oder Werbetreibenden-Ressourcen.
  • Prüfen Sie, ob die im Filter angegebenen IDs korrekt sind. dem vorgesehenen Ressourcentyp entsprechen und im Kontext des mit einer Root-ID.
  • Das Limit von 20 SDF-Downloads darf nicht überschritten werden Aufgaben pro Nutzer.

Sollten weiterhin Fehler auftreten, wenden Sie sich bitte an den Support, zu Ihrem Problem.

Nicht blockierende Warnungen

Nicht blockierende Warnungen werden Werbebuchungen zugewiesen, die sich auf die Auslieferung einer Werbebuchung auswirken kann. Ähnliche Warnungen werden übermittelt. auf der Benutzeroberfläche über ein Benachrichtigungsbanner. Diese Warnungen sind passiv und im Feld warningMessages einer Werbebuchung aufgeführt.

Diese Warnungen sind zwar passiv, Probleme, die diese Warnungen verursachen, können jedoch die Bereitstellung eines gänzlich verhindert wird.

Prävention

Viele Probleme, die zu nicht blockierenden Warnungen führen, lassen sich durch die Konfiguration der Werbebuchungseinstellungen, einschließlich der folgenden:

  • Flight: Wenn die Laufzeit einer Werbebuchung ungültig ist oder Laufzeit des übergeordneten Anzeigenauftrags abgelaufen ist, generiert die Werbebuchung Warnung und wird nicht ausgeliefert. Um das zweite Problem zu vermeiden, achten Sie darauf, dass eine Zeile Die Laufzeit des Elements endet nicht später als die Laufzeit der übergeordneten Einfügung. Reihenfolge.
  • Zugewiesene Creatives: wenn kein gültiges Creative vorhanden ist die einer Werbebuchung zugewiesen ist, erzeugt sie eine Warnung und bereitstellen.
  • Targeting: Wenn das Targeting einer Werbebuchung wird eine Warnung ausgegeben und die Auslieferung wird beeinträchtigt oder ganz verhindert werden.

Wenn Sie Konfigurationen aus einer vorhandenen Werbebuchung replizieren, die vorhandene Werbebuchung keine unerwarteten Warnungen generiert.

Monitoring

Probleme, die nicht blockierende Warnungen verursachen, können auftreten, Flug. Um sicherzustellen, dass Ihre Werbebuchungen korrekt ausgeliefert werden, aktiven Werbebuchungen für neu generierte Warnungen. Werbebuchungen können abgerufen werden mit der Funktion advertisers.lineItems.list im Bulk-Verfahren. Wenn wenn eine Werbebuchung eine unerwartete Warnung generiert, sollten Sie das Problem beheben um die Auswirkungen auf die Auslieferung zu reduzieren.

Probleme können auch auftreten, wenn sich die Einstellungen oder das Targeting einer Werbebuchung nicht geändert haben. Beispiele hierfür sind das Pausieren oder Ablaufdatum des übergeordneten Anzeigenauftrags und der Einstellung von Nutzerlisten und anderen Targeting-Optionen.