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
Einem Google Cloud Platform-Projekt mit einem für einen externen Nutzertyp konfigurierten OAuth-Zustimmungsbildschirm und dem Veröffentlichungsstatus Testing wird ein Aktualisierungstoken ausgestellt, das in 7 Tagen abläuft.
Vorgehensweise
Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Das Aktualisierungstoken läuft also alle 7 Tage ab und es wird der Fehler invalid_grant angezeigt. Gehen Sie in der Google API Console zum OAuth-Zustimmungsbildschirm. Ändern Sie anschließend den Veröffentlichungsstatus in In production. Folgen Sie dazu dieser Anleitung, damit das Aktualisierungstoken nicht in 7 Tagen abläuft.
Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden.
Allgemeine Ursachen
Es wird versucht, 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. Die 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 URLs in Ihrer App, 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
Sie erstellen eine neue 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.
Zwei Vorgänge in einer einzelnen Anfrage 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 dann in der nachfolgenden Anfrage. Alternativ können Sie innerhalb derselben Anfrage eine temporäre ID verwenden.
Die Kundennummer wurde im HTTP-Header nicht angegeben.
Allgemeine Ursachen
Keine Client-Kundennummer im HTTP-Header angegeben.
Vorgehensweise
–
Tipps zur Prävention
Die Client-Kundennummer ist für alle Aufrufe erforderlich. Geben Sie daher eine Kundennummer im HTTP-Header an. Sie können dafür unsere Clientbibliotheken verwenden.
CUSTOMER_NOT_FOUND
Zusammenfassung
Es wurde kein Konto mit der im Header angegebenen Kundennummer gefunden.
Allgemeine Ursachen
Es wird versucht, auf ein Konto zuzugreifen, das gerade erstellt wurde, bevor das Konto im Backend 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 an (normalerweise das Verwaltungskonto). 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 für den Zugriff auf alle Kundenkonten eines Verwaltungskontos benötigen, 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 des Kundenkontos noch nicht abgeschlossen ist oder deaktiviert wurde.
Vorgehensweise
Melden Sie sich in der Google Ads-Benutzeroberfläche an und vergewissern Sie sich, dass Sie die Registrierung für dieses Konto abgeschlossen haben. Informationen zu deaktivierten Konten finden Sie im Hilfeartikel Ein aufgelöstes Google Ads-Konto wieder aktivieren.
Tipps zur Prävention
Sie können proaktiv prüfen, ob ein Kundenkonto deaktiviert wurde, indem Sie nach dem Status CANCELLED suchen.
DEVELOPER_TOKEN_NOT_APPROVED
Zusammenfassung
Das Entwickler-Token ist nur für die Verwendung mit Testkonten freigegeben und es wird versucht, auf ein Konto zuzugreifen, das kein Testkonto ist.
Allgemeine Ursachen
Ein Testentwickler-Token wurde für den Zugriff auf ein Konto verwendet, das kein Testkonto ist.
Das Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig.
Allgemeine Ursachen
Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token eines einzigen Verwaltungskontos verknüpft werden. Wenn Sie eine Google Ads API-Anfrage stellen, ist das Entwickler-Token dauerhaft mit dem Google API Console-Projekt gekoppelt. Falls Sie kein neues Google API Console-Projekt verwenden, erhalten Sie beim Senden einer Anfrage den Fehler DEVELOPER_TOKEN_PROHIBITED.
Vorgehensweise
–
Tipps zur Prävention
Wenn Sie unter einem neuen Verwaltungskonto zu einem Entwickler-Token wechseln, müssen Sie für Google Ads API-Anfragen, in denen das Token des neuen Administrators verwendet wird, ein neues Google API Console-Projekt erstellen.
USER_PERMISSION_DENIED
Zusammenfassung
Der autorisierte Kunde hat keinen Zugriff auf den Betreiberkunden.
Allgemeine Ursachen
Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, aber ohne login-customer-id in der Anfrage.
Vorgehensweise
–
Tipps zur Prävention
Geben Sie login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Clientbibliotheken unterstützen dies.
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.
Bei der Anfrage ist eine Zeitüberschreitung aufgetreten und sie konnte nicht schnell genug abgeschlossen werden, um eine Antwort zurückzugeben.
Allgemeine Ursachen
Eine Suchanfrage hat eine zu große Antwort generiert oder eine mutate-Anfrage war zu groß und konnte nicht verarbeitet 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 mit diesem Fehler fehlgeschlagen sind, und verwenden Sie dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen.
Tipps zur Prävention
–
TRANSIENT_ERROR
Zusammenfassung
Ein vorübergehender interner Fehler ist aufgetreten und Sie sollten es noch einmal versuchen.
Allgemeine Ursachen
Dieser Fehler tritt auf, wenn in der API intern ein vorübergehendes Problem auftritt.
Vorgehensweise
Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen.
Tipps zur Prävention
–
InvalidGrantError
invalid_grant (malformed auth code)
Zusammenfassung
Der für OAuth-Tokens ausgetauschte Autorisierungscode war fehlerhaft.
Allgemeine Ursachen
Dies geschieht, wenn versucht wird, ein Aktualisierungstoken für einen Nutzer zu generieren, dem bereits Zugriff auf die anfragende Anwendung gewährt wurde. Das kann beispielsweise passieren, wenn Sie das Beispiel zum Generieren von Nutzeranmeldedaten mehrmals für dieselben OAuth-Clientanmeldedaten und zum Autorisieren des Nutzers ausführen.
Vorgehensweise
Um ein Aktualisierungstoken für eine bestimmte Kombination aus Nutzer- und OAuth-Clientanmeldedaten neu zu generieren, entfernen Sie ein vorhandenes Aktualisierungstoken. 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 noch einmal generiert werden muss.
Die Anfrage hat auf eine Ressource verwiesen, 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 mutate-Anfrage senden. Lesen Sie unsere Leitfäden zur Clientbibliothek. Darin finden Sie auch Informationen zur Erstellung gültiger Ressourcennamen in jeder unterstützten Sprache.
Tipps zur Prävention
Erstellen Sie Ressourcennamen nicht manuell. Verwenden Sie eine der Hilfsmethoden, die in unseren Clientbibliotheken angeboten werden.
Durch die Anfrage wird versucht, eine Ressource zu erstellen, die dazu führen würde, dass die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreiten würde.
Allgemeine Ursachen
Es gibt mehrere Limits für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können.
Vorgehensweise
Sehen Sie sich die Systemlimits an, um herauszufinden, welches Limit überschritten wurde. Verwenden Sie entweder eine vorhandene Ressource wieder oder entfernen Sie Ressourcen, um Platz für neue Ressourcen zu schaffen.
Tipps zur Prävention
Verwenden Sie Suchanfragen, um die Anzahl der Ressourcen mit Einschränkungen zu überwachen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-06-26 (UTC)."],[],[]]
