Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite finden Sie häufige Fehler sowie Tipps, wie Sie diese vermeiden und beheben.
Eine vollständige Liste der Fehler finden Sie in den Fehlerreferenzen. Weitere Unterstützung erhalten Sie in unserem Forum.
google.auth.exceptions.RefreshError
invalid_grant
Zusammenfassung
Das Token ist abgelaufen oder wurde widerrufen.
Allgemeine Ursachen
Für ein Google Cloud Platform-Projekt mit einem für einen externen Nutzertyp konfigurierten OAuth-Zustimmungsbildschirm und dem Veröffentlichungsstatus Testing wird ein Aktualisierungstoken ausgegeben, das in 7 Tagen abläuft.
Vorgehensweise
Der Veröffentlichungsstatus Ihres Google-Projekts lautet Testing. Das Aktualisierungstoken läuft daher alle 7 Tage ab und erhält den Fehler invalid_grant. Gehen Sie zur Google API Console und rufen Sie den OAuth-Zustimmungsbildschirm auf. Ändere dann den Veröffentlichungsstatus zu „In production“. Folge dazu dieser Anleitung, um zu verhindern, dass das Aktualisierungstoken nach 7 Tagen abläuft.
Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden.
Allgemeine Ursachen
Sie versuchen, andere Attribute als status der Anzeige zu ändern.
Vorgehensweise
–
Tipps zur Prävention
Nachdem eine Anzeige erstellt wurde, kann sie nicht mehr geändert werden. Wenn Sie Änderungen vornehmen möchten, müssen Sie eine neue Anzeige erstellen und die alte Anzeige entfernen. Der status der Anzeige kann jedoch mithilfe von MutateAdGroupAds geändert werden.
INVALID_INPUT
Zusammenfassung
Eines der Felder in einer Anzeige enthält ungültige Zeichen.
Allgemeine Ursachen
Verwendung von Sonderzeichen in URLs
Vorgehensweise
–
Tipps zur Prävention
Prüfen Sie die URLs in Ihrer Anwendung, bevor Sie die API-Anfrage stellen.
Eine Anzeigengruppe wird hinzugefügt oder umbenannt, aber der Name wird bereits für eine andere Anzeigengruppe verwendet.
Allgemeine Ursachen
Erstellen einer neuen Anzeigengruppe mit dem Namen einer vorhandenen aktiven oder pausierten Anzeigengruppe
Vorgehensweise
Protokollieren Sie den Fehler und senden Sie eine Fehlermeldung an den Nutzer. Schlagen Sie dabei entweder einen eindeutigen Anzeigengruppennamen vor oder zeigen Sie die Liste der verwendeten Namen an.
Zwei Vorgänge in einer einzelnen Anforderung enthalten einen Erstellungsvorgang für ein Asset mit denselben Binärdaten.
Allgemeine Ursachen
Eine „mutate“-Anfrage mit duplizierten Erstellungsvorgängen, die dieselben Binärdaten enthalten
Vorgehensweise
Erstellen Sie das Asset in einer separaten Anfrage und verknüpfen Sie es in der nachfolgenden Anfrage oder verwenden Sie in derselben Anfrage eine temporäre ID.
Die Kundennummer wurde im HTTP-Header nicht angegeben.
Allgemeine Ursachen
Im HTTP-Header wurde keine Client-Kundennummer angegeben.
Vorgehensweise
–
Tipps zur Prävention
Die Client-Kundennummer muss bei allen Aufrufen angegeben werden. Achten Sie daher darauf, dass Sie im HTTP-Header eine Kundennummer angegeben haben. Wir empfehlen Ihnen, unsere Clientbibliotheken zu verwenden, die dies für Sie erledigen.
CUSTOMER_NOT_FOUND
Zusammenfassung
Es wurde kein Konto mit der im Header angegebenen Kundennummer gefunden.
Allgemeine Ursachen
Sie versuchen, auf ein Konto zuzugreifen, das gerade erst erstellt wurde, bevor es im Back-End eingerichtet wurde.
Vorgehensweise
Warten Sie anfangs fünf Minuten und versuchen Sie es dann alle 30 Sekunden.
Tipps zur Vermeidung
Warten Sie nach der Kontoerstellung einige Minuten, bevor Sie Anfragen für das Konto senden.
GOOGLE_ACCOUNT_COOKIE_INVALID
Zusammenfassung
Das Zugriffstoken im Anfrage-Header ist entweder ungültig oder abgelaufen.
Allgemeine Ursachen
Das Zugriffstoken ist ungültig geworden.
Vorgehensweise
Fordern Sie ein neues Token an. Wenn Sie eine unserer Client-Bibliotheken verwenden, lesen Sie in der zugehörigen Dokumentation nach, wie Sie das Token aktualisieren.
Tipps zur Prävention
Bewahren Sie Zugriffstoken auf und verwenden Sie sie wieder, bis sie ablaufen.
NOT_ADS_USER
Zusammenfassung
Das zum Generieren des Zugriffstokens verwendete Google-Konto ist mit keinem Google Ads-Konto verknüpft.
Allgemeine Ursachen
Die bereitgestellten Anmeldedaten sind einem Google-Konto zugeordnet, für das Google Ads nicht aktiviert ist.
Vorgehensweise
Melden Sie sich für den OAuth-Ablauf mit einem gültigen Google Ads-Konto (in der Regel Ihr Verwaltungskonto) an. Sie können dem Google-Konto auch Zugriff auf ein bestehendes Google Ads-Konto gewähren. Melden Sie sich dazu in Ihrem Verwaltungskonto an, wählen Sie das entsprechende Kunden- oder Verwaltungskonto aus, rufen Sie Tools and Settings > Access and security auf und fügen Sie die E-Mail-Adresse des Google-Kontos hinzu.
Tipps zur Prävention
–
OAUTH_TOKEN_INVALID
Zusammenfassung
Das Oauth-Zugriffstoken im Header ist ungültig.
Häufige Ursachen
Das mit dem HTTP-Header gesendete Zugriffstoken war falsch.
Vorgehensweise
–
Tipps zur Prävention
Vergewissern Sie sich, dass Sie das richtige Zugriffstoken für Ihr Konto gesendet haben. Hin und wieder wird dieses Token mit Aktualisierungstokens und Autorisierungscodes verwechselt. Wenn Sie Anmeldedaten benötigen, mit denen auf alle Kundenkonten eines Verwaltungskontos zugegriffen werden kann, benötigen Sie das Aktualisierungstoken für das Verwaltungskonto. Weitere Informationen finden Sie in unserem Leitfaden zu Zugriffstokens und Aktualisierungstokens und OAuth2.
Auf das Kundenkonto kann nicht zugegriffen werden, da es nicht aktiviert ist.
Allgemeine Ursachen
Dieser Fall tritt auf, wenn die Registrierung für das Kundenkonto noch nicht abgeschlossen oder deaktiviert wurde.
Vorgehensweise
Melden Sie sich auf der Google Ads-Benutzeroberfläche an und stellen Sie sicher, dass Sie die Registrierung für das Konto abgeschlossen haben. Informationen zu deaktivierten Konten finden Sie im Hilfeartikel Aufgelöstes Google Ads-Konto wieder aktivieren.
Tipps zur Prävention
Sie können proaktiv prüfen, ob ein Kundenkonto deaktiviert wurde, indem Sie den Status STORNIERT prüfen.
DEVELOPER_TOKEN_NOT_APPROVED
Zusammenfassung
Das Entwickler-Token ist nur für die Verwendung mit Testkonten freigegeben und es wurde versucht, auf ein Konto zuzugreifen, das kein Testkonto ist.
Allgemeine Ursachen
Für den Zugriff auf ein Konto, das kein Testkonto ist, wurde ein Testentwicklertoken verwendet.
Das Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig.
Allgemeine Ursachen
Jedes Google API Console-Projekt kann mit dem Entwicklertoken von nur einem Verwaltungskonto aus verknüpft werden. Sobald Sie eine Google Ads API-Anfrage stellen, wird das Entwicklertoken dauerhaft mit dem Google API Console-Projekt verknüpft. Wenn Sie kein neues Google API Console-Projekt verwenden, wird beim Stellen einer Anfrage der Fehler DEVELOPER_TOKEN_PROHIBITED angezeigt.
Vorgehensweise
–
Tipps zur Prävention
Wenn Sie in einem neuen Verwaltungskonto zu einem Entwicklertoken wechseln, müssen Sie ein neues Google API Console-Projekt für Google Ads API-Anfragen erstellen, für die das neue Managertoken verwendet wird.
USER_PERMISSION_DENIED
Zusammenfassung
Der autorisierte Kunde hat keinen Zugriff auf den Kunden.
Allgemeine Ursachen
Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne login-customer-id in der Anfrage anzugeben.
Vorgehensweise
–
Tipps zur Prävention
Geben Sie die login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Das wird von Clientbibliotheken unterstützt.
Eine Kampagne wird hinzugefügt oder umbenannt, aber der Name wird bereits für eine andere Kampagne verwendet.
Häufige Ursachen
Erstellung einer neuen Kampagne mit dem Namen einer vorhandenen aktiven oder pausierten Kampagne
Vorgehensweise
Protokollieren Sie den Fehler und senden Sie eine Fehlermeldung an den Nutzer. Schlagen Sie dabei entweder einen eindeutigen Kampagnennamen vor oder zeigen Sie die Liste der verwendeten Namen.
Die Anfrage enthält zwei identische und redundante Parameter.
Häufige Ursachen
–
Vorgehensweise
–
Tipps zur Prävention
Entfernen Sie doppelte Vorgänge, Parameter und Listenelemente, bevor Sie die Anfrage stellen. Suchen Sie nach Feldern mit der Einschränkung DistinctElements.
Das Zeitlimit für die Anfrage wurde überschritten. Sie konnte nicht schnell genug ausgeführt werden, um eine Antwort zurückzugeben.
Allgemeine Ursachen
Es wurde eine Suchanfrage durchgeführt, durch die eine zu große Antwort generiert wurde, oder eine mutate-Anfrage war zu groß, um verarbeitet zu werden.
Vorgehensweise
Warten Sie etwa 30 Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin auftritt, versuchen Sie, die Anfrage in mehrere kleinere Anfragen aufzuteilen, die schneller abgeschlossen werden können.
Bei der Verarbeitung der Anfrage ist ein unerwartetes Ereignis aufgetreten.
Allgemeine Ursachen
Die API funktioniert aufgrund eines Fehlers nicht richtig.
Vorgehensweise
Wiederholen Sie alle Anfragen, die aufgrund dieses Fehlers fehlgeschlagen sind, unter Verwendung eines exponentiellen Backoff-Zeitplans für die Wiederholungsversuche.
Tipps zur Prävention
–
TRANSIENT_ERROR
Zusammenfassung
Es ist ein vorübergehender interner Fehler aufgetreten. Versuchen Sie es noch einmal.
Allgemeine Ursachen
Dieser Fehler tritt auf, wenn bei der API intern ein vorübergehendes Problem auftritt.
Vorgehensweise
Wiederholen Sie alle Anfragen, die aufgrund dieses Fehlers fehlgeschlagen sind, unter Verwendung eines exponentiellen Backoff-Zeitplans für die Wiederholungsversuche.
Tipps zur Prävention
–
InvalidGrantError
invalid_grant (malformed auth code)
Zusammenfassung
Der für OAuth-Tokens ausgetauschte Autorisierungscode war fehlerhaft.
Allgemeine Ursachen
Dies ist der Fall, wenn versucht wird, ein Aktualisierungstoken für einen Nutzer zu generieren, dem bereits Zugriff auf die anfragende Anwendung gewährt wurde. Dieses Problem kann beispielsweise auftreten, wenn Sie das Beispiel zum Generieren von Nutzeranmeldedaten mehrmals für dieselben OAuth-Clientanmeldedaten und denselben autorisierenden Nutzer ausführen.
Vorgehensweise
Um ein Aktualisierungstoken für eine bestimmte Kombination aus autorisierenden Nutzer- und OAuth-Client-Anmeldedaten neu zu generieren, heben Sie ein bestehendes Aktualisierungstoken auf. Wenn Sie ein Token widerrufen, kann es nicht mehr für den Google Ads API-Zugriff verwendet werden. Außerdem werden alle Zugriffstokens ungültig, die mit dem Aktualisierungstoken generiert wurden.
Tipps zur Prävention
Bewahren Sie das Aktualisierungstoken an einem sicheren Ort auf, damit es nicht neu generiert werden muss.
Die Anfrage verweist auf eine Ressource, die nicht gefunden wurde.
Allgemeine Ursachen
In der Anfrage wurde versucht, eine Ressource zu ändern oder anderweitig auf eine Ressource zu verweisen, die nicht vorhanden ist oder entfernt wurde. Oder der angegebene Ressourcenname für die Ressource ist fehlerhaft.
Vorgehensweise
Verwenden Sie eine Suchanfrage, um den Ressourcennamen einer vorhandenen Ressource abzurufen, bevor Sie eine Änderungsanfrage senden. Sehen Sie sich unsere Leitfäden zu Clientbibliotheken an, die auch Informationen zum Erstellen gültiger Ressourcennamen in allen unterstützten Sprachen enthalten.
Tipps zur Prävention
Erstellen Sie Ressourcennamen nicht manuell. Verwenden Sie eine der von unseren Clientbibliotheken angebotenen Hilfsmethoden.
Die Anfrage versucht, eine Ressource zu erstellen, durch die die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreiten würde.
Allgemeine Ursachen
Es gibt mehrere Beschränkungen für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können.
Vorgehensweise
Auf der Seite Systemlimits können Sie die erkannten Grenzwerte ermitteln. Verwenden Sie entweder eine vorhandene Ressource oder entfernen Sie Ressourcen, um Platz für neue zu schaffen.
Tipps zur Prävention
Verwenden Sie Suchanfragen, um die Anzahl der Ressourcen zu überwachen, die Beschränkungen unterliegen.