Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 Referenzen zu Fehlern. 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, da das bereitgestellte Zugriffstoken nicht den OAuth 2.0-Bereich der Google Ads API enthält.
Vorgehensweise:
Das Zugriffstoken muss die erforderlichen Bereiche haben. Eine häufige Ursache für diesen Fehler ist, dass Sie ein vorhandenes Zugriffstoken wiederverwenden, das mit einer anderen OAuth-Berechtigungsgruppe generiert wurde. Ein Beispiel zum Generieren eines neuen Zugriffstokens mit den erforderlichen Bereichen findest du unter OAuth-Autorisierungsparameter.
Tipps zur Vermeidung
Das Zugriffstoken muss die erforderlichen Bereiche haben. Authentifizieren Sie den Nutzer mit den erforderlichen Bereichen noch einmal, um 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 Platform-Projekt mit einem OAuth-Zustimmungsbildschirm, der für einen externen Nutzertyp konfiguriert ist, und einem Veröffentlichungsstatus von Testing wird ein Aktualisierungstoken mit einer Gültigkeitsdauer von 7 Tagen ausgestellt.
Vorgehensweise:
Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Das Aktualisierungstoken läuft daher alle sieben Tage ab und es wird der Fehler invalid_grant ausgegeben. Rufen Sie in der Google API Console den OAuth-Zustimmungsbildschirm auf. Ändern Sie dann den Veröffentlichungsstatus gemäß dieser Anleitung zu In production, damit das Aktualisierungstoken nicht in 7 Tagen abläuft.
Die Kundennummer wurde im HTTP-Header nicht angegeben.
Häufige Ursachen
Im HTTP-Header wird keine Kundennummer des Kunden angegeben.
Vorgehensweise:
–
Tipps zur Vermeidung
Die Kunden-ID des Kunden ist für alle Aufrufe erforderlich. Achten Sie daher darauf, dass Sie im HTTP-Header eine Kunden-ID angegeben haben. Sie können auch unsere Clientbibliotheken verwenden, da diese Aufgabe dort für Sie erledigt wird.
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 erstellt wurde, bevor das Konto 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, 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 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.
Vorgehensweise:
Melden Sie sich für den OAuth-Vorgang mit einem gültigen Google Ads-Konto an (in der Regel Ihrem Verwaltungskonto). Sie können das Google-Konto auch zum Zugriff auf ein vorhandenes Google Ads-Konto einladen. 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 benötigen, mit denen Sie auf alle Kundenkonten in einem Verwaltungskonto zugreifen können, müssen Sie das Aktualisierungstoken für das Verwaltungskonto abrufen. Weitere Informationen finden Sie in unseren Leitfäden zu Zugriffs- 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 verknüpft, in der sich das Google Cloud-Projekt befindet, mit dem ursprünglich Anfragen gestellt wurden.
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.
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 es 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 im Hilfeartikel Ein aufgelöstes Google Ads-Konto wieder aktivieren.
Tipps zur Vermeidung
Du kannst proaktiv prüfen, ob ein Kundenkonto deaktiviert ist, indem du nach dem Status CANCELLED (STORNIERT) suchst.
DEVELOPER_TOKEN_NOT_APPROVED
Zusammenfassung
Das Entwicklertoken ist nur für die Verwendung mit Testkonten genehmigt und es wurde versucht, auf ein Nicht-Testkonto zuzugreifen.
Häufige Ursachen
Ein Test-Entwicklertoken wurde verwendet, um auf ein Nicht-Testkonto zuzugreifen.
Das Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig.
Häufige Ursachen
Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token aus einem einzigen Verwaltungskonto verknüpft werden. Sobald Sie eine Google Ads API-Anfrage gesendet haben, 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 einen DEVELOPER_TOKEN_PROHIBITED-Fehler.
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 das Google Ads API-Anfragen mit dem Token des neuen Verwaltungskontos gesendet werden.
USER_PERMISSION_DENIED
Zusammenfassung
Der autorisierte Kunde hat keinen Zugriff auf den Betreiberkunden.
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 ID des Verwaltungskontos ohne Bindestriche (-) an. Clientbibliotheken bieten eine integrierte Unterstützung dafür.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-06-12 (UTC)."],[[["This page provides solutions and preventative measures for common Google Ads API errors."],["For a comprehensive list of errors, refer to the dedicated error references section."],["Additional assistance and community support can be found on the Google Ads API forum."],["Understanding and addressing these errors is crucial for successful API integration and campaign management."]]],[]]