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 Fehlerreferenzen. Weitere Unterstützung erhalten Sie in unserem 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. Vorgehensweise 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 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 den 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.

google.auth.exceptions.RefreshError

invalid_grant

Zusammenfassung Das Token ist abgelaufen oder wurde widerrufen. Häufige Ursachen Für ein Google Cloud-Projekt mit einem OAuth-Zustimmungsbildschirm, der für einen externen Nutzertyp konfiguriert ist, und einem Veröffentlichungsstatus von Testing wird ein Aktualisierungstoken ausgestellt, das nach 7 Tagen abläuft. Vorgehensweise Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Daher läuft das Aktualisierungstoken alle 7 Tage ab und es wird ein invalid_grant-Fehler angezeigt. Rufen Sie die Google API Console auf und gehen Sie zum OAuth-Zustimmungsbildschirm. Ändern Sie dann den Veröffentlichungsstatus in In production. Folgen Sie dazu dieser Anleitung, damit das Aktualisierungstoken nicht nach 7 Tagen abläuft. Tipps zur Vermeidung Weitere Informationen

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Zusammenfassung Die Kundennummer ist keine Zahl. Häufige Ursachen Es wird eine falsche Kundennummer des Kunden verwendet. Vorgehensweise – 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. Vorgehensweise – Tipps zur Vermeidung Die Client-Kundennummer 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 diese die Verarbeitung 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. Vorgehensweise 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. Vorgehensweise 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 keinem Google Ads-Konto zugeordnet. Häufige Ursachen Die bereitgestellten Anmeldedaten sind einem Google-Konto zugeordnet, für das Google Ads nicht aktiviert ist. Vorgehensweise 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 betreffende 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. Vorgehensweise – 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 in unserem Leitfaden zu Zugriffstoken und Aktualisierungstoken und OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Zusammenfassung Das 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 wie das Google Cloud-Projekt verknüpft, das ursprünglich für Anfragen verwendet wurde. Vorgehensweise 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 gesendet haben. Tipps zur Vermeidung Achten Sie darauf, dass alle Ihre Google Cloud-Projekte derselben Google Cloud-Organisation zugeordnet sind. Ein Google Cloud-Projekt kann nur mit einem Entwicklertoken verknüpft sein, ein Entwicklertoken kann jedoch mit mehreren Projekten in der Organisation verknüpft sein.
DEVELOPER_TOKEN_INVALID	Zusammenfassung Das Entwicklertoken ist ungültig. Häufige Ursachen Häufige Ursachen für diesen Fehler sind Tippfehler im Entwicklertoken oder ein falsch festgelegtes Entwicklertoken in einem anderen Anfrageheader. Vorgehensweise Kopieren Sie das Entwicklertoken aus dem API-Center, um Tippfehler zu vermeiden. Sie finden das API-Center in Ihrem Google Ads-Verwaltungskonto. 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 Anfrageheadern Tipps zur Vermeidung –

AuthorizationError
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. Vorgehensweise 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.
DEVELOPER_TOKEN_NOT_APPROVED	Zusammenfassung Das Entwicklertoken ist nur für die Verwendung mit Testkonten genehmigt und es wurde versucht, auf ein Konto zuzugreifen, das kein Testkonto ist. Häufige Ursachen Mit einem Testentwicklertoken wurde auf ein Konto zugegriffen, das kein Testkonto ist. Vorgehensweise Prüfen Sie, ob Sie wirklich auf ein Konto zugreifen möchten, das kein Testkonto ist. Wenn das der Fall ist, müssen Sie ein Upgrade Ihres Entwicklertokens auf Standard- oder Basic-Zugriff beantragen. Tipps zur Vermeidung –
DEVELOPER_TOKEN_PROHIBITED	Zusammenfassung Das Entwicklertoken ist für das im Antrag gesendete Projekt nicht zulässig. Häufige Ursachen Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token 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, erhalten Sie bei einer Anfrage den Fehler DEVELOPER_TOKEN_PROHIBITED. Vorgehensweise – Tipps zur Vermeidung Wenn Sie zu einem Entwickler-Token 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 Verwaltungskontos verwenden.
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. Vorgehensweise – Tipps zur Vermeidung Geben Sie die login-customer-id als Verwaltungskonto-ID ohne Bindestriche an (-). Clientbibliotheken bieten integrierte Unterstützung dafür.