Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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

Zusammenfassung	Das 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.

invalid_grant

Zusammenfassung	Das 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.

CLIENT_CUSTOMER_ID_INVALID

Zusammenfassung	Die 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

Zusammenfassung	Die 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

Zusammenfassung	Es 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.

GOOGLE_ACCOUNT_COOKIE_INVALID

Zusammenfassung	Das 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

Zusammenfassung	Das 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

Zusammenfassung	Das 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.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Zusammenfassung	Das 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

Zusammenfassung	Auf 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

Zusammenfassung	Der 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.