Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der Google Advertising and Measurement Community beitreten.
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 ausgegeben. 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.
Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden.
Häufige Ursachen
Sie versuchen, andere Attribute als status der Anzeige zu ändern.
Vorgehensweise
–
Tipps zur Vermeidung
Nachdem eine Anzeige erstellt wurde, kann sie nicht mehr geändert werden. Wenn Sie Änderungen vornehmen möchten, müssen Sie eine neue Anzeige erstellen und die alte Anzeige entfernen. Die status der Anzeige kann jedoch mit MutateAdGroupAds geändert werden.
INVALID_INPUT
Zusammenfassung
Eines der Felder in einer Anzeige enthält ungültige Zeichen.
Häufige Ursachen
Sonderzeichen in URLs verwenden
Vorgehensweise
–
Tipps zur Vermeidung
Validieren Sie URLs in Ihrer App, bevor Sie die API-Anfrage senden.
Eine Anzeigengruppe wird hinzugefügt oder umbenannt, aber der Name wird bereits für eine andere Anzeigengruppe verwendet.
Häufige Ursachen
Sie erstellen eine neue Anzeigengruppe mit dem Namen einer vorhandenen aktiven oder pausierten Anzeigengruppe.
Vorgehensweise
Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Optional können Sie einen eindeutigen Anzeigengruppennamen vorschlagen oder die Liste der verwendeten Namen anzeigen.
Zwei Vorgänge in einer einzelnen Anfrage enthalten einen Erstellungsvorgang für ein Asset mit denselben Binärdaten.
Häufige Ursachen
Eine Mutate-Anfrage mit doppelten Create-Vorgängen, die dieselben Binärdaten enthalten.
Vorgehensweise
Erstellen Sie das Asset in einer separaten Anfrage und verweisen Sie dann in der nachfolgenden Anfrage darauf. Alternativ können Sie in derselben Anfrage eine temporäre ID verwenden.
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 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, 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
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.
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 beim Senden 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, für die das Token des neuen Verwaltungskontos verwendet wird.
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.
Der Gebotswert ist kein genaues Vielfaches der Mindesteinheit der Währung des Kontos. Ein Gebot von 0, 015 $ (15000 Mikros) ist beispielsweise ungültig.
Häufige Ursachen
–
Vorgehensweise
–
Tipps zur Vermeidung
Prüfen Sie, ob die Gebote Vielfache der Mindesteinheit für die Währung des Kontos sind.
BID_TOO_BIG
Zusammenfassung
Der Fehler wird zurückgegeben, obwohl das Gebot im Rahmen des Kampagnenbudgets liegt.
Prüfen Sie, ob der Budgetbetrag größer oder gleich der Mindesteinheit für die Währung des Kontos ist.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
Zusammenfassung
Der Budgetbetrag hat nach der Umrechnung von einem Mikrobearbeitungsbetrag in einen Betrag in der Währung des Kontos zu viele signifikante Dezimalstellen.
Häufige Ursachen
–
Vorgehensweise
–
Tipps zur Vermeidung
Prüfen Sie, ob der Budgetbetrag durch die Mindesteinheit für die Währung des Kontos teilbar ist.
Eine Kampagne wird hinzugefügt oder umbenannt, aber der Name wird bereits für eine andere Kampagne verwendet.
Häufige Ursachen
Erstellung einer neuen Kampagne mit dem Namen einer vorhandenen aktiven oder pausierten Kampagne
Vorgehensweise
Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Optional können Sie einen eindeutigen Kampagnennamen vorschlagen oder die Liste der verwendeten Namen anzeigen.
Die Anfrage enthält zwei identische und redundante Parameter.
Häufige Ursachen
–
Vorgehensweise
–
Tipps zur Vermeidung
Entfernen Sie Duplikate (Vorgänge, Parameter, Listenelemente), bevor Sie die Anfrage stellen. Suchen Sie nach Feldern mit der Einschränkung DistinctElements.
Bei der Anfrage ist eine Zeitüberschreitung aufgetreten und sie konnte nicht schnell genug abgeschlossen werden, um eine Antwort zurückzugeben.
Häufige Ursachen
Es wurde eine Suchanfrage gestellt, die eine zu große Antwort generiert hat, oder eine Mutate-Anfrage war zu groß für die Verarbeitung.
Vorgehensweise
Warten Sie etwa 30 Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin auftritt, versuchen Sie, die Anfrage in mehrere kleinere Anfragen aufzuteilen, die schneller abgeschlossen werden können.
Bei der Verarbeitung der Anfrage ist ein unerwartetes Ereignis aufgetreten.
Häufige Ursachen
Die API funktioniert aufgrund eines Fehlers nicht richtig.
Vorgehensweise
Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie für die Wiederholungen einen exponentiellen Backoff.
Tipps zur Vermeidung
–
TRANSIENT_ERROR
Zusammenfassung
Ein vorübergehender interner Fehler ist aufgetreten. Bitte versuchen Sie es noch einmal.
Häufige Ursachen
Dieser Fehler tritt auf, wenn in der API intern ein vorübergehendes Problem auftritt.
Vorgehensweise
Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie für die Wiederholungen einen exponentiellen Backoff.
Tipps zur Vermeidung
–
InvalidGrantError
invalid_grant (malformed auth code)
Zusammenfassung
Der Autorisierungscode, der gegen OAuth-Tokens eingetauscht wurde, war fehlerhaft.
Häufige Ursachen
Dies geschieht, wenn versucht wird, ein Aktualisierungstoken für einen Nutzer zu generieren, dem bereits Zugriff auf die anfragende Anwendung gewährt wurde. Das kann beispielsweise passieren, wenn Sie das Beispiel zum Generieren von Nutzeranmeldedaten mehrmals für dieselben OAuth-Clientanmeldedaten und denselben autorisierten Nutzer ausführen.
Vorgehensweise
Wenn Sie ein Aktualisierungstoken für eine bestimmte Kombination aus autorisierendem Nutzer und OAuth-Client-Anmeldedaten neu generieren möchten, widerrufen Sie ein vorhandenes Aktualisierungstoken. Wenn Sie ein Token widerrufen, kann es nicht mehr für den Google Ads API-Zugriff verwendet werden. Außerdem werden alle Zugriffstokens ungültig, die mit dem Aktualisierungstoken generiert wurden.
Tipps zur Vermeidung
Bewahren Sie Ihr Aktualisierungstoken an einem sicheren Ort auf, damit es nicht neu generiert werden muss.
Die Anfrage bezog sich auf eine Ressource, die nicht gefunden werden konnte.
Häufige Ursachen
In der Anfrage wurde versucht, eine Ressource zu ändern oder darauf zu verweisen, die nicht vorhanden ist oder entfernt wurde. Oder der angegebene Ressourcenname für die Ressource ist falsch formatiert.
Vorgehensweise
Verwenden Sie eine Suchanfrage, um den Ressourcennamen für eine vorhandene Ressource abzurufen, bevor Sie eine Mutierungsanfrage senden. In unseren Clientbibliotheksleitfäden finden Sie eine Dokumentation dazu, wie Sie in jeder unterstützten Sprache gültige Ressourcennamen erstellen.
Tipps zur Vermeidung
Erstellen Sie Ressourcennamen nicht manuell. Verwenden Sie eine der Hilfsmethoden, die von unseren Clientbibliotheken angeboten werden.
Mit der Anfrage wird versucht, eine Ressource zu erstellen, durch die die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreiten würde.
Häufige Ursachen
Es gibt mehrere Beschränkungen für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können.
Vorgehensweise
Sehen Sie in den Systemlimits nach, welches Limit erreicht wurde. Entweder verwenden Sie eine vorhandene Ressource wieder oder Sie entfernen Ressourcen, um Platz für neue zu schaffen.
Tipps zur Vermeidung
Mit Suchanfragen können Sie die Anzahl der Ressourcen mit Einschränkungen im Blick behalten.
[[["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-07-13 (UTC)."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
