Häufige Fehler

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

Fehler aufgrund von Entitätslimits

EntityChildrenLimitReachedError

Zusammenfassung
Die maximal zulässige Anzahl von untergeordneten Elementen für die Entität wurde erreicht und es können keine weiteren untergeordneten Elemente hinzugefügt werden.
Empfohlene Vorgehensweise
Erstellen Sie einen neuen Typ der Entität, die die maximal zulässige Anzahl von untergeordneten Elementen erreicht hat, und fügen Sie die untergeordnete Entität, die Sie erstellen möchten, dem neuen Typ hinzu. Wenn Sie beispielsweise LINE_ITEM_LIMIT_FOR_ORDER_REACHED erhalten, müssen Sie einen neuen Auftrag erstellen und die Werbebuchung, die Sie erstellen möchten, diesem neuen Auftrag 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 senden, um alle Änderungen auf einmal zu übernehmen.
  • Warten Sie etwa 5 Sekunden und wiederholen Sie die Anfrage. Dies ist jedoch keine Garantie dafür, dass die Anfrage erfolgreich ist. Wenn der Vorgang wieder fehlschlägt, versuchen Sie, die Wartezeit zu erhöhen. Dies wird für interaktive Anwendungen empfohlen, die in Ad Manager eingebunden sind und in Echtzeit verwendet werden.
  • Beschränken Sie die Anfragen auf 2 pro Sekunde für Ad Manager-Netzwerke oder 8 pro Sekunde für Ad Manager 360-Netzwerke. Auch dies ist keine Garantie dafür, dass jede Anfrage erfolgreich ist, kann aber dazu beitragen, dass dieser Fehler seltener auftritt. Dies wird für Anwendungen empfohlen, die in Ad Manager eingebunden sind und keine Echtzeitinteraktion erfordern, z. B. für die Ausführung von nächtlichen Berichten.

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.
Häufige 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 finden Sie unter Testnetzwerk erstellen.

AuthenticationError.NETWORK_CODE_REQUIRED

Zusammenfassung
Der Nutzer hat keine networkCode angegeben. Für die Anfrage ist ein Netzwerkcode erforderlich.
Häufige Ursachen
Netzwerkcodes sind für alle Anfragen erforderlich, mit Ausnahme von NetworkService.getAllNetworks() und NetworkService.makeTestNetwork().
Empfohlene Vorgehensweise
Fügen Sie den Netzwerkcode des Netzwerks, an das die Anfrage gerichtet ist, in den Anfrageheader ein. Verwenden Sie nur einen Netzwerkcode, der für Ihre Kontoanmeldung verfügbar ist. Sie finden den Code auf der Ad Manager-Website für Ihr Konto auf der Seite „Admin“ > „Einstellungen für Werbenetzwerke“ 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 gestellt werden, da der in der Konfiguration angegebene Netzwerkcode auf dem Server nicht gefunden wurde.
Häufige Ursachen
Sie haben in Ihrer Konfiguration einen falschen Netzwerkcode angegeben.
Empfohlene Vorgehensweise
Im Feld „trigger“ des Fehlerlogs wird oft das richtige Netzwerk für den Nutzer vorgeschlagen.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Zusammenfassung
Der Nutzer ist mit keinem Netzwerk verknüpft.
Häufige Ursachen
Sie haben Ihr Produktionskonto nicht für den API-Zugriff aktiviert.
Empfohlene Vorgehensweise
Aktivieren Sie den API-Zugriff auf Ihre 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.
Häufige Ursachen
Ihr Netzwerk ist nicht für die Produktion auf die Zulassungsliste gesetzt, 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.
Häufige Ursachen
  • Sie haben versucht, auf ein Objekt zuzugreifen, das in einem anderen Netzwerk vorhanden ist.
  • Sie haben versucht, auf ein Objekt zuzugreifen, das in Ihrem Netzwerk vorhanden ist, aber Sie haben keine Berechtigung zum Lesen oder Aktualisieren.
  • Sie haben versucht, eine Aufgabe auszuführen, für die eine zusätzliche Funktion in Ihrem Konto aktiviert sein muss.
Empfohlene Vorgehensweise
  • Wenn Sie eine Benutzeroberfläche erstellen, weisen Sie den Nutzer darauf hin, dass er nicht berechtigt ist, diese Aktion auszuführen, und dass er sich an seinen Administrator wenden soll.
  • Wenn Sie versucht haben, eine Aufgabe auszuführen, für die Ihr Netzwerk keine Berechtigung hat, z. B. eine Aufgabe, die eine Premium-Funktion erfordert, wenden Sie sich an Ihren Account Manager, um diese Funktion aktivieren zu lassen.
  • Testnetzwerke sind standardmäßig keine Ad Manager 360-Netzwerke. Das bedeutet, dass sie nicht die Premium-Funktionen 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 initiiert.
Häufige Ursachen
  • Die Version des API-Aufrufs wurde eingestellt. Abonnieren Sie unseren Blog, um über Einstellungen informiert zu werden.
  • Für die von Ihnen gestellte Anfrage ist eine neuere Version der API erforderlich. Dies ist häufig der Fall, wenn ein Feature in der Benutzeroberfläche eingeführt wurde und die API eine neuere Version der API benötigt, um das Objekt korrekt zu senden.
Empfohlene Vorgehensweise
  • Bleiben Sie bei API-Versionen auf dem neuesten Stand und planen Sie regelmäßige Upgrades ein.
  • Abonnieren Sie unseren Blog, um über Einstellungen informiert zu werden.

404 Fehler

Zusammenfassung
Ihre Anfrage hat den Server nicht erreicht.
Häufige Ursachen
Möglicherweise ist Ihre Internetverbindung oder Ihr Proxy falsch konfiguriert. Die Version der API, die Sie aufrufen, wird möglicherweise auch eingestellt.
Empfohlene Vorgehensweise
Prüfen Sie Ihre Internet- oder Proxykonfiguration und achten Sie darauf, dass Sie eine aktuelle Version der API verwenden. Möglicherweise möchten Sie auch Ihre Clientbibliothek auf die neueste Version aktualisieren.
Tipps zur Vermeidung
Im Ad Manager-Hilfeforum und in unserem Blog finden Sie aktuelle Informationen zur Ad Manager API.

Unmarshalling-Fehler

Zusammenfassung
Das SOAP-XML in Ihrer Anfrage entsprach nicht der WSDL-Spezifikation.
Häufige Ursachen
Die Anfrage enthält Felder oder Entitäten, die nicht in der WSDL-Spezifikation enthalten sind, oder im falschen Namespace.
In der Anfrage liegt ein Typenkonflikt vor (z.B. hat ein Ganzzahlfeld einen Stringwert).
Empfohlene Vorgehensweise
Achten Sie darauf, dass Ihre Anfrage der WSDL-Spezifikation entspricht.
Verwenden Sie eine Clientbibliothek, um gültiges SOAP zu generieren, und verwenden Sie dieses für den Vergleich. Alle Clientbibliotheken unterstützen das Logging von SOAP-Anfragen und -Antworten.