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-Fehlerreferenz. 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 Bereiche.
Häufige Ursachen	Die Anfrage wird abgelehnt, weil das angegebene 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 einer anderen Gruppe von OAuth-Bereichen generiert wurde. Ein Beispiel dafür, wie Sie ein neues Zugriffstoken mit den erforderlichen Bereichen generieren, 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 einen 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 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 in 7 Tagen abläuft.
Tipps zur Vermeidung	Weitere Informationen zu nicht bestätigten Apps

CLIENT_CUSTOMER_ID_INVALID

Zusammenfassung	Die Kundennummer ist keine Zahl.
Häufige Ursachen	Es wird eine falsche Kundennummer verwendet.
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 wird keine Kunden-ID für den Client angegeben.
Gegenargument	–
Tipps zur Vermeidung	Die Kunden-ID des Clients ist für alle Aufrufe erforderlich. Achten Sie also darauf, dass Sie eine im HTTP-Header angegeben haben. Erwägen Sie, 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	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 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

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 Ihrem 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 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 für den Zugriff auf alle Kundenkonten unter einem Verwaltungskonto benötigen, 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	Für eine Anfrage an ein Google Ads-Konto, das kein Testkonto (Produktionskonto) ist, wurde ein Google Cloud-Projekt mit der Testzugriffsebene verwendet. In API-Versionen 24 und früher wird für diese Bedingung `AuthorizationError.ACTION_NOT_PERMITTED` zurückgegeben.
Gegenargument	Wenn Sie Tests durchführen, muss sich Ihre Anfrage auf ein Testkonto beziehen. Wenn Sie auf ein Google Ads-Produktionskonto zugreifen möchten, prüfen Sie das Zugriffsniveau Ihres Google Cloud-Projekts auf der Übersichtsseite der Google Ads API und führen Sie ein Upgrade des Zugriffsniveaus Ihres Projekts durch, um Explorer-, Basic- oder Standardzugriff zu erhalten.
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 Betriebskunden.
Häufige Ursachen	Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne `login-customer-id` in der Anfrage anzugeben.
Gegenargument	–
Tipps zur Vermeidung	Geben Sie die `login-customer-id` als Verwaltungskonto-ID ohne Bindestriche an (`-`). Clientbibliotheken bieten integrierte Unterstützung dafür.