Häufige Fehler

Auf dieser Seite werden die Fehler beschrieben, die am häufigsten von der Google Ad Manager API zurückgegeben werden. Fehler werden im Format Error.REASON zurückgegeben:

Fehler beim Entitätslimit

EntityChildrenLimitReachedError

Zusammenfassung
Die maximale Anzahl zulässiger untergeordneter Elemente für die Entität wurde erreicht und es können keine weiteren untergeordneten Elemente zu ihr hinzugefügt werden.
Empfohlene Vorgehensweise
Erstellen Sie einen neuen Entitätstyp, der die maximal zulässige Anzahl von untergeordneten Entitäten erreicht hat, und fügen Sie der neuen Entität die untergeordnete Entität hinzu, die Sie erstellen möchten. Wenn Sie beispielsweise LINE_ITEM_LIMIT_FOR_ORDER_REACHED erhalten, müssen Sie einen neuen Auftrag erstellen und diesem die Werbebuchung, die Sie erstellen möchten, hinzufügen.

Kontingentfehler

QuotaError.EXCEEDED_QUOTA

Zusammenfassung
Die Anzahl der Anfragen pro Sekunde ist zu hoch und hat das zulässige Limit überschritten.
Empfohlene Vorgehensweise
  • Verwenden Sie Batchmethoden wie updateLineItems, indem Sie Änderungen lokal erfassen und eine einzelne Anfrage stellen, um alle Änderungen auf einmal auszuführen.
  • Warten Sie etwa fünf Sekunden und wiederholen Sie die Anfrage. Dies ist keine Garantie dafür, dass die Anfrage erfolgreich ist. Wenn es noch einmal fehlschlägt, versuchen Sie, die Wartezeit zu erhöhen. Diese Option wird für interaktive Anwendungen empfohlen, die in Ad Manager integriert und in Echtzeit verwendet werden.
  • Beschränken Sie Anfragen auf 2 Anfragen pro Sekunde für Ad Manager-Netzwerke und auf 8 Anfragen pro Sekunde für Ad Manager 360-Netzwerke. Auch dies ist keine Garantie dafür, dass alle Anfragen erfolgreich sind, aber es kann dazu beitragen, die Häufigkeit dieses Fehlers zu reduzieren. Diese Option wird für Anwendungen empfohlen, die in Ad Manager eingebunden sind und keine Echtzeitinteraktionen bieten, beispielsweise die Erstellung nächtlicher Berichte.

Authentifizierungsfehler

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Zusammenfassung
Der Nutzer hat versucht, ein Testnetzwerk mit einem Konto zu erstellen, das bereits mit einem Netzwerk verknüpft ist.
Allgemeine Ursachen
Der Nutzer hat vor dem Aufruf von NetworkService.makeTestNetwork() kein neues Google-Konto erstellt.
Empfohlene Vorgehensweise
Erstellen Sie ein neues Konto, bevor Sie NetworkService.makeTestNetwork() anrufen. Weitere Informationen findest du unter Testnetzwerk erstellen.

AuthenticationError.NETWORK_CODE_REQUIRED

Zusammenfassung
Der Nutzer hat keine networkCode angegeben. Für die Anfrage ist ein Netzwerkcode erforderlich.
Allgemeine Ursachen
Netzwerkcodes sind für alle Anfragen außer NetworkService.getAllNetworks() und NetworkService.makeTestNetwork() erforderlich.
Empfohlene Vorgehensweise
Geben Sie den Netzwerkcode des adressierten Netzwerks im Anfrage-Header an. Verwenden Sie nur einen Netzwerkcode, der für die Anmeldung in Ihrem Konto verfügbar ist. Sie finden den Code auf der Ad Manager-Website Ihres Kontos auf der Seite „Admin“ > „Werbenetzwerkeinstellungen“ neben „Netzwerkcode“. Weitere Informationen zum Festlegen des Netzwerkcodes finden Sie auf der Seite SOAP-XML-Anfrage und -Antwortheader.

AuthenticationError.NETWORK_NOT_FOUND

Zusammenfassung
Die Anfrage konnte nicht gesendet werden, da der in der Konfiguration angegebene Netzwerkcode nicht auf dem Server gefunden wurde.
Allgemeine Ursachen
Sie haben in Ihrer Konfiguration einen falschen Netzwerkcode angegeben.
Empfohlene Vorgehensweise
Das Feld „Trigger“ des Fehlerlogs schlägt dem Nutzer oft das richtige Netzwerk vor.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Zusammenfassung
Der Nutzer ist mit keinem Netzwerk verknüpft.
Allgemeine Ursachen
Sie haben Ihr Produktionskonto nicht für den API-Zugriff aktiviert.
Empfohlene Vorgehensweise
Aktivieren Sie den API-Zugriff auf die Produktionsumgebung. Weitere Informationen finden Sie unter API-Zugriff aktivieren.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Zusammenfassung
Der Kunde ist nicht auf der Zulassungsliste für den API-Zugriff.
Allgemeine Ursachen
Ihr Netzwerk steht nicht auf der Zulassungsliste für die Produktion, aber Sie haben im SOAP-Header einen Netzwerkcode angegeben.
Empfohlene Vorgehensweise
Aktivieren Sie den API-Zugriff.

Berechtigungsfehler

PermissionError.PERMISSION_DENIED

Zusammenfassung
Der Nutzer hat nicht die erforderliche Berechtigung für die Anfrage.
Allgemeine Ursachen
  • Sie haben versucht, auf ein Objekt zuzugreifen, das in einem anderen Netzwerk vorhanden ist.
  • Sie haben versucht, auf ein Objekt in Ihrem Netzwerk zuzugreifen, haben aber keine Berechtigung zum Lesen oder Aktualisieren.
  • Sie haben versucht, eine Aufgabe auszuführen, für die ein zusätzliches Feature in Ihrem Konto aktiviert werden muss.
Empfohlene Vorgehensweise
  • Wenn Sie eine UI erstellen, teilen Sie dem Nutzer mit, dass er nicht berechtigt ist, diese Aktion auszuführen und mit seinem Administrator zu sprechen.
  • Wenn Sie versucht haben, eine Aufgabe auszuführen, z. B. eine Aufgabe, die nur eine Premium-Funktion beinhaltet, für die Ihr Netzwerk keine Berechtigung hat, bitten Sie Ihren Account Manager, diese Funktion zu aktivieren.
  • Testnetzwerke sind standardmäßig keine Ad Manager 360-Netzwerke. Das bedeutet, dass sie nicht die Premiumfunktionen von Ad Manager 360-Netzwerken haben. Wenden Sie sich an Ihren Account Manager, um Funktionen in Ihrem Testnetzwerk zu aktivieren.

Versionsfehler

ApiVersionError.UPDATE_TO_NEWER_VERSION

Zusammenfassung
Die Anwendung hat entweder eine Anfrage initiiert, für die eine neuere Version erforderlich ist, oder eine Anfrage an eine verworfene Version.
Allgemeine Ursachen
  • Die Version des API-Aufrufs wurde eingestellt. Abonnieren Sie unseren Blog, um Ankündigungen zur Einstellung zu erhalten.
  • Die von Ihnen gesendete Anfrage erfordert eine neuere Version der API, um erfolgreich zu sein. Dies ist häufig der Fall, wenn eine Funktion in die Benutzeroberfläche eingeführt wurde. Damit die API das Objekt korrekt senden kann, ist eine neuere Version der API erforderlich.
Empfohlene Vorgehensweise
  • Bleiben Sie bezüglich API-Versionen auf dem neuesten Stand und planen Sie, regelmäßig Upgrades durchzuführen.
  • Abonnieren Sie unseren Blog, um über Einstellungen informiert zu werden.

404 Fehler

Zusammenfassung
Ihre Anfrage ist nicht beim Server angekommen.
Allgemeine Ursachen
Ihre Internetverbindung oder Ihr Proxy ist möglicherweise falsch konfiguriert. Möglicherweise wird auch die API-Version eingestellt, die Sie aufrufen.
Empfohlene Vorgehensweise
Prüfen Sie Ihre Internet- oder Proxykonfiguration und achten Sie darauf, dass Sie eine aktuelle Version der API verwenden. Sie sollten auch Ihre Clientbibliothek auf die neueste Version aktualisieren.
Tipps zur Prävention
Abonnieren Sie das Ad Manager API-Forum und lesen Sie unseren Blog, um aktuelle Informationen zur Ad Manager API zu erhalten.

Fehler beim Unmarshalling

Zusammenfassung
Die SOAP-XML-Datei in Ihrer Anfrage entspricht nicht der WSDL-Spezifikation.
Allgemeine Ursachen
Die Anfrage enthält Felder oder Entitäten, die nicht in der WSDL-Spezifikation enthalten sind oder sich im falschen Namespace befinden.
Es gibt einen nicht übereinstimmenden Typ in der Anfrage (z.B. enthält ein Ganzzahlfeld einen Stringwert).
Empfohlene Vorgehensweise
Ihre Anfrage muss der WSDL-Spezifikation entsprechen.
Generieren Sie gültige SOAP-Codes mit einer Clientbibliothek und vergleichen Sie sie. Alle Clientbibliotheken unterstützen das Logging von SOAP-Anfragen und -Antworten.