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 Referenzen zu Fehlern. Weitere Unterstützung erhalten Sie in unserem Forum.

google.auth.exceptions.RefreshError

invalid_grant
ZusammenfassungDas Token ist abgelaufen oder wurde widerrufen.
Häufige Ursachen Für ein Google Cloud Platform-Projekt mit einem OAuth-Zustimmungsbildschirm, der für einen externen Nutzertyp konfiguriert ist, und einem Veröffentlichungsstatus von Testing wird ein Aktualisierungstoken mit einer Gültigkeitsdauer von 7 Tagen ausgestellt.
Vorgehensweise: Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Das Aktualisierungstoken läuft daher alle sieben Tage ab und es wird der Fehler invalid_grant ausgegeben. Rufen Sie in der Google API Console den OAuth-Zustimmungsbildschirm auf. Ändern Sie dann den Veröffentlichungsstatus in In production, damit das Aktualisierungstoken nicht in 7 Tagen abläuft. Folgen Sie dazu dieser Anleitung.
Tipps zur Vermeidung Weitere Informationen finden Sie unter Ungeprüfte Apps.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
ZusammenfassungDie Kundennummer ist keine Zahl.
Häufige Ursachen Eine ungültige Kundennummer des Kunden verwendet.
Vorgehensweise:
Tipps zur Vermeidung 123-456-7890 muss 1234567890 sein. Weitere Informationen
CLIENT_CUSTOMER_ID_IS_REQUIRED
ZusammenfassungDie Kundennummer wurde im HTTP-Header nicht angegeben.
Häufige Ursachen Im HTTP-Header wird keine Kundennummer des Kunden angegeben.
Vorgehensweise:
Tipps zur Vermeidung Die Kunden-ID des Kunden ist für alle Aufrufe erforderlich. Achten Sie daher darauf, dass Sie im HTTP-Header eine Kunden-ID angegeben haben. Sie können auch unsere Clientbibliotheken verwenden, da diese Aufgabe dort für Sie erledigt wird.
CUSTOMER_NOT_FOUND
ZusammenfassungEs wurde kein Konto mit der im Header angegebenen Kundennummer gefunden.
Häufige Ursachen Versuch, 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.
Häufige Ursachen Das Zugriffstoken ist ungültig geworden.
Vorgehensweise: Fordern Sie ein neues Token an. Wenn Sie eine unserer Clientbibliotheken verwenden, lesen Sie in der zugehörigen Dokumentation nach, wie Sie das Token aktualisieren.
Tipps zur Vermeidung Bewahren Sie Zugriffstoken auf und verwenden Sie sie wieder, bis sie ablaufen.
NOT_ADS_USER
ZusammenfassungDas Google-Konto, mit dem das Zugriffstoken generiert wurde, ist mit keinem Google Ads-Konto verknüpft.
Häufige 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-Vorgang mit einem gültigen Google Ads-Konto an (in der Regel Ihrem Verwaltungskonto). Sie können das Google-Konto auch zum Zugriff auf ein bestehendes Google Ads-Konto einladen. Melden Sie sich dazu in Ihrem Verwaltungskonto an, wählen Sie das betreffende 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 Vermeidung
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 Vermeidung 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 Sie auf alle Kundenkonten in einem Verwaltungskonto zugreifen können, müssen Sie das Aktualisierungstoken für das Verwaltungskonto abrufen. Weitere Informationen finden Sie in unseren Leitfäden zu Zugriffs- und Aktualisierungstoken und OAuth2.

AuthorizationError

CUSTOMER_NOT_ENABLED
ZusammenfassungAuf das Kundenkonto kann nicht zugegriffen werden, da es nicht aktiviert ist.
Häufige Ursachen Das passiert, wenn die Registrierung des Kundenkontos nicht abgeschlossen wurde oder es deaktiviert wurde.
Vorgehensweise: Melden Sie sich in der Google Ads-Benutzeroberfläche an und prüfen Sie, ob 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 Vermeidung Du kannst proaktiv prüfen, ob ein Kundenkonto deaktiviert ist. Suche dazu nach dem Status CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
ZusammenfassungDas Entwicklertoken ist nur für die Verwendung mit Testkonten genehmigt und es wurde versucht, auf ein Nicht-Testkonto zuzugreifen.
Häufige Ursachen Es wurde ein Test-Entwicklertoken verwendet, um auf ein Nicht-Testkonto zuzugreifen.
Vorgehensweise: Achten Sie darauf, dass Sie tatsächlich auf ein Nicht-Testkonto zugreifen möchten. In diesem Fall müssen Sie einen Antrag auf ein Upgrade Ihres Entwicklertokens auf Standard- oder Basiszugriff stellen.
Tipps zur Vermeidung
DEVELOPER_TOKEN_PROHIBITED
ZusammenfassungDas Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig.
Häufige Ursachen Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token aus einem einzigen Verwaltungskonto 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, erhalten Sie bei einer Anfrage einen DEVELOPER_TOKEN_PROHIBITED-Fehler.
Vorgehensweise:
Tipps zur Vermeidung Wenn Sie zu einem Entwickler-Token unter einem neuen Verwaltungskonto wechseln, müssen Sie ein neues Google API Console-Projekt erstellen, für das Google Ads API-Anfragen mit dem Token des neuen Verwaltungskontos gesendet werden.
USER_PERMISSION_DENIED
ZusammenfassungDer autorisierte Kunde hat keinen Zugriff auf den Betreiberkunden.
Häufige Ursachen Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne login-customer-id in der Anfrage anzugeben.
Vorgehensweise:
Tipps zur Vermeidung Geben Sie die login-customer-id als ID des Verwaltungskontos ohne Bindestriche (-) an. Clientbibliotheken bieten eine integrierte Unterstützung dafür.