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 Fehler referenzen. Weitere Unterstützung erhalten Sie in unserem Forum.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
ZusammenfassungDas OAuth 2.0-Zugriffstoken hat nicht die erforderlichen Bereiche.
Häufige Ursachen Die Anfrage wird abgelehnt, weil das bereitgestellte Zugriffstoken nicht den OAuth 2.0-Bereich der Google Ads API enthält.
Maßnahmen Prüfen Sie, ob das Zugriffstoken die erforderlichen Bereiche hat. Ein häufiger Grund für diesen Fehler ist, dass Sie ein vorhandenes Zugriffstoken wiederverwenden, das mit einer anderen Gruppe von OAuth-Bereichen generiert wurde. Ein Beispiel zum Generieren eines neuen Zugriffstokens mit den erforderlichen Bereichen finden Sie unter OAuth-Autorisierungsparameter.
Tipps zur Vermeidung Prüfen Sie, ob das Zugriffstoken die erforderlichen Bereiche hat. Authentifizieren Sie Ihren Nutzer mit den erforderlichen Bereichen neu, um ein Zugriffstoken mit den erforderlichen Bereichen zu erhalten. Wenn Ihre Anwendung mehrere OAuth-Bereiche verwendet, müssen Sie möglicherweise detaillierte OAuth-Berechtigungen implementieren.

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 den Veröffentlichungsstatus Testing hat, wird ein Aktualisierungstoken ausgestellt, das nach 7 Tagen abläuft.
Maßnahmen Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Daher läuft das Aktualisierungstoken alle 7 Tage ab und es wird der Fehler invalid_grant angezeigt. Rufen Sie die Google API Console auf und gehen Sie zum OAuth-Zustimmungsbildschirm. Ändern Sie dann den Veröffentlichungsstatus in In production, damit das Aktualisierungstoken nicht nach 7 Tagen abläuft.
Tipps zur Vermeidung Weitere Informationen finden Sie unter Ungeprüfte Apps.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
ZusammenfassungDie Kundennummer ist keine Zahl.
Häufige Ursachen Verwendung einer falschen Kundennummer.
Maßnahmen –
Tipps zur Vermeidung „123-456-7890“ sollte „1234567890“ sein. Weitere Informationen finden Sie unter Erste Schritte.
CLIENT_CUSTOMER_ID_IS_REQUIRED
ZusammenfassungDie Kundennummer wurde im HTTP-Header nicht angegeben.
Häufige Ursachen Im HTTP-Header wurde keine Kundennummer angegeben.
Maßnahmen –
Tipps zur Vermeidung Die Kundennummer ist für alle Aufrufe erforderlich. Achten Sie darauf, dass Sie eine im HTTP-Header angegeben haben. Sie können auch unsere Clientbibliotheken verwenden, da diese das für Sie übernehmen.
CUSTOMER_NOT_FOUND
ZusammenfassungEs wurde kein Konto mit der im Header angegebenen Kundennummer gefunden.
Häufige Ursachen Sie versuchen, auf ein Konto zuzugreifen, das gerade erst erstellt wurde, bevor es im Backend eingerichtet wurde.
Maßnahmen 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.
Maßnahmen Fordern Sie ein neues Token an. Wenn Sie eine unserer Clientbibliotheken verwenden, finden Sie in der Dokumentation Informationen zum Aktualisieren des Tokens.
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 keinem Google Ads-Konto zugeordnet.
Häufige Ursachen Die bereitgestellten Anmeldedaten sind einem Google-Konto zugeordnet, für das Google Ads nicht aktiviert ist.
Maßnahmen Melden Sie sich für den OAuth-Ablauf mit einem gültigen Google Ads-Konto an (in der Regel Ihr Verwaltungskonto). Sie können das Google-Konto auch einladen, auf ein vorhandenes Google Ads-Konto zuzugreifen. Melden Sie sich dazu in Ihrem Verwaltungskonto an, wählen Sie das betreffende Kunden- oder Verwaltungskonto aus und gehen Sie zu Tools and Settings > Access and security. Fügen Sie dann 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.
Maßnahmen –
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 erhalten möchten, mit denen Sie auf alle Kundenkonten unter einem Verwaltungskonto zugreifen können, müssen Sie das Aktualisierungstoken für das Verwaltungskonto abrufen. Weitere Informationen finden Sie in der Anleitung zur Nutzerauthentifizierung.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
ZusammenfassungDas Entwicklertoken ist bereits mit einer Google Cloud-Organisation verknüpft und kann nicht mit einer anderen Organisation verknüpft werden.
Häufige Ursachen Das Entwicklertoken ist nicht mit einem Google Cloud-Projekt in derselben Google Cloud-Organisation verknüpft wie das Google Cloud-Projekt, das ursprünglich für Anfragen verwendet wurde.
Maßnahmen Achten Sie darauf, dass die OAuth-Client-ID mit Google Cloud-Projekten in derselben Google Cloud-Organisation verknüpft ist, wenn Sie bereits API-Anfragen mit dem Entwicklertoken gestellt haben.
Tipps zur Vermeidung Achten Sie darauf, dass alle Ihre Google Cloud-Projekte mit derselben Google Cloud-Organisation verknüpft sind. Ein Google Cloud-Projekt kann nur mit einem Entwicklertoken verknüpft sein, aber ein Entwicklertoken kann mit mehreren Projekten in der Organisation verknüpft sein.
DEVELOPER_TOKEN_INVALID
ZusammenfassungDas Entwicklertoken ist ungültig.
Häufige Ursachen Häufige Ursachen für diesen Fehler sind Tippfehler im Entwicklertoken oder eine falsche Einstellung des Entwicklertokens in einem anderen Anfrage-Header.
Maßnahmen Kopieren Sie das Entwicklertoken aus dem API-Center, um Tippfehler zu vermeiden. Sie können das API-Center in Ihrem Google Ads-Verwaltungskonto finden. Achten Sie außerdem darauf, dass Sie das Entwicklertoken im richtigen Header festlegen. Entwicklertokens werden manchmal mit OAuth-Aktualisierungstokens und Autorisierungscodes verwechselt. Weitere Informationen zu den verschiedenen Anfrage-Headern hier.
Tipps zur Vermeidung –

AuthorizationError
CUSTOMER_NOT_ENABLED
ZusammenfassungAuf das Kundenkonto kann nicht zugegriffen werden, da es nicht aktiviert ist.
Häufige Ursachen Dieser Fehler tritt auf, wenn die Anmeldung für das Kundenkonto nicht abgeschlossen wurde oder das Konto deaktiviert wurde.
Maßnahmen 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 unter Aufgelöstes Google Ads-Konto wieder aktivieren.
Tipps zur Vermeidung Sie können proaktiv prüfen, ob ein Kundenkonto deaktiviert ist, indem Sie nach dem Status „CANCELLED“ suchen.
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 Testentwicklertoken verwendet, um auf ein Nicht-Testkonto zuzugreifen.
Maßnahmen Prüfen Sie, ob Sie tatsächlich auf ein Nicht-Testkonto zugreifen möchten. Wenn ja, müssen Sie beantragen, dass Ihr Entwicklertoken aktualisiert wird auf Standard- oder Basiszugriff.
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 Entwicklertoken eines Verwaltungskontos 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.
Maßnahmen –
Tipps zur Vermeidung Wenn Sie zu einem Entwicklertoken unter einem neuen Verwaltungskonto wechseln, müssen Sie ein neues Google API Console-Projekt erstellen für Google Ads API-Anfragen, die das Token des neuen Administrators verwenden.
USER_PERMISSION_DENIED
ZusammenfassungDer autorisierte Kunde hat keinen Zugriff auf den operativen Kunden.
Häufige Ursachen Sie authentifizieren sich als Nutzer mit Zugriff auf ein Verwaltungskonto, geben aber in der Anfrage keine login-customer-id an.
Maßnahmen –
Tipps zur Vermeidung Geben Sie die login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Clientbibliotheken bieten integrierte Unterstützung für diese Funktion.

Zurück
Fehler verarbeiten
Weiter
Nächste Schritte