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 der Fehlerreferenz, im Leitfaden zu API-Fehlern oder im Leitfaden zu Fehlertypen. Wenn Sie weitere Unterstützung benötigen, wenden Sie sich bitte an den Google Ads API-Support.

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. 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. Tipps zur Vermeidung Weitere Informationen finden Sie unter Nicht überprüfte Apps.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Zusammenfassung 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.
LINE_TOO_WIDE	Zusammenfassung Eines der Felder in einer Anzeige war länger als die maximal zulässige Länge. Weitere Informationen zu Textanzeigen Häufige Ursachen Zu lange Textzeilen. Gegenargument – Tipps zur Vermeidung Prüfen Sie die Länge der Zeile, bevor Sie die API-Anfrage stellen.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Zusammenfassung Dieses Label ist bereits einigen der Anzeigen zugeordnet. Häufige Ursachen Sie versuchen, das Label Anzeigen zuzuordnen, denen es bereits zugeordnet ist. Gegenargument – Tipps zur Vermeidung Prüfen Sie zuerst, ob das hinzuzufügende Label bereits mit den Anzeigen verknüpft ist.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Zusammenfassung Ein Vorgang hat versucht, eine nicht mehr vorhandene Anzeige zu aktualisieren. Häufige Ursachen Sobald eine Anzeige entfernt wurde, kann sie nicht mehr aktualisiert werden. Das gilt auch für Änderungen am Status. Gegenargument – Tipps zur Vermeidung Achten Sie darauf, dass mit dem Code nicht versucht wird, nicht mehr vorhandene Anzeigen zu aktualisieren.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Zusammenfassung Der Keyword-Text enthält ungültige Zeichen. Weitere Informationen zum Hinzufügen von Keywords Häufige Ursachen Der Keyword-Text enthält ungültige Zeichen. Gegenargument – Tipps zur Vermeidung Validieren Sie den Keyword-Text in Ihrer App, bevor Sie eine Anfrage an die API senden.

AdGroupError

DUPLICATE_ADGROUP_NAME

Zusammenfassung 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. Tipps zur Vermeidung –

AssetError

DUPLICATE_ASSET

Zusammenfassung 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. Tipps zur Vermeidung –

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Zusammenfassung Die Kundennummer ist keine Zahl. Häufige Ursachen Es wird eine falsche Zweitkundennummer verwendet. Gegenargument – 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. 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.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Zusammenfassung 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.) Gegenargument Wenn Sie Tests durchführen, muss Ihre Anfrage auf ein Testkonto ausgerichtet sein. Wenn Sie auf ein Google Ads-Produktionskonto zugreifen möchten, prüfen Sie die Zugriffsebene Ihres Google Cloud-Projekts auf der Übersichtsseite der Google Ads API und aktualisieren Sie die Zugriffsebene Ihres Projekts auf „Explorer“, „Basic“ oder „Standard“. Tipps zur Vermeidung –
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. 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.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Zusammenfassung Der Gebotswert ist kein genaues Vielfaches der Mindesteinheit der Kontowährung. Ein Gebot von 0, 015 $ (15000 in Mikros) ist beispielsweise ungültig. Häufige Ursachen – Gegenargument – Tipps zur Vermeidung Prüfen Sie, ob die Gebote ein Vielfaches 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. Häufige Ursachen – Gegenargument – Tipps zur Vermeidung Prüfen Sie, ob das Konto am Google Ad Grants-Programm teilnimmt. Wenn ja, beschränken Sie die CPC-Gebote auf den vom Programm vorgeschriebenen Höchstbetrag.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Zusammenfassung Der Budgetbetrag ist zu niedrig. Häufige Ursachen – Gegenargument – Tipps zur Vermeidung Der Budgetbetrag muss größer oder gleich der Mindesteinheit für die Währung des Kontos sein.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Zusammenfassung Der Budgetbetrag hat nach der Umrechnung von einem Mikrobearbeitungsbetrag in die Währung des Kontos zu viele signifikante Dezimalstellen. Häufige Ursachen – Gegenargument – Tipps zur Vermeidung Prüfen Sie, ob der Budgetbetrag durch die Mindesteinheit für die Währung des Kontos teilbar ist.

CampaignError
DUPLICATE_CAMPAIGN_NAME	Zusammenfassung 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“.

CriterionError
KEYWORD_HAS_INVALID_CHARS	Zusammenfassung Keywords mit ungültigen Zeichen hinzufügen oder bearbeiten Häufige Ursachen Verwenden Sie Sonderzeichen wie ! @ % * in den Keywords. Gegenargument – Tipps zur Vermeidung Achten Sie darauf, in den Keywords keine unzulässigen Zeichen zu verwenden. Weitere Informationen

DistinctError
DUPLICATE_ELEMENT	Zusammenfassung 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.

InternalError
DEADLINE_EXCEEDED	Zusammenfassung 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. Tipps zur Vermeidung Lesen Sie den Abschnitt Segmentierung, um zu erfahren, wie sich die Segmentierung auf die Größe einer Antwort auswirken kann. Beachten Sie die Einschränkungen der gRPC-Transportschicht.
INTERNAL_ERROR	Zusammenfassung 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.

MutateError

RESOURCE_NOT_FOUND

Zusammenfassung 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.

NotEmptyError
EMPTY_LIST	Zusammenfassung Eine erforderliche Liste ist leer. Häufige Ursachen Eine leere Liste von Vorgängen an eine mutate-Methode übergeben. Gegenargument – Tipps zur Vermeidung –

QuotaError
RESOURCE_EXHAUSTED	Zusammenfassung Eine Häufigkeitsbegrenzung des Systems wurde überschritten. Häufige Ursachen – Gegenargument – Tipps zur Vermeidung Richten Sie kurze Verzögerungen zwischen Anfragen ein oder kombinieren Sie mehr Vorgänge in weniger Anfragen.

RangeError
TOO_LOW	Zusammenfassung Ein Wert lag unter dem zulässigen Mindestwert. Häufige Ursachen Sie vergessen, eine ID anzugeben, was dazu führt, dass der Wert 0 übergeben wird. Gegenargument – Tipps zur Vermeidung Beachten Sie die Informationen zu Bereichseinschränkungen in der API-Referenz.

RequestError
INVALID_INPUT	Zusammenfassung Die Anfrage ist falsch formatiert. Häufige Ursachen Die URL oder der Inhalt der Anfrage ist fehlerhaft. Gegenargument – Tipps zur Vermeidung –
REQUIRED_FIELD_MISSING	Zusammenfassung In der Anfrage fehlen erforderliche Informationen. Häufige Ursachen Beim Hinzufügen einer Einheit fehlen Pflichtfelder. Gegenargument Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Das Attribut fieldPath des Fehlers gibt an, welches Feld fehlt. Tipps zur Vermeidung In der API-Referenz finden Sie Informationen dazu, welche Felder erforderlich sind.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Zusammenfassung 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.

StringLengthError
TOO_LONG	Zusammenfassung Der dem angegebenen Feld zugewiesene String ist länger als das Limit. Häufige Ursachen Anzeigentitel oder Textzeilen für Anzeigen enthalten zu viel Text. Gegenargument Ermitteln Sie das Limit , das erreicht wurde, ändern Sie den String entsprechend und senden Sie die Anfrage noch einmal. Tipps zur Vermeidung Beachten Sie die Längenbeschränkungen für Strings.