Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
[[["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: 2024-12-02 (UTC)."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
