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 den Fehlerreferenzen. Weitere Unterstützung erhalten Sie in unserem Forum.

google.auth.exceptions.RefreshError

invalid_grant

Zusammenfassung Das Token ist abgelaufen oder wurde widerrufen. Allgemeine Ursachen Einem Google Cloud Platform-Projekt mit einem für einen externen Nutzertyp konfigurierten OAuth-Zustimmungsbildschirm und dem Veröffentlichungsstatus Testing wird ein Aktualisierungstoken ausgestellt, das in 7 Tagen abläuft. Vorgehensweise Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Das Aktualisierungstoken läuft also alle 7 Tage ab und es wird der Fehler invalid_grant angezeigt. Gehen Sie in der Google API Console zum OAuth-Zustimmungsbildschirm. Ändern Sie anschließend den Veröffentlichungsstatus in In production. Folgen Sie dazu dieser Anleitung, damit das Aktualisierungstoken nicht in 7 Tagen abläuft. Tipps zur Prävention Weitere Informationen finden Sie im Hilfeartikel Nicht überprüfte Apps.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Zusammenfassung Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden. Allgemeine Ursachen Es wird versucht, andere Attribute als status der Anzeige zu ändern. Vorgehensweise – Tipps zur Prävention 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 mithilfe von MutateAdGroupAds geändert werden.
INVALID_INPUT	Zusammenfassung Eines der Felder in einer Anzeige enthält ungültige Zeichen. Allgemeine Ursachen Verwendung von Sonderzeichen in URLs. Vorgehensweise – Tipps zur Prävention Prüfen Sie URLs in Ihrer App, bevor Sie die API-Anfrage stellen.
LINE_TOO_WIDE	Zusammenfassung Eines der Felder in einer Anzeige hat die maximal zulässige Länge überschritten. Weitere Informationen zu Textanzeigen Allgemeine Ursachen Eine zu lange Textzeile. Vorgehensweise – Tipps zur Prävention Überprüfen Sie die Zeilenlänge, bevor Sie die API-Anfrage stellen.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Zusammenfassung Dieses Label ist einigen Anzeigen bereits zugeordnet. Allgemeine Ursachen Es wird versucht, das Label Anzeigen zuzuordnen, die bereits verknüpft wurden. Vorgehensweise – Tipps zur Prävention 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. Allgemeine Ursachen Nachdem eine Anzeige entfernt wurde, kann sie nicht mehr aktualisiert werden. Dies gilt auch für Änderungen am Status. Vorgehensweise – 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 finden Sie unter Keywords hinzufügen. Allgemeine Ursachen Der Keyword-Text enthält ungültige Zeichen. Vorgehensweise – Tipps zur Prävention Überprüfen 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. Allgemeine Ursachen Sie erstellen eine neue Anzeigengruppe mit dem Namen einer vorhandenen aktiven oder pausierten Anzeigengruppe. Vorgehensweise Protokollieren Sie den Fehler und senden Sie eine Fehlermeldung an den Nutzer. Schlagen Sie dabei entweder einen eindeutigen Anzeigengruppennamen vor oder zeigen Sie die Liste der verwendeten Namen. Tipps zur Prävention –

AssetError

DUPLICATE_ASSET

Zusammenfassung Zwei Vorgänge in einer einzelnen Anfrage enthalten einen Erstellungsvorgang für ein Asset mit denselben Binärdaten. Allgemeine Ursachen Eine mutate-Anfrage mit duplizierten Erstellungsvorgängen, die dieselben Binärdaten enthalten Vorgehensweise Erstellen Sie das Asset in einer separaten Anfrage und verknüpfen Sie es dann in der nachfolgenden Anfrage. Alternativ können Sie innerhalb derselben Anfrage eine temporäre ID verwenden. Tipps zur Prävention –

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Zusammenfassung Die Kundennummer ist keine Zahl. Allgemeine Ursachen Sie verwenden eine falsche Client-Kundennummer. Vorgehensweise – Tipps zur Prävention 123-456-7890 sollte 1234567890 sein. Weitere Informationen
CLIENT_CUSTOMER_ID_IS_REQUIRED	Zusammenfassung Die Kundennummer wurde im HTTP-Header nicht angegeben. Allgemeine Ursachen Keine Client-Kundennummer im HTTP-Header angegeben. Vorgehensweise – Tipps zur Prävention Die Client-Kundennummer ist für alle Aufrufe erforderlich. Geben Sie daher eine Kundennummer im HTTP-Header an. Sie können dafür unsere Clientbibliotheken verwenden.
CUSTOMER_NOT_FOUND	Zusammenfassung Es wurde kein Konto mit der im Header angegebenen Kundennummer gefunden. Allgemeine Ursachen Es wird versucht, 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. Allgemeine Ursachen Das Zugriffstoken ist ungültig geworden. Vorgehensweise Fordern Sie ein neues Token an. Wenn Sie eine unserer Client-Bibliotheken verwenden, lesen Sie in der zugehörigen Dokumentation nach, wie Sie das Token aktualisieren. Tipps zur Prävention Bewahren Sie Zugriffstoken auf und verwenden Sie sie wieder, bis sie ablaufen.
NOT_ADS_USER	Zusammenfassung Das zum Generieren des Zugriffstokens verwendete Google-Konto ist mit keinem Google Ads-Konto verknüpft. Allgemeine 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 (normalerweise das Verwaltungskonto). Sie können dem Google-Konto auch Zugriff auf ein bestehendes Google Ads-Konto gewähren. 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 Prävention –
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 Prävention 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 eines Verwaltungskontos benötigen, benötigen Sie das Aktualisierungstoken für das Verwaltungskonto. Weitere Informationen finden Sie in unserem Leitfaden zu Zugriffstokens und Aktualisierungstokens und OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED	Zusammenfassung Auf das Kundenkonto kann nicht zugegriffen werden, da es nicht aktiviert ist. Allgemeine Ursachen Dieser Fall tritt auf, wenn die Registrierung des Kundenkontos noch nicht abgeschlossen ist oder deaktiviert wurde. Vorgehensweise Melden Sie sich in der Google Ads-Benutzeroberfläche an und vergewissern Sie sich, dass 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 Prävention Sie können proaktiv prüfen, ob ein Kundenkonto deaktiviert wurde, indem Sie nach dem Status CANCELLED suchen.
DEVELOPER_TOKEN_NOT_APPROVED	Zusammenfassung Das Entwickler-Token ist nur für die Verwendung mit Testkonten freigegeben und es wird versucht, auf ein Konto zuzugreifen, das kein Testkonto ist. Allgemeine Ursachen Ein Testentwickler-Token wurde für den Zugriff auf ein Konto verwendet, das kein Testkonto ist. Vorgehensweise Stellen Sie sicher, dass Sie tatsächlich auf ein Konto zugreifen möchten, das kein Testkonto ist. In diesem Fall müssen Sie ein Upgrade Ihres Entwicklertokens auf Standard- oder Basiszugriff beantragen. Tipps zur Prävention –
DEVELOPER_TOKEN_PROHIBITED	Zusammenfassung Das Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig. Allgemeine Ursachen Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token eines einzigen Verwaltungskontos verknüpft werden. Wenn Sie eine Google Ads API-Anfrage stellen, ist das Entwickler-Token dauerhaft mit dem Google API Console-Projekt gekoppelt. Falls Sie kein neues Google API Console-Projekt verwenden, erhalten Sie beim Senden einer Anfrage den Fehler DEVELOPER_TOKEN_PROHIBITED. Vorgehensweise – Tipps zur Prävention Wenn Sie unter einem neuen Verwaltungskonto zu einem Entwickler-Token wechseln, müssen Sie für Google Ads API-Anfragen, in denen das Token des neuen Administrators verwendet wird, ein neues Google API Console-Projekt erstellen.
USER_PERMISSION_DENIED	Zusammenfassung Der autorisierte Kunde hat keinen Zugriff auf den Betreiberkunden. Allgemeine Ursachen Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, aber ohne login-customer-id in der Anfrage. Vorgehensweise – Tipps zur Prävention Geben Sie login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Clientbibliotheken unterstützen dies.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Zusammenfassung Der Gebotswert ist kein genaues Vielfaches der Mindesteinheit der Kontowährung. 0, 015 € (15000 in Mikros) ist beispielsweise kein gültiges Gebot. Allgemeine Ursachen – Vorgehensweise – Tipps zur Prävention Stellen Sie sicher, dass Gebote ein Vielfaches der Mindesteinheit der Kontowährung sind.
BID_TOO_BIG	Zusammenfassung Der Fehler wird zurückgegeben, obwohl das Gebot im Rahmen des Kampagnenbudgets liegt. Häufige Ursachen – Vorgehensweise – Tipps zur Prävention Überprüfen Sie, ob das Konto für Google Ad Grants aktiviert ist. Sollte dies der Fall sein, beschränken Sie die CPC-Gebote auf den im Programm zulässigen Höchstbetrag.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Zusammenfassung Der Budgetbetrag ist zu niedrig. Häufige Ursachen – Vorgehensweise – Tipps zur Prävention Der Budgetbetrag muss mindestens der Mindesteinheit der Kontowährung entsprechen.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Zusammenfassung Wenn der Budgetbetrag von einem Mikrobetrag in einen Betrag in der Kontowährung umgerechnet wird, hat er zu viele signifikante Dezimalstellen. Allgemeine Ursachen – Vorgehensweise – Tipps zur Prävention Der Budgetbetrag muss durch die Mindesteinheit der Kontowährung geteilt werden können.

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 Vorgehensweise Protokollieren Sie den Fehler und senden Sie eine Fehlermeldung an den Nutzer. Schlagen Sie dabei entweder einen eindeutigen Kampagnennamen vor oder zeigen Sie die Liste der verwendeten Namen. Tipps zur Prävention –

CriterionError
KEYWORD_HAS_INVALID_CHARS	Zusammenfassung Hinzufügen oder Bearbeiten von Keywords, die ungültige Zeichen enthalten Allgemeine Ursachen Verwenden Sie in den Keywords Sonderzeichen wie ! @ % *. Vorgehensweise – Tipps zur Prävention Achten Sie darauf, in den Keywords keine unzulässigen Zeichen zu verwenden. Weitere Informationen finden Sie unter Keywords hinzufügen.

DistinctError
DUPLICATE_ELEMENT	Zusammenfassung Die Anfrage enthält zwei identische und redundante Parameter. Häufige Ursachen – Vorgehensweise – Tipps zur Prävention Entfernen Sie doppelte Vorgänge, Parameter und 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. Allgemeine Ursachen Eine Suchanfrage hat eine zu große Antwort generiert oder eine mutate-Anfrage war zu groß und konnte nicht verarbeitet werden. 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. Tipps zur Prävention Im Abschnitt Segmentierung erfahren Sie, 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. Allgemeine Ursachen Die API funktioniert aufgrund eines Fehlers nicht richtig. Vorgehensweise Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen. Tipps zur Prävention –
TRANSIENT_ERROR	Zusammenfassung Ein vorübergehender interner Fehler ist aufgetreten und Sie sollten es noch einmal versuchen. Allgemeine 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 dabei einen exponentiellen Backoff-Zeitplan für die Wiederholungen. Tipps zur Prävention –

InvalidGrantError

invalid_grant (malformed auth code)

Zusammenfassung Der für OAuth-Tokens ausgetauschte Autorisierungscode war fehlerhaft. Allgemeine 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 zum Autorisieren des Nutzers ausführen. Vorgehensweise Um ein Aktualisierungstoken für eine bestimmte Kombination aus Nutzer- und OAuth-Clientanmeldedaten neu zu generieren, entfernen 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 Prävention Bewahren Sie das Aktualisierungstoken an einem sicheren Ort auf, damit es nicht noch einmal generiert werden muss.

MutateError

RESOURCE_NOT_FOUND

Zusammenfassung Die Anfrage hat auf eine Ressource verwiesen, die nicht gefunden wurde. Allgemeine Ursachen In der Anfrage wurde versucht, eine Ressource zu ändern oder anderweitig auf eine Ressource zu verweisen, die nicht vorhanden ist oder entfernt wurde. Oder der angegebene Ressourcenname für die Ressource ist fehlerhaft. Vorgehensweise Verwenden Sie eine Suchanfrage, um den Ressourcennamen einer vorhandenen Ressource abzurufen, bevor Sie eine mutate-Anfrage senden. Lesen Sie unsere Leitfäden zur Clientbibliothek. Darin finden Sie auch Informationen zur Erstellung gültiger Ressourcennamen in jeder unterstützten Sprache. Tipps zur Prävention Erstellen Sie Ressourcennamen nicht manuell. Verwenden Sie eine der Hilfsmethoden, die in unseren Clientbibliotheken angeboten werden.

NotEmptyError
EMPTY_LIST	Zusammenfassung Eine erforderliche Liste ist leer. Allgemeine Ursachen Übergeben einer leeren Liste von Vorgängen an eine mutate-Methode Vorgehensweise – Tipps zur Vermeidung –

QuotaError
RESOURCE_EXHAUSTED	Zusammenfassung Eine Häufigkeitsbegrenzung des Systems wurde überschritten. Allgemeine Ursachen – Vorgehensweise – Tipps zur Prävention 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. Allgemeine Ursachen Es wird keine ID angegeben, wodurch der Wert 0 übergeben wird. Vorgehensweise – Tipps zur Vermeidung Beachten Sie die Informationen zu Bereichseinschränkungen in der API-Referenz.

RequestError
INVALID_INPUT	Zusammenfassung Die Anfrage ist falsch formatiert. Allgemeine Ursachen Die URL oder der Inhalt des Antrags ist fehlerhaft. Vorgehensweise – Tipps zur Vermeidung –
REQUIRED_FIELD_MISSING	Zusammenfassung In der Anfrage fehlen erforderliche Informationen. Allgemeine Ursachen Fehlende Pflichtfelder beim Hinzufügen einer Entität. Vorgehensweise Protokollieren Sie den Fehler und senden Sie eine Fehlermeldung an den Nutzer. Das Attribut fieldPath des Fehlers gibt an, welches Feld fehlt. Tipps zur Prävention Welche Felder erforderlich sind, können Sie der API-Referenz entnehmen.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Zusammenfassung Durch die Anfrage wird versucht, eine Ressource zu erstellen, die dazu führen würde, dass die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreiten würde. Allgemeine Ursachen Es gibt mehrere Limits für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können. Vorgehensweise Sehen Sie sich die Systemlimits an, um herauszufinden, welches Limit überschritten wurde. Verwenden Sie entweder eine vorhandene Ressource wieder oder entfernen Sie Ressourcen, um Platz für neue Ressourcen zu schaffen. Tipps zur Prävention 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 zulässig. Allgemeine Ursachen Anzeigentitel oder Textzeilen für Anzeigen enthalten zu viel Text. Vorgehensweise Identifizieren Sie das aufgetretene Limit, ändern Sie den String entsprechend und senden Sie die Anfrage noch einmal. Tipps zur Prävention Beachten Sie die Längenbeschränkungen für Strings.