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 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.
Tipps zur Prävention Weitere Informationen

AuthenticationError

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

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 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
ZusammenfassungDas 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.
Vorgehensweise Stellen Sie sicher, dass Sie tatsächlich auf ein Konto zugreifen möchten, das kein Testkonto ist. In diesem Fall müssen Sie eine Umstellung Ihres Entwicklertokens auf den 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 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
ZusammenfassungDer 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.