Häufige Fehler

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
ZusammenfassungDas 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.
Tipps zur Prävention Weitere Informationen finden Sie im Hilfeartikel Nicht überprüfte Apps.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
ZusammenfassungDie Kundennummer ist keine Zahl.
Allgemeine Ursachen Sie verwenden eine falsche Client-Kundennummer.
Vorgehensweise
Tipps zur Prävention 123-456-7890 sollte 1234567890 sein. Weitere Informationen
CLIENT_CUSTOMER_ID_IS_REQUIRED
ZusammenfassungDie 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
ZusammenfassungEs 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.
ZusammenfassungDas 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
ZusammenfassungDas 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
ZusammenfassungDas 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.

AuthorizationError

CUSTOMER_NOT_ENABLED
ZusammenfassungAuf 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
ZusammenfassungDas 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.
Vorgehensweise Stellen Sie sicher, dass Sie tatsächlich auf ein Konto zugreifen möchten, das kein Testkonto ist. In diesem Fall müssen Sie ein Upgrade Ihres Entwicklertokens auf Standard- oder Basiszugriff beantragen.
Tipps zur Prävention
DEVELOPER_TOKEN_PROHIBITED
ZusammenfassungDas 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
ZusammenfassungDer 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.