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 Referenzen zu Fehlern. Weitere Unterstützung erhalten Sie in unserem Forum.

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 konfiguriert ist, und einem Veröffentlichungsstatus von Testing wird ein Aktualisierungstoken mit einer Gültigkeitsdauer von 7 Tagen ausgestellt. Vorgehensweise: Der Veröffentlichungsstatus Ihres Google-Projekts ist Testing. Das Aktualisierungstoken läuft daher alle sieben Tage ab und es wird der Fehler invalid_grant ausgegeben. Rufen Sie in der Google API Console den OAuth-Zustimmungsbildschirm auf. Ändern Sie dann den Veröffentlichungsstatus gemäß dieser Anleitung zu In production, damit das Aktualisierungstoken nicht in 7 Tagen abläuft. Tipps zur Vermeidung Weitere Informationen finden Sie unter Ungeprüfte Apps.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Zusammenfassung Dieser Operator kann nicht mit der Unterklasse "Ad" verwendet werden. Häufige Ursachen Sie versuchen, andere Attribute als die status der Anzeige zu ändern. Vorgehensweise: – 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. Die 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 Vorgehensweise: – Tipps zur Vermeidung Validieren Sie URLs in Ihrer App, bevor Sie die API-Anfrage senden.
LINE_TOO_WIDE	Zusammenfassung Eines der Felder in einer Anzeige war länger als die maximal zulässige Länge. Weitere Informationen finden Sie unter Textanzeigen. Häufige Ursachen Textzeilen sind zu lang. Vorgehensweise: – Tipps zur Vermeidung Prüfe die Länge der Zeile, bevor du die API-Anfrage sendest.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Zusammenfassung Dieses Label ist bereits einigen Anzeigen zugeordnet. Häufige Ursachen Sie versuchen, das Label mit Anzeigen zu verknüpfen, die bereits verknüpft sind. Vorgehensweise: – 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 Nachdem eine Anzeige entfernt wurde, kann sie nicht mehr aktualisiert werden. Das 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. Häufige Ursachen Der Keyword-Text enthält ungültige Zeichen. Vorgehensweise: – Tipps zur Vermeidung 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. Häufige Ursachen Wenn Sie eine neue Anzeigengruppe mit dem Namen einer vorhandenen aktiven oder pausierten Anzeigengruppe erstellen. Vorgehensweise: Der Fehler wird protokolliert und dem Nutzer wird eine Fehlermeldung angezeigt. Optional wird ein eindeutiger Anzeigengruppenname vorgeschlagen oder eine Liste der verwendeten Namen angezeigt. 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 Mutate-Anfrage mit doppelten Erstellungsvorgängen, die dieselben Binärdaten enthalten. Vorgehensweise: Erstelle das Asset in einer separaten Anfrage und verknüpfe es dann in der nachfolgenden Anfrage. Du kannst auch eine vorübergehende ID in derselben Anfrage verwenden. Tipps zur Vermeidung –

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Zusammenfassung Die Kundennummer ist keine Zahl. Häufige Ursachen Eine ungültige Kundennummer des Kunden verwendet. Vorgehensweise: – Tipps zur Vermeidung 123-456-7890 muss 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 Kundennummer des Kunden angegeben. Vorgehensweise: – Tipps zur Vermeidung Die Kunden-ID des Kunden ist für alle Aufrufe erforderlich. Geben Sie daher im HTTP-Header eine Kunden-ID an. Sie können auch unsere Clientbibliotheken verwenden, da diese Aufgabe dort für Sie erledigt wird.
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 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. Häufige Ursachen Das Zugriffstoken ist ungültig geworden. Vorgehensweise: 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. Vorgehensweise: Melden Sie sich für den OAuth-Vorgang mit einem gültigen Google Ads-Konto an (in der Regel Ihrem Verwaltungskonto). Sie können das Google-Konto auch zum Zugriff auf ein bestehendes Google Ads-Konto einladen. Melden Sie sich dazu in Ihrem Verwaltungskonto an, wählen Sie das betreffende 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. Vorgehensweise: – 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 benötigen, mit denen Sie auf alle Kundenkonten in einem Verwaltungskonto zugreifen können, müssen Sie das Aktualisierungstoken für das Verwaltungskonto abrufen. Weitere Informationen finden Sie in unseren Leitfäden zu Zugriffs- und Aktualisierungstoken und OAuth2.

AuthorizationError
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 oder es deaktiviert wurde. Vorgehensweise: 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 im Hilfeartikel Ein aufgelöstes Google Ads-Konto wieder aktivieren. Tipps zur Vermeidung Du kannst proaktiv prüfen, ob ein Kundenkonto deaktiviert ist. Dazu prüfst du, ob der Status CANCELLED (Storniert) lautet.
DEVELOPER_TOKEN_NOT_APPROVED	Zusammenfassung Das Entwicklertoken ist nur für die Verwendung mit Testkonten genehmigt und es wurde versucht, auf ein Nicht-Testkonto zuzugreifen. Häufige Ursachen Ein Test-Entwicklertoken wurde verwendet, um auf ein Nicht-Testkonto zuzugreifen. Vorgehensweise: Achten Sie darauf, dass Sie tatsächlich auf ein Nicht-Testkonto zugreifen möchten. In diesem Fall müssen Sie einen Antrag auf ein Upgrade Ihres Entwicklertokens auf Standard- oder Basiszugriff stellen. Tipps zur Vermeidung –
DEVELOPER_TOKEN_PROHIBITED	Zusammenfassung Das Entwicklertoken ist für das in der Anfrage gesendete Projekt nicht zulässig. Häufige Ursachen Jedes Google API Console-Projekt kann nur mit dem Entwickler-Token aus einem einzigen Verwaltungskonto verknüpft werden. Sobald Sie eine Google Ads API-Anfrage gesendet haben, wird das Entwicklertoken dauerhaft mit dem Google API Console-Projekt verknüpft. Wenn Sie kein neues Google API Console-Projekt verwenden, erhalten Sie bei einer Anfrage einen DEVELOPER_TOKEN_PROHIBITED-Fehler. Vorgehensweise: – Tipps zur Vermeidung Wenn Sie zu einem Entwickler-Token unter einem neuen Verwaltungskonto wechseln, müssen Sie ein neues Google API Console-Projekt erstellen, für das Google Ads API-Anfragen mit dem Token des neuen Verwaltungskontos gesendet werden.
USER_PERMISSION_DENIED	Zusammenfassung Der autorisierte Kunde hat keinen Zugriff auf den aktiven Kunden. Häufige Ursachen Authentifizierung als Nutzer mit Zugriff auf ein Verwaltungskonto, ohne login-customer-id in der Anfrage anzugeben. Vorgehensweise: – Tipps zur Vermeidung Geben Sie die login-customer-id als ID des Verwaltungskontos ohne Bindestriche (-) an. Clientbibliotheken bieten eine integrierte Unterstützung dafür.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Zusammenfassung Der Gebotswert ist kein genaues Vielfaches der Mindesteinheit der Währung des Kontos. 0, 015 $ (15000 in Mikros) ist beispielsweise kein gültiges Gebot. Häufige Ursachen – Vorgehensweise: – Tipps zur Vermeidung Prüfen Sie, ob Gebote ein Vielfaches der kleinsten Währungseinheit für das Konto sind.
BID_TOO_BIG	Zusammenfassung Der Fehler wird zurückgegeben, obwohl das Gebot im Rahmen des Kampagnenbudgets liegt. Häufige Ursachen – Vorgehensweise: – Tipps zur Vermeidung Prüfen Sie, ob das Konto am Google Ad Grants-Programm teilnimmt. Begrenzen Sie in diesem Fall die CPC-Gebote auf das vom Programm vorgeschriebene Maximum.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Zusammenfassung Der Budgetbetrag ist zu niedrig. Häufige Ursachen – Vorgehensweise: – Tipps zur Vermeidung Prüfen Sie, ob der Budgetbetrag der Mindesteinheit für die Währung des Kontos entspricht oder diese übersteigt.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Zusammenfassung Der Budgetbetrag hat zu viele signifikante Dezimalstellen, wenn er von einem Mikrobetrag in einen Betrag in der Währung des Kontos umgewandelt wird. Häufige Ursachen – Vorgehensweise: – 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 Vorgehensweise: Protokollieren Sie den Fehler und zeigen Sie dem Nutzer eine Fehlermeldung an. Optional können Sie einen eindeutigen Kampagnennamen vorschlagen oder eine Liste der verwendeten Namen anzeigen. Tipps zur Vermeidung –

CriterionError
KEYWORD_HAS_INVALID_CHARS	Zusammenfassung Keywords hinzufügen oder bearbeiten, die ungültige Zeichen enthalten Häufige Ursachen Verwenden Sie in den Keywords Sonderzeichen wie ! @ % *. Vorgehensweise: – Tipps zur Vermeidung 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 Vermeidung Entfernen Sie Duplikate (Vorgänge, Parameter, Listenelemente) vor dem Senden der Anfrage. 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 zu einer zu großen Antwort geführt hat, oder eine Mutanfrage 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 Vermeidung Weitere Informationen dazu, wie sich die Segmentierung auf die Größe einer Antwort auswirken kann, finden Sie im Hilfeartikel zu diesem Thema. 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. Vorgehensweise: Wiederholen Sie alle Anfragen, die mit diesem Fehler fehlgeschlagen sind, und verwenden Sie für die Wiederholungen ein exponentielles Backoff-Schema. Tipps zur Vermeidung –
TRANSIENT_ERROR	Zusammenfassung Ein vorübergehender interner Fehler ist aufgetreten. Bitte versuchen Sie es noch einmal. Häufige 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 für die Wiederholungen ein exponentielles Backoff-Schema. Tipps zur Vermeidung –

InvalidGrantError

invalid_grant (malformed auth code)

Zusammenfassung Der Autorisierungscode, der gegen OAuth-Tokens eingetauscht wurde, war fehlerhaft. Häufige Ursachen Das passiert, wenn versucht wird, ein Aktualisierungstoken für einen Nutzer zu generieren, dem bereits Zugriff auf die anfordernde Anwendung gewährt wurde. Das kann beispielsweise passieren, wenn Sie das Beispiel zum Generieren von Nutzeranmeldedaten mehrmals für dieselben OAuth-Clientanmeldedaten und denselben autorisierten Nutzer ausführen. Vorgehensweise: Wenn Sie ein Aktualisierungstoken für eine bestimmte Kombination aus autorisierendem Nutzer und OAuth-Client-Anmeldedaten neu generieren möchten, widerrufen Sie ein vorhandenes Aktualisierungstoken. 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 es nicht neu generiert werden muss.

MutateError

RESOURCE_NOT_FOUND

Zusammenfassung Die Anfrage bezog sich auf eine Ressource, die nicht gefunden werden konnte. Häufige Ursachen Bei der Anfrage wurde versucht, eine Ressource zu ändern oder anderweitig auf eine Ressource zu verweisen, die nicht vorhanden ist oder entfernt wurde. Möglicherweise ist auch der angegebene Ressourcenname für die Ressource falsch formatiert. Vorgehensweise: Rufen Sie mit einer Suchanfrage den Ressourcennamen für eine vorhandene Ressource ab, bevor Sie eine Anfrage zum Ändern senden. In unseren Leitfäden zur Clientbibliothek finden Sie Dokumentationen dazu, wie Sie in jeder unterstützten Sprache gültige Ressourcennamen erstellen. Tipps zur Vermeidung Erstellen Sie keine Ressourcennamen 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. Vorgehensweise: – Tipps zur Vermeidung –

QuotaError
RESOURCE_EXHAUSTED	Zusammenfassung Eine Häufigkeitsbegrenzung des Systems wurde überschritten. Häufige Ursachen – Vorgehensweise: – Tipps zur Vermeidung Legen Sie kurze Verzögerungen zwischen den Anfragen fest oder kombinieren Sie mehrere Vorgänge in weniger Anfragen.

RangeError
TOO_LOW	Zusammenfassung Ein Wert lag unter dem zulässigen Mindestwert. Häufige Ursachen Sie haben vergessen, eine ID anzugeben, 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. Häufige Ursachen Die URL oder der Inhalt der Anfrage ist fehlerhaft. Vorgehensweise: – Tipps zur Vermeidung –
REQUIRED_FIELD_MISSING	Zusammenfassung In der Anfrage fehlen erforderliche Informationen. Häufige Ursachen Beim Hinzufügen einer Entität fehlen Pflichtfelder. Vorgehensweise: 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 erfährst du, welche Felder erforderlich sind.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Zusammenfassung Mit der Anfrage wird versucht, eine Ressource zu erstellen, die dazu führt, dass die Gesamtzahl dieser Ressourcen ein bestimmtes Limit überschreitet. Häufige Ursachen Die Anzahl der Ressourcen, die in bestimmten Kontexten vorhanden sein können, ist durch mehrere Einschränkungen begrenzt. Vorgehensweise: Sehen Sie sich die Systemlimits an, um das Problem zu identifizieren. Verwenden Sie entweder eine vorhandene Ressource 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 enthalten zu viel Text. Vorgehensweise: Ermitteln Sie das Limit , das überschritten wird, ändern Sie den String entsprechend und senden Sie die Anfrage noch einmal. Tipps zur Vermeidung Beachten Sie die Einschränkungen bei der Stringlänge.