Im Folgenden finden Sie eine alphabetische Liste der Fehler.
auth/account_access_denied
User cannot access account
<account_number>
Zusammenfassung
Es wurde eine Anfrage für ein Konto gesendet, auf das der authentifizierte Nutzer keinen Zugriff hat.
Häufige Ursachen
Fehler in der Zielhändler-ID oder Sie haben vergessen, den Nutzer im Merchant Center zu registrieren.
Empfohlene Vorgehensweise
Prüfen Sie, ob Sie das richtige Konto als Ziel ausgewählt haben, oder registrieren Sie sich im Merchant Center (Einstellungen > Nutzer) als Nutzer des Kontos.
Tipps zur Vermeidung
–
User is not an administrator of
account <account_number>
Zusammenfassung
Es wurde eine Anfrage zur Änderung eines Kontos gesendet, für das der authentifizierte Nutzer keine Administratorrechte hat.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Legen Sie Administratorrechte für den authentifizierten Nutzer fest.
Tipps zur Vermeidung
–
Konflikt
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code>
Zusammenfassung
Es wurden mehrere konfliktive Vorgänge gleichzeitig ausgeführt.
Häufige Ursachen
Eine einzelne Batchanfrage enthält mehrere sich widersprechende Vorgänge für dasselbe Produkt oder mehrere sich widersprechende Vorgänge für dasselbe Produkt wurden gleichzeitig an die Content API gesendet.
Empfohlene Vorgehensweise
Siehe Tipps zur Prävention.
Tipps zur Vermeidung
Enthalten alle Änderungen für ein bestimmtes Produkt für einen einzelnen Vorgang in einer Reihe von Batchanfragen. Vermeiden Sie mehrere gleichzeitige Aufrufe der Content API für denselben Händler und denselben Shopcode. Achten Sie außerdem darauf, dass diese Aufrufe keine sich überschneidenden Produkte enthalten.
internalError
Internal error
Zusammenfassung
Es gibt ein Problem mit dem Google-Backend.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Wiederholen Sie die Anfrage.
Wenden Sie sich an uns, wenn das Problem weiterhin auftritt.
Tipps zur Vermeidung
–
ungültig
Invalid channel:
'<channel>'
Zusammenfassung
Ungültiger Kanal als Teil einer Produkt-ID angegeben.
Beispiel: not_a_channel:en:US:sku123.
Häufige Ursachen
–
Empfohlene Vorgehensweise
–
Tipps zur Vermeidung
Die Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben, z. B. online:en:US:sku123. Weitere Informationen finden Sie in der Referenzdokumentation zu Products.insert.
[countrycode] Invalid country code:
'<country_code>'
Zusammenfassung
Ungültiger Ländercode in einer Produkt-ID.
Beispiel: online:en:not_a_country_code:sku123.
Häufige Ursachen
–
Empfohlene Vorgehensweise
–
Tipps zur Vermeidung
Die Produkt-ID muss vom Format channel:languageCode:countryCode:offerId sein und der Ländercode muss ein gültiger
Ländercode gemäß ISO 3166 sein.
[item id] Invalid item
id: '<id>'
Zusammenfassung
Ungültige Artikel-ID, z.B. sku123 statt online:en:US:sku123.
Häufige Ursachen
In einer GET- oder DELETE-Anfrage wird eine Angebots-ID anstelle einer Produkt-ID angegeben.
Empfohlene Vorgehensweise
–
Tipps zur Vermeidung
Die Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben.
[name] The term '<term>' is not
allowed
Zusammenfassung
Der Name enthält ein unzulässiges Wort.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Verwenden Sie einen zulässigen Namen.
Weitere Informationen finden Sie im Hilfeartikel Feedspezifikation.
Tipps zur Vermeidung
–
[price.currency] Please use a currency
that is supported in the target country
Zusammenfassung
Sie haben eine Währung angegeben, die im Zielland nicht verfügbar ist.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Prüfen Sie, ob Währung und Land korrekt angegeben sind. Weitere Informationen finden Sie im Hilfeartikel zur Feedspezifikation im Abschnitt zu price.
Tipps zur Vermeidung
–
[storeCode] storeCode must be
'online'
Zusammenfassung
Sie haben versucht, den Preis und die Verfügbarkeit eines Onlineprodukts über den Inventarfeed zu aktualisieren, aber in der URL einen anderen Wert als den Sonderwert online als Geschäfts-ID angegeben.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Ändern Sie die Store-ID in der Anfrage-URL in online.
Tipps zur Vermeidung
Geben Sie in allen Inventarabfragen online für Onlineprodukte und die Geschäfts-ID für lokal erhältliche Produkte an.
[<attribute>]
Zusammenfassung
Das in den eckigen Klammern angegebene Element ist ungültig.
Das Element, das Sie abrufen, aktualisieren oder löschen wollten, existiert nicht.
Häufige Ursachen
Es wird versucht, ein Produkt zu löschen, das nicht existiert, oder die Produkt-ID in der URL für das Löschen ist falsch angegeben.
Empfohlene Vorgehensweise
Rufen Sie mit Products.list eine Liste der Produkte ab und versuchen Sie nur, Elemente abzurufen, zu aktualisieren oder zu löschen, die dort angezeigt werden. Geben Sie die Produkt-ID im Format channel:languageCode:countryCode:offerId an, z. B. online:ru:RU:277104-ekb, und nicht die Angebots-ID, die so aussieht: 277104-ekb.
Tipps zur Vermeidung
–
not_inserted
The item could not be
inserted.
Zusammenfassung
Aufgrund anderer Fehler konnte das Produkt nicht eingefügt werden, da ein vorhandener korrekter Eintrag überschrieben würde.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Prüfen Sie die anderen Fehler für denselben Aufruf und beheben Sie sie, bevor Sie versuchen, die neuen Produktinformationen noch einmal einzufügen.
Tipps zur Vermeidung
–
Kontingent
too_many_items: Merchant
quota exceeded
Zusammenfassung
Zu viele Artikel wurden in Google Shopping hochgeladen.
Häufige Ursachen
Produkte, die nicht validiert werden können, können trotzdem eingefügt werden, wenn sie kein vorhandenes gültiges Produkt ersetzen. Verwenden Sie das Flag includeInvalidInsertedItems, um zu prüfen, ob Ihr Konto zu viele ungültige Produkte enthält.Productstatuses.list
Empfohlene Vorgehensweise
Prüfen Sie, ob eine übermäßige Anzahl ungültiger Produkte vorhanden ist, und entfernen Sie diese. Geben Sie beim Hochladen von Produkten außerdem
Ablaufdaten an. Nach Ablauf des Gültigkeitszeitraums wird das Produkt automatisch gelöscht. Das Standard- und Maximaldatum für das Ablaufdatum ist 30 Tage nach dem Einfügen oder Aktualisieren des Produkts.
Hinweis: Das Artikelkontingent für ein Mehrfachkundenkonto wird anhand der Gesamtzahl der Produkte in allen Unterkonten überprüft. Wenn Sie diesen Fehler für ein Unterkonto erhalten, prüfen Sie, ob sowohl das Unterkonto als auch Ihr Mehrfachkundenkonto ein ausreichendes Produktkontingent haben.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Zusammenfassung
Anfragen werden zu schnell gesendet. Verringern Sie die Anfragehäufigkeit.
Häufige Ursachen
Weitere Informationen finden Sie in den veröffentlichten Limits. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Manchmal ist ein Traffic-Anstieg dafür verantwortlich oder Ihr Server wird auf eine größere Anzahl von Threads erweitert.
Empfohlene Vorgehensweise
Reduzieren Sie die Anzahl der pro Minute gesendeten Anfragen.
Tipps zur Vermeidung
Wenn dieser Fehler auftritt, verwenden Sie programmatische Backoff-Strategien, um die Anfragerate auf ein angemessenes, nachhaltiges Niveau zu senken.
daily_limit_exceeded:
merchant quota exceeded
Zusammenfassung
Sie senden mehr Anfragen pro Tag, als für die jeweilige Dienstmethode zulässig ist.
Häufige Ursachen
Weitere Informationen finden Sie in den veröffentlichten Limits. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung.
Empfohlene Vorgehensweise
Reduzieren Sie die Anzahl der Anfragen, die pro Tag gesendet werden, indem Sie nach Möglichkeit mehrere Änderungen in einer einzigen Anfrage kombinieren. Wir empfehlen Ihnen, Änderungen an Produkten über einen angemessenen Zeitraum hinweg vorzunehmen, um zu vermeiden, dass ein Produkt mehrmals schnell geändert wird. Wenn Artikelaktualisierungen auf Ihrer Website als Mikrodaten dargestellt werden können, sollten Sie diesen Ansatz verwenden, um die Anzahl der Aufrufe der Products- oder Inventory-Dienste zu begrenzen.
Wenn Sie für eine bestimmte Methode mehr tägliche Aufrufe benötigen, wenden Sie sich bitte an uns. Teilen Sie uns dabei Ihre Merchant Center-ID und die Methoden mit, bei denen Sie das Kontingentlimit erreichen. Geben Sie außerdem eine Schätzung dazu an, wie viele Aufrufe pro Tag Sie für diese Methoden benötigen und warum. Wir werden dann gemeinsam mit Ihnen versuchen, Ihr Kontingent zu erhöhen.
Tipps zur Vermeidung
Weitere Informationen finden Sie unter Empfohlene Tipps zur Handhabung.
too_many_failed_auths:
Too many failed authentications.
Zusammenfassung
Sie stellen zu viele Batchanfragen für Konten, auf die Sie keinen Zugriff haben.
Häufige Ursachen
Anfragen für gelöschte Unterkonten oder neu erstellte Unterkonten, bevor sie verfügbar sind, in Batches senden
Empfohlene Vorgehensweise
Vermeiden Sie Aufrufe, die sich auf ein gelöschtes Unterkonto auswirken.
Tipps zur Vermeidung
Weitere Informationen finden Sie unter Empfohlene Tipps zur Handhabung.
request_too_large
Zusammenfassung
Sie senden zu viele entries pro Batchanfrage oder überschreiten das Limit für die Anfragegröße von custombatch.
Häufige Ursachen
Sie können maximal 10.000 entries pro custombatch-Anfrage angeben. Die komprimierte Übertragungsgröße ist auf 32 MB begrenzt.
Empfohlene Vorgehensweise
Teilen Sie den Batch in mehrere Batches auf, die unter den Limits liegen, und versuchen Sie es dann noch einmal.
Tipps zur Vermeidung
Wir empfehlen,nicht mehr als 1.000 Einträge pro Batch zu senden.
erforderlich
[price.value] Required parameter: price.value
Zusammenfassung
Sie haben einen Preis ohne Wert angegeben. Beispiel: { "currency": "USD" } anstelle von { "value": 123, "currency": "USD" }.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Der Parameter, hier price, muss wohlgeformt sein. Beispiel: price hat zwei Pflichtfelder: value und currency.
Tipps zur Vermeidung
–
[product] INSERT request must specify
product
Zusammenfassung
Es wurde eine benutzerdefinierte Batchanfrage an die API gesendet, die einen Eintrag mit "method": "insert", aber ohne Produkt enthält.
Häufige Ursachen
Die Methode wurde nicht in get oder delete geändert.
Empfohlene Vorgehensweise
Geben Sie über das Feld product ein Produkt an, das eingefügt werden soll.
Tipps zur Vermeidung
Achten Sie darauf, dass Sie für Batch-Einträge mit der Methode insert ein Produkt angeben und für Batch-Einträge mit der Methode get oder delete eine Produkt-ID.
[productId] DELETE request must specify
productId
Zusammenfassung
Sie haben eine benutzerdefinierte Batchanfrage an die API gesendet, die einen Eintrag mit "method": "delete", aber ohne Produkt-ID enthält.
Häufige Ursachen
Die Methode wurde nicht in insert geändert.
Empfohlene Vorgehensweise
Geben Sie über das Feld productID ein Produkt an, das gelöscht werden soll.
Tipps zur Vermeidung
Achten Sie darauf, dass Sie für Batch-Einträge mit der Methode insert ein Produkt angeben und für Batch-Einträge mit der Methode get oder delete eine Produkt-ID.
userRateLimitExceeded
User Rate Limit
Exceeded
Zusammenfassung
Anfragen werden zu schnell gesendet. Verringern Sie die Anfragehäufigkeit.
Häufige Ursachen
Weitere Informationen finden Sie in den veröffentlichten Limits für HTTP-Anfragen. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Manchmal ist ein Traffic-Anstieg dafür verantwortlich oder Ihr Server wird auf eine größere Anzahl von Threads erweitert.
Empfohlene Vorgehensweise
Reduzieren Sie die Anzahl der pro Minute gesendeten Anfragen. Wenn Sie mehrere Methodenaufrufe an denselben Dienst in einer einzigen custombatch-Anfrage zusammenfassen, wird die Anzahl der HTTP-Anfragen reduziert.
Tipps zur Vermeidung
Wenn dieser Fehler auftritt, verwenden Sie Batching und programmatische Backoff-Strategien, um die Anfragerate auf ein geeignetes, nachhaltiges Niveau zu senken.
Validierung
[adwords_redirect]
Zusammenfassung
Sie haben ein Produkt eingereicht, dessen adwords_redirect-Feld keine gültige URL ist.
Eine Marke, Beschreibung oder ein anderes Attribut wurde als String gesendet, der nicht mit der angegebenen Anfragecodierung geparst werden kann.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Sehen Sie in der Meldung nach, welches Attribut das Problem verursacht, und prüfen Sie dann die Textcodierung des entsprechenden Werts, bevor Sie ihn noch einmal einreichen. Die API akzeptiert nur gültige UTF-8-Zeichen.
Tipps zur Vermeidung
–
[<attribute>] invalid_value
Zusammenfassung
Es wurde eine ungültige Farbe, Beschreibung oder ein ungültiges anderes Attribut eingereicht.
[[["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: 2025-06-19 (UTC)."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]
