Häufige Fehler

In diesem Leitfaden werden häufige API-Fehler aufgeführt und Strategien zur Vermeidung und Behandlung dieser Fehler beschrieben.

Eine umfassende Liste aller Fehlertypen finden Sie in der Google Ads API-Fehler referenz. Wenn Sie weitere Unterstützung benötigen, stellen Sie eine Frage im Google Ads API Forum.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
ZusammenfassungDas OAuth 2.0-Zugriffstoken hat nicht die erforderlichen Zugriffsbereiche.
Häufige Ursachen Die Anfrage wird abgelehnt, weil das bereitgestellte Zugriffstoken nicht den OAuth 2.0-Zugriffsbereich der Google Ads API enthält.
Gegenargument Achten Sie darauf, dass das Zugriffstoken die erforderlichen Zugriffsbereiche hat. Ein häufiger Grund für diesen Fehler ist, dass Sie ein vorhandenes Zugriffstoken wiederverwenden, das mit einer anderen Gruppe von OAuth-Zugriffsbereichen generiert wurde. Unter OAuth-Autorisierungsparameter finden Sie ein Beispiel dafür, wie Sie ein neues Zugriffstoken mit den erforderlichen Zugriffsbereichen generieren.
Tipps zur Vermeidung Achten Sie darauf, dass das Zugriffstoken die erforderlichen Zugriffsbereiche hat. Authentifizieren Sie Ihren Nutzer mit den erforderlichen Zugriffsbereichen neu, um ein Zugriffstoken mit den erforderlichen Zugriffsbereichen zu erhalten. Wenn Ihre Anwendung mehrere OAuth-Zugriffsbereiche 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.
Gegenargument 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 Nicht bestätigte Apps.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
ZusammenfassungDie Kundennummer ist keine Zahl.
Häufige Ursachen Verwendung einer falschen Kundennummer.
Gegenargument –
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.
Gegenargument –
Tipps zur Vermeidung Die Zweitkundennummer 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.
Gegenargument 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.
Gegenargument Fordern Sie ein neues Token an. Wenn Sie eine unserer Clientbibliotheken verwenden, lesen Sie in der 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 keinem Google Ads-Konto zugeordnet.
Häufige Ursachen Die bereitgestellten Anmeldedaten sind einem Google-Konto zugeordnet, für das Google Ads nicht aktiviert ist.
Gegenargument 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.
Gegenargument –
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 im Leitfaden zur Nutzerauthentifizierung.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
ZusammenfassungDas Google Cloud-Projekt hat nur Testzugriff und kann nicht für den Zugriff auf Produktionskonten verwendet werden.
Häufige Ursachen Ein Google Cloud-Projekt mit der Zugriffsebene „Test“ wurde verwendet, um eine Anfrage an ein Google Ads-Konto zu senden, das kein Testkonto ist (Produktionskonto). In den API-Versionen 24 und früher wird unter dieser Bedingung AuthorizationError.ACTION_NOT_PERMITTED zurückgegeben.
Gegenargument Wenn Sie Tests durchführen, achten Sie darauf, dass Ihre Anfrage an ein Testkonto gerichtet ist. Wenn Sie auf ein Google Ads-Produktionskonto zugreifen möchten, prüfen Sie die Zugriffsebene Ihres Google Cloud-Projekts auf der Übersichtsseite der Google Ads API und aktualisieren Sie die Zugriffsebene Ihres Projekts auf „Explorer“, „Basic“ oder „Standard“.
Tipps zur Vermeidung –
CUSTOMER_NOT_ENABLED
ZusammenfassungAuf das Kundenkonto kann nicht zugegriffen werden, da es nicht aktiviert ist.
Häufige Ursachen Dieser Fehler tritt auf, wenn die Registrierung für das Kundenkonto nicht abgeschlossen wurde oder das Konto deaktiviert wurde.
Gegenargument 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.
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 nicht login-customer-id in der Anfrage an.
Gegenargument –
Tipps zur Vermeidung Geben Sie login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Clientbibliotheken bieten eine integrierte Unterstützung dafür.

Zurück
Fehler verarbeiten
Weiter
Nächste Schritte