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 zu ihrer Vermeidung und Behebung vorgestellt.

Eine vollständige Liste aller Fehlertypen finden Sie in der Google Ads API-Fehlerreferenz. Wenn Sie Fragen haben, wenden Sie sich an den Support oder treten Sie dem Google Ads-Discord-Server bei, um sich mit anderen auszutauschen.

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Zusammenfassung	Das 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.
Gegenargument	Achten Sie darauf, dass das Zugriffstoken die erforderlichen Bereiche hat. Ein häufiger Grund für diesen Fehler ist, dass Sie ein vorhandenes Zugriffstoken wiederverwenden, das mit anderen OAuth-Bereichen generiert wurde. Ein Beispiel für das 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 noch einmal mit den erforderlichen Bereichen, um Zugriff mit den erforderlichen Bereichen zu erhalten. Wenn Ihre Anwendung mehrere OAuth-Bereiche 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 und den Veröffentlichungsstatus `Testing` konfiguriert ist, wird ein Aktualisierungstoken ausgestellt, das in 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 überprüfte Apps.

CLIENT_CUSTOMER_ID_INVALID

Zusammenfassung	Die Kundennummer ist keine Zahl.
Häufige Ursachen	Verwendung einer ungültigen Kundennummer
Gegenargument	–
Tipps zur Vermeidung	123-456-7890 sollte 1234567890 sein. Weitere Informationen

CLIENT_CUSTOMER_ID_IS_REQUIRED

Zusammenfassung	Die Kundennummer wurde im HTTP-Header nicht angegeben.
Häufige Ursachen	Im HTTP-Header ist keine Kundennummer angegeben.
Gegenargument	–
Tipps zur Vermeidung	Die Kundennummer des Kunden ist für alle Aufrufe erforderlich. Sie muss im HTTP-Header angegeben werden. Wir empfehlen, unsere Clientbibliotheken zu verwenden, da sie dies für Sie übernehmen.

CUSTOMER_NOT_FOUND

Zusammenfassung	Es wurde kein Konto mit der im Header angegebenen Kundennummer gefunden.
Häufige Ursachen	Versuch, auf ein Konto zuzugreifen, das gerade erst erstellt wurde, bevor das Konto 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, finden Sie in der zugehörigen Dokumentation Informationen zum Aktualisieren des Tokens.
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 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.
Gegenargument	Melden Sie sich für den OAuth-Vorgang mit einem gültigen Google Ads-Konto an (normalerweise Ihrem Verwaltungskonto). Sie können das Google-Konto auch einladen, auf ein bestehendes Google Ads-Konto zuzugreifen. 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 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 API-Versionen v24 und früher gibt diese Bedingung `AuthorizationError.ACTION_NOT_PERMITTED` zurück.)
Gegenargument	Wenn Sie Tests durchführen, muss Ihre Anfrage auf ein Testkonto ausgerichtet sein. 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	Das passiert, wenn die Registrierung des Kundenkontos 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 Ein 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	Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne dass `login-customer-id` in der Anfrage angegeben ist.
Gegenargument	–
Tipps zur Vermeidung	Geben Sie die `login-customer-id` als Konto-ID des Verwaltungskontos ohne Bindestriche (`-`) an. Clientbibliotheken bieten dafür integrierte Unterstützung.