Häufige Fehler

Auf dieser Seite werden die häufigsten 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 maximale Anzahl zulässiger untergeordneter Elemente für die Entität wurde erreicht. Der Entität 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 untergeordneter Elemente erreicht hat, und fügen Sie die untergeordnete Entität, die Sie erstellen möchten, der neuen Entität 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 stellen, um diese Änderungen alle auf einmal auszuführen.
  • Warten Sie etwa 5 Sekunden und wiederholen Sie die Anfrage. Das bedeutet jedoch nicht, dass die Anfrage erfolgreich ist. Wenn es wieder fehlschlägt, versuchen Sie, die Wartezeit zu verlängern. Dies wird für interaktive Anwendungen empfohlen, die in Echtzeit mit Ad Manager interagieren.
  • Beschränken Sie Anfragen auf 2 pro Sekunde für Ad Manager-Netzwerke oder 8 pro Sekunde für Ad Manager 360-Netzwerke. Auch wenn dies nicht garantiert, dass jede Anfrage erfolgreich ist, kann es helfen, die Häufigkeit dieses Fehlers zu verringern. Dies wird für Anwendungen empfohlen, die in Ad Manager eingebunden sind und keine Echtzeitinteraktion haben, 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 Anruf von NetworkService.makeTestNetwork() kein neues Google-Konto erstellt.
Empfohlene Vorgehensweise
Erstellen Sie ein neues Konto, bevor Sie NetworkService.makeTestNetwork() aufrufen. 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 mit Ausnahme von NetworkService.getAllNetworks() und NetworkService.makeTestNetwork() erforderlich.
Empfohlene Vorgehensweise
Fügen Sie den Netzwerkcode des angesprochenen Netzwerks 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“ > „Netzwerkeinstellungen“ 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 häufig das richtige Netzwerk für den Nutzer vorgeschlagen.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Zusammenfassung
Der Nutzer ist keinem Netzwerk zugeordnet.
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 verzeichnet.
Häufige Ursachen
Ihr Netzwerk steht nicht auf der Zulassungsliste für die Produktion, aber Sie haben im SOAP-Header einen Netzwerkcode angegeben.
Empfohlene Vorgehensweise
API-Zugriff aktivieren.

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 du versucht hast, eine Aufgabe auszuführen, z. B. eine Aufgabe, die eine Funktion erfordert, die nur für Premium-Nutzer verfügbar ist und für die dein Netzwerk keine Berechtigung hat, wende dich an deinen Account Manager, um diese Funktion zu aktivieren.
  • 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 eingestellte Version gesendet.
Häufige Ursachen
  • Die Version des API-Aufrufs ist veraltet. Abonnieren Sie unseren Blog, um über Einstellungen informiert zu werden.
  • Für die von Ihnen gestellte Anfrage ist eine neuere Version der API erforderlich. Das ist oft der Fall, wenn eine Funktion in der Benutzeroberfläche eingeführt wurde und für die korrekte Übermittlung des Objekts durch die API eine neuere Version der API erforderlich ist.
Empfohlene Vorgehensweise
  • Halten Sie sich über API-Versionen auf dem Laufenden und planen Sie regelmäßige Upgrades ein.
  • Wenn Sie unseren Blog abonnieren, werden Sie über Einstellungen benachrichtigt.

404 Fehler

Zusammenfassung
Ihre Anfrage hat den Server nicht erreicht.
Häufige Ursachen
Ihre Internetverbindung oder Ihr Proxy ist möglicherweise falsch konfiguriert. Möglicherweise wird auch die Version der API, die Sie aufrufen, eingestellt.
Empfohlene Vorgehensweise
Prüfen Sie Ihre Internet- oder Proxykonfiguration und achten Sie darauf, dass Sie eine aktuelle Version der API verwenden. Möglicherweise sollten 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.

Fehler beim Unmarshalling

Zusammenfassung
Das SOAP-XML in Ihrer Anfrage entspricht nicht der WSDL-Spezifikation.
Häufige Ursachen
Die Anfrage enthält Felder oder Entitäten, die nicht in der WSDL-Spezifikation oder im falschen Namespace enthalten sind.
In der Anfrage liegt ein Typkonflikt 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ültigen SOAP-Code zu generieren, und verwenden Sie diesen zum Vergleich. Alle Clientbibliotheken unterstützen die Protokollierung von SOAP-Anfragen und ‑Antworten.