Seien Sie am 15. Oktober um 16:00 Uhr live auf dem Discord-Server der Google Advertising and Measurement Community und auf YouTube dabei. Wir sprechen über die neuen Funktionen in Version 26 der Google Ads API.
Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.
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 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 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.
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 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 nach 7 Tagen abläuft.
Dieser Operator kann nicht mit einer Unterklasse von „Ad“ verwendet werden.
Häufige Ursachen
Es wird versucht, 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 verweisen Sie 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.
Gegenargument
–
Tipps zur Vermeidung
Die Zweitkundennummer ist für alle Aufrufe erforderlich. Sie muss im HTTP-Header angegeben werden. Wir empfehlen, unsere Clientbibliotheken zu verwenden, da sie diese Aufgabe 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, 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.
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 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
Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, aber ohne Angabe von login-customer-id in der Anfrage.
Gegenargument
–
Tipps zur Vermeidung
Geben Sie die login-customer-id als Verwaltungskonto-ID ohne Bindestriche an (-). Clientbibliotheken bieten integrierte Unterstützung dafür.
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. Optional können Sie einen eindeutigen Kampagnennamen vorschlagen oder die Liste der verwendeten Namen anzeigen.
Tipps zur Vermeidung
–
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Zusammenfassung
Versuch, 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 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“.
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.
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 Mutationsanfrage war zu groß, um verarbeitet zu werden.
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 Ihr 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 existiert 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 Beschränkungen 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-14 (UTC)."],[],[]]
