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.