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 einem anderen Satz von 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 den 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.
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 und den Veröffentlichungsstatus „Testing“ konfiguriert ist, 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 ausgegeben. 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.
Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden.
Häufige Ursachen
Versuch, andere Attribute als die status der Anzeige zu ändern.
Gegenargument
–
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. Der 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
Gegenargument
–
Tipps zur Vermeidung
Validieren Sie URLs in Ihrer App, bevor Sie die API-Anfrage stellen.
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.
Gegenargument
Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Schlagen Sie optional einen eindeutigen Namen für die Anzeigengruppe vor oder zeigen Sie die Liste der verwendeten Namen an.
Zwei Vorgänge in einer einzelnen Anfrage enthalten einen Erstellungsvorgang für ein Asset mit denselben Binärdaten.
Häufige Ursachen
Eine Mutationsanfrage mit doppelten Erstellungsvorgängen, die dieselben Binärdaten enthalten.
Gegenargument
Erstellen Sie das Asset in einer separaten Anfrage und verknüpfen Sie es in der nachfolgenden Anfrage oder verwenden Sie eine temporäre ID in derselben Anfrage.
Tipps zur Vermeidung
–
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
Zusammenfassung
Die Angebots-ID des Partners verwendet eine oneof-Variante (int_value oder string_value), die von der Angebotsintegration des Kontos nicht akzeptiert wird.
Häufige Ursachen
Das Feld promotion_asset.external_redeem_info.partner_promotion_id.int_value wird festgelegt, wenn für die Einlösungsintegration des Kunden die Variante string_value erforderlich ist, oder das Feld string_value wird festgelegt, wenn für die Integration die Variante int_value erforderlich ist.
Gegenargument
Aktualisieren Sie die Erstellungsanfrage, um die Variante ExternalPartnerId (int_value oder string_value) einzufügen, die von der Angebotsintegration des Kontos akzeptiert wird. Weitere Informationen finden Sie unter Einlösungen externer Werbeaktionen erfassen.
Tipps zur Vermeidung
Prüfen Sie, welches Format für die Angebots-ID (int_value oder string_value) Ihre Integration für die Einlösung am Point of Sale (POS) verwendet, bevor Sie eine PromotionAsset-Nachricht mit dem Feld external_redeem_info erstellen.
Die Kundennummer wurde im HTTP-Header nicht angegeben.
Häufige Ursachen
Im HTTP-Header wird keine Kundennummer des Kunden 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.
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.)
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
Sie authentifizieren sich als Nutzer mit Zugriff auf ein Verwaltungskonto, geben aber in der Anfrage nicht login-customer-id an.
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.
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
Gegenargument
Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Schlagen Sie optional einen eindeutigen Kampagnennamen vor oder zeigen Sie die Liste der verwendeten Namen an.
Tipps zur Vermeidung
–
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Zusammenfassung
Es wird versucht, die Einstellung für die Keyword-Option auf Kampagnenebene für eine Kampagne mit aktiviertem AI Max zu ändern.
Häufige Ursachen
Wenn AI Max aktiviert ist, werden die Einstellungen für weitgehend passende Keywords auf Kampagnenebene nicht mehr unterstützt, da alle Keywords standardmäßig als weitgehend passend behandelt werden. Wenn Sie versuchen, dieses Feld festzulegen oder zu ändern, wird der Fehler ausgelöst.
Gegenargument
Raten Sie dem Nutzer, den Parameter „disable_search_term_matching“ auf Anzeigengruppenebene zu verwenden, anstatt „Weitgehend passend“ auf Kampagnenebene festzulegen.
Tipps zur Vermeidung
Vermeiden Sie es, „keyword_match_type“ in der Kampagne auf „BROAD“ (oder einen anderen Wert) festzulegen, wenn „ai_max_setting.enable_ai_max“ auf „true“ gesetzt ist. Aktivieren oder deaktivieren Sie den Suchanfragen-Abgleich auf Anzeigengruppenebene mit „disable_search_term_matching“.
Eine migrierte Demand Gen-Kampagne kann erst aktiviert werden, wenn die ursprüngliche Kampagne entfernt wurde oder wenn keine andere migrierte Kampagne für dieselbe ursprüngliche Kampagne bereits aktiv ist.
Häufige Ursachen
Der status einer migrierten Demand Gen-Kampagne wird auf ENABLED aktualisiert, wenn entweder die ursprüngliche Quellkampagne nicht entfernt wurde oder eine andere Demand Gen-Kampagne, die aus derselben ursprünglichen Kampagne migriert wurde, bereits den Status ENABLED hat. In API-Versionen bis v25 gibt diese Bedingung RequestError.UNKNOWN zurück.
Gegenargument
Entfernen Sie die ursprüngliche Quellkampagne mit CampaignOperation.remove (entweder vorher oder in derselben Mutationsanfrage), bevor Sie die migrierte Demand Gen-Kampagne aktivieren. Prüfen Sie außerdem, ob keine andere Demand Gen-Kampagne, die aus derselben ursprünglichen Kampagne migriert wurde, aktiv ist. Weitere Informationen finden Sie unter Migrierte Kampagnen aktivieren.
Tipps zur Vermeidung
Wenn Sie die IDs Ihrer ursprünglichen Quellkampagnen und der migrierten Demand Gen-Kampagnen erfassen, fragen Sie campaign.status ab, bevor Sie status für eine migrierte Kampagne auf ENABLED setzen, oder fügen Sie CampaignOperation.remove für die ursprüngliche Kampagne in dieselbe Mutationsanfrage ein.
Die Anfrage enthält zwei identische und redundante Parameter.
Häufige Ursachen
–
Gegenargument
–
Tipps zur Vermeidung
Entfernen Sie Duplikate (Vorgänge, Parameter, Listenelemente), bevor Sie die Anfrage stellen. Suchen Sie nach Feldern mit der Einschränkung DistinctElements.
Die Anfrage wurde nicht innerhalb des Zeitlimits abgeschlossen und konnte nicht schnell genug bearbeitet werden, um eine Antwort zurückzugeben.
Häufige Ursachen
Es wurde eine Suchanfrage gestellt, die eine zu große Antwort generiert hat, oder eine Mutationsanfrage war zu groß für die Verarbeitung.
Gegenargument
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.
Gegenargument
Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen.
Tipps zur Vermeidung
–
TRANSIENT_ERROR
Zusammenfassung
Ein vorübergehender interner Fehler ist aufgetreten. Versuchen Sie es noch einmal.
Häufige Ursachen
Dieser Fehler tritt auf, wenn die API intern ein vorübergehendes Problem feststellt.
Gegenargument
Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen.
Tipps zur Vermeidung
–
InvalidGrantError
invalid_grant (malformed auth code)
Zusammenfassung
Der Autorisierungscode, der gegen OAuth-Tokens ausgetauscht 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 autorisierenden Nutzer ausführen.
Gegenargument
Wenn Sie ein Aktualisierungstoken für eine bestimmte Kombination aus autorisierendem Nutzer und OAuth-Client-Anmeldedaten neu generieren möchten, müssen Sie ein vorhandenes Aktualisierungstoken widerrufen. Wenn Sie ein Token widerrufen, kann es nicht mehr für den Zugriff auf die Google Ads API verwendet werden. Außerdem werden alle Zugriffstokens ungültig, die mit dem Aktualisierungstoken generiert wurden.
Tipps zur Vermeidung
Bewahren Sie das Aktualisierungstoken an einem sicheren Ort auf, damit Sie es nicht neu generieren müssen.
Die Anfrage bezog sich auf eine Ressource, die nicht gefunden werden konnte.
Häufige Ursachen
Mit der Anfrage wurde versucht, eine Ressource zu ändern oder anderweitig darauf zu verweisen, die nicht vorhanden ist oder entfernt wurde. Oder der angegebene Ressourcenname für die Ressource ist fehlerhaft.
Gegenargument
Verwenden Sie eine Suchanfrage, um den Ressourcennamen für eine vorhandene Ressource abzurufen, bevor Sie eine Mutationsanfrage senden. Lesen Sie unsere Leitfäden zur Clientbibliothek. Dort finden Sie Informationen zum Erstellen gültiger Ressourcennamen in allen unterstützten Sprachen.
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, die dazu führen würde, dass die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreitet.
Häufige Ursachen
Es gibt mehrere Limits für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können.
Gegenargument
Ermitteln Sie das Limit, das erreicht wird, indem Sie die Systemlimits prüfen. Verwenden Sie entweder eine vorhandene Ressource wieder oder entfernen Sie Ressourcen, um Platz für neue zu schaffen.
Tipps zur Vermeidung
Verwenden Sie Suchanfragen, um die Anzahl der Ressourcen mit Einschränkungen zu überwachen.
[[["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: 2026-10-29 (UTC)."],[],[]]
