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 Für ein Google Cloud Platform-Projekt mit einem für einen externen Nutzertyp konfigurierten OAuth-Zustimmungsbildschirm und dem Veröffentlichungsstatus Testing wird ein Aktualisierungstoken ausgegeben, das in 7 Tagen abläuft. Vorgehensweise Der Veröffentlichungsstatus Ihres Google-Projekts lautet Testing. Das Aktualisierungstoken läuft daher alle 7 Tage ab und erhält den Fehler invalid_grant. Gehen Sie zur Google API Console und rufen Sie den OAuth-Zustimmungsbildschirm auf. Ändere dann den Veröffentlichungsstatus zu „In production“. Folge dazu dieser Anleitung, um zu verhindern, dass das Aktualisierungstoken nach 7 Tagen abläuft. Tipps zur Prävention Weitere Informationen

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Zusammenfassung Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden. Allgemeine Ursachen Sie versuchen, 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. Der 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 die URLs in Ihrer Anwendung, 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 Zu lange Textzeile. Vorgehensweise – Tipps zur Prävention Prü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 sind. 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 den 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. Siehe Keywords hinzufügen. Allgemeine Ursachen Der Keyword-Text enthält ungültige Zeichen. Vorgehensweise – Tipps zur Prävention Prü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 Erstellen einer neuen 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 an. Tipps zur Prävention –

AssetError

DUPLICATE_ASSET

Zusammenfassung Zwei Vorgänge in einer einzelnen Anforderung 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 in der nachfolgenden Anfrage oder verwenden Sie in derselben Anfrage eine temporäre ID. Tipps zur Prävention –

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Zusammenfassung Die Kundennummer ist keine Zahl. Allgemeine Ursachen Sie verwenden eine ungültige Client-Kundennummer. Vorgehensweise – Tipps zur Prävention 123-456-7890 muss 1234567890 sein. Weitere Informationen
CLIENT_CUSTOMER_ID_IS_REQUIRED	Zusammenfassung Die Kundennummer wurde im HTTP-Header nicht angegeben. Allgemeine Ursachen Im HTTP-Header wurde keine Client-Kundennummer angegeben. Vorgehensweise – Tipps zur Prävention Die Client-Kundennummer muss bei allen Aufrufen angegeben werden. Achten Sie daher darauf, dass Sie im HTTP-Header eine Kundennummer angegeben haben. Wir empfehlen Ihnen, unsere Clientbibliotheken zu verwenden, die dies für Sie erledigen.
CUSTOMER_NOT_FOUND	Zusammenfassung Es wurde kein Konto mit der im Header angegebenen Kundennummer gefunden. Allgemeine Ursachen Sie versuchen, auf ein Konto zuzugreifen, das gerade erst erstellt wurde, bevor es im Back-End 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 (in der Regel Ihr Verwaltungskonto) an. 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 benötigen, mit denen auf alle Kundenkonten eines Verwaltungskontos zugegriffen werden kann, 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 für das Kundenkonto noch nicht abgeschlossen oder deaktiviert wurde. Vorgehensweise Melden Sie sich auf der Google Ads-Benutzeroberfläche an und stellen Sie sicher, dass Sie die Registrierung für das Konto abgeschlossen haben. Informationen zu deaktivierten Konten finden Sie im Hilfeartikel Aufgelöstes Google Ads-Konto wieder aktivieren. Tipps zur Prävention Sie können proaktiv prüfen, ob ein Kundenkonto deaktiviert wurde, indem Sie den Status STORNIERT prüfen.
DEVELOPER_TOKEN_NOT_APPROVED	Zusammenfassung Das Entwickler-Token ist nur für die Verwendung mit Testkonten freigegeben und es wurde versucht, auf ein Konto zuzugreifen, das kein Testkonto ist. Allgemeine Ursachen Für den Zugriff auf ein Konto, das kein Testkonto ist, wurde ein Testentwicklertoken verwendet. Vorgehensweise Stellen Sie sicher, dass Sie tatsächlich auf ein Konto zugreifen möchten, das kein Testkonto ist. In diesem Fall müssen Sie eine Umstellung Ihres Entwicklertokens auf den 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 mit dem Entwicklertoken von nur einem Verwaltungskonto aus 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, wird beim Stellen einer Anfrage der Fehler DEVELOPER_TOKEN_PROHIBITED angezeigt. Vorgehensweise – Tipps zur Prävention Wenn Sie in einem neuen Verwaltungskonto zu einem Entwicklertoken wechseln, müssen Sie ein neues Google API Console-Projekt für Google Ads API-Anfragen erstellen, für die das neue Managertoken verwendet wird.
USER_PERMISSION_DENIED	Zusammenfassung Der autorisierte Kunde hat keinen Zugriff auf den Kunden. Allgemeine Ursachen Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne login-customer-id in der Anfrage anzugeben. Vorgehensweise – Tipps zur Prävention Geben Sie die login-customer-id als Verwaltungskonto-ID ohne Bindestriche (-) an. Das wird von Clientbibliotheken unterstützt.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Zusammenfassung Der Gebotswert ist kein genaues Vielfaches der Mindesteinheit der Kontowährung. Beispiel: 0, 015 € (15000 in Mikros) ist kein gültiges Gebot. Allgemeine Ursachen – Vorgehensweise – Tipps zur Prävention Stellen Sie sicher, dass die 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 Prüfen Sie, ob das Konto bei Google Ad Grants angemeldet ist. Sollte dies der Fall sein, beschränken Sie die CPC-Gebote auf den für das Programm zulässigen Höchstwert.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Zusammenfassung Der Budgetbetrag ist zu niedrig. Häufige Ursachen – Vorgehensweise – Tipps zur Prävention Stellen Sie sicher, dass der Budgetbetrag der Mindesteinheit der Kontowährung entspricht oder darüber liegt.
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 teilbar sein.

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. Siehe 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 Das Zeitlimit für die Anfrage wurde überschritten. Sie konnte nicht schnell genug ausgeführt werden, um eine Antwort zurückzugeben. Allgemeine Ursachen Es wurde eine Suchanfrage durchgeführt, durch die eine zu große Antwort generiert wurde, oder eine mutate-Anfrage war zu groß, um verarbeitet zu 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 Unter Segmentierung erfahren Sie, wie sich diese 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 aufgrund dieses Fehlers fehlgeschlagen sind, unter Verwendung eines exponentiellen Backoff-Zeitplans für die Wiederholungsversuche. Tipps zur Prävention –
TRANSIENT_ERROR	Zusammenfassung Es ist ein vorübergehender interner Fehler aufgetreten. Versuchen Sie es noch einmal. Allgemeine Ursachen Dieser Fehler tritt auf, wenn bei der API intern ein vorübergehendes Problem auftritt. Vorgehensweise Wiederholen Sie alle Anfragen, die aufgrund dieses Fehlers fehlgeschlagen sind, unter Verwendung eines exponentiellen Backoff-Zeitplans für die Wiederholungsversuche. Tipps zur Prävention –

InvalidGrantError

invalid_grant (malformed auth code)

Zusammenfassung Der für OAuth-Tokens ausgetauschte Autorisierungscode war fehlerhaft. Allgemeine Ursachen Dies ist der Fall, wenn versucht wird, ein Aktualisierungstoken für einen Nutzer zu generieren, dem bereits Zugriff auf die anfragende Anwendung gewährt wurde. Dieses Problem kann beispielsweise auftreten, wenn Sie das Beispiel zum Generieren von Nutzeranmeldedaten mehrmals für dieselben OAuth-Clientanmeldedaten und denselben autorisierenden Nutzer ausführen. Vorgehensweise Um ein Aktualisierungstoken für eine bestimmte Kombination aus autorisierenden Nutzer- und OAuth-Client-Anmeldedaten neu zu generieren, heben Sie ein bestehendes Aktualisierungstoken auf. 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 neu generiert werden muss.

MutateError

RESOURCE_NOT_FOUND

Zusammenfassung Die Anfrage verweist auf eine Ressource, 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 Änderungsanfrage senden. Sehen Sie sich unsere Leitfäden zu Clientbibliotheken an, die auch Informationen zum Erstellen gültiger Ressourcennamen in allen unterstützten Sprachen enthalten. Tipps zur Prävention Erstellen Sie Ressourcennamen nicht manuell. Verwenden Sie eine der von unseren Clientbibliotheken angebotenen Hilfsmethoden.

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 Legen Sie kurze Verzögerungen zwischen Anfragen fest oder kombinieren Sie mehr Vorgänge in weniger Anfragen.

RangeError
TOO_LOW	Zusammenfassung Ein Wert lag unter dem zulässigen Mindestwert. Allgemeine Ursachen Es muss keine ID angegeben werden, 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 der Anfrage ist fehlerhaft. Vorgehensweise – Tipps zur Vermeidung –
REQUIRED_FIELD_MISSING	Zusammenfassung In der Anfrage fehlen erforderliche Informationen. Allgemeine Ursachen Beim Hinzufügen einer Entität fehlen Pflichtfelder. 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 In der API-Referenz sehen Sie, welche Felder erforderlich sind.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Zusammenfassung Die Anfrage versucht, eine Ressource zu erstellen, durch die die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreiten würde. Allgemeine Ursachen Es gibt mehrere Beschränkungen für die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können. Vorgehensweise Auf der Seite Systemlimits können Sie die erkannten Grenzwerte ermitteln. Verwenden Sie entweder eine vorhandene Ressource oder entfernen Sie Ressourcen, um Platz für neue zu schaffen. Tipps zur Prävention Verwenden Sie Suchanfragen, um die Anzahl der Ressourcen zu überwachen, die Beschränkungen unterliegen.

StringLengthError
TOO_LONG	Zusammenfassung Der dem angegebenen Feld zugewiesene String ist zu lang. Allgemeine Ursachen Anzeigentitel oder Textzeilen für Anzeigen enthalten zu viel Text. Vorgehensweise Ermitteln 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.