Im Folgenden finden Sie eine alphabetisch sortierte Liste von Fehlern.
auth/account_access_denied
User cannot access account
<account_number>
Zusammenfassung
Sie haben eine Anfrage für ein Konto gestellt, auf das der authentifizierte Nutzer keinen Zugriff hat.
Häufige Ursachen
Fehler in der Zielhändler-ID oder Nutzerregistrierung im Merchant Center vergessen.
Empfohlene Vorgehensweise
Prüfen Sie, ob Sie das richtige Konto verwenden oder sich als Nutzer des Kontos im Merchant Center registrieren (Einstellungen > Nutzer).
Tipps zur Vermeidung
–
User is not an administrator of
account <account_number>
Zusammenfassung
Es wurde eine Anfrage zur Änderung eines Kontos gestellt, für das der authentifizierte Nutzer keine Administratorrechte hat.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Administratorrechte für den authentifizierten Nutzer festlegen.
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 widersprüchliche Vorgänge gleichzeitig versucht.
Häufige Ursachen
Eine einzelne Batch-Anfrage enthält mehrere widersprüchliche Vorgänge für dasselbe Produkt oder es wurden gleichzeitig mehrere widersprüchliche Vorgänge für dasselbe Produkt über die Content API eingereicht.
Empfohlene Vorgehensweise
Weitere Informationen finden Sie unter „Prävention“.
Tipps zur Vermeidung
Alle Änderungen für ein bestimmtes Produkt in einem einzelnen Vorgang in einem Batch von Anfragen enthalten. Vermeiden Sie mehrere gleichzeitige Aufrufe der Content API für denselben Händler und dieselbe Store-Kennung oder sorgen Sie dafür, 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 der Fehler wiederholt auftritt.
Tipps zur Vermeidung
–
ungültig
Invalid channel:
'<channel>'
Zusammenfassung
Ungültiger Kanal, der als Teil einer Produkt-ID angegeben wurde.
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
Im Rahmen einer Produkt-ID wurde ein ungültiger Ländercode angegeben.
Beispiel: online:en:not_a_country_code:sku123.
Häufige Ursachen
–
Empfohlene Vorgehensweise
–
Tipps zur Vermeidung
Achten Sie darauf, dass Ihre Produkt-ID das Format channel:languageCode:countryCode:offerId hat und der Ländercode ein gültiger
Ländercode gemäß ISO 3166 ist.
[item id] Invalid item
id: '<id>'
Zusammenfassung
Ungültige Artikel-ID, z.B. sku123 statt online:en:US:sku123.
Häufige Ursachen
Wenn Sie in einer GET- oder DELETE-Anfrage eine Angebots-ID anstelle einer Produkt-ID angeben.
Empfohlene Vorgehensweise
–
Tipps zur Vermeidung
Ihre Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben.
[name] The term '<term>' is not
allowed
Zusammenfassung
Der Name enthält ein verbotenes Wort.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Verwenden Sie einen zulässigen Namen.
Weitere Informationen finden Sie in diesem Hilfeartikel.
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.
Sie haben versucht, den Preis und die Verfügbarkeit eines Onlineprodukts über den Inventarfeed zu aktualisieren, aber in der URL eine andere als die spezielle Store-ID online 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, ist nicht vorhanden.
Häufige Ursachen
Sie versuchen, ein nicht vorhandenes Produkt zu löschen, oder die Produkt-ID wird in der URL für das Löschen nicht richtig angegeben.
Empfohlene Vorgehensweise
Rufen Sie eine Liste der Produkte mit Products.list ab und versuchen Sie nur, die dort aufgeführten Elemente abzurufen, zu aktualisieren oder zu löschen. 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 dadurch ein vorhandener Artikel ü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 bei Google Shopping hochgeladen.
Häufige Ursachen
Produkte, die nicht validiert werden können, werden möglicherweise trotzdem eingefügt, sofern sie kein vorhandenes gültiges Produkt ersetzen. Verwenden Sie das Flag includeInvalidInsertedItems, um Productstatuses.list, damit Ihr Konto nicht zu viele ungültige Produkte enthält.
Empfohlene Vorgehensweise
Suchen Sie nach einer übermäßigen Anzahl ungültiger Produkte und entfernen Sie diese, wie oben beschrieben. Geben Sie außerdem
Ablaufdaten an, wenn Sie Produkte hochladen. Wenn das Ablaufdatum erreicht ist, wird das Produkt automatisch gelöscht. Das Standard- und maximale Ablaufdatum beträgt 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 geprüft. Wenn Sie diesen Fehler bei einem Unterkonto erhalten, prüfen Sie, ob sowohl das Unterkonto als auch Ihr MCA über ein ausreichendes Produktkontingent verfügen.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Zusammenfassung
Anfragen werden zu schnell gestellt. Reduzieren Sie die Häufigkeit der Anfragen.
Häufige Ursachen
Informationen zu Kontingenten pro Minute finden Sie in den veröffentlichten Limits. Wenn Sie diese Grenzwerte überschreiten, wird dieser Fehler angezeigt. Manchmal wird dies durch eine Trafficspitze verursacht oder Ihr Server wird auf eine größere Anzahl von Threads erweitert.
Empfohlene Vorgehensweise
Reduzieren Sie die Gesamtzahl der Anfragen, die pro Minute gesendet werden.
Tipps zur Vermeidung
Wenn Sie diesen Fehler erhalten, 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 für die angegebene Dienstmethode als zulässig.
Häufige Ursachen
Die Kontingente pro Tag finden Sie in den veröffentlichten Limits. Wenn Sie diese Grenzwerte überschreiten, wird dieser Fehler angezeigt.
Empfohlene Vorgehensweise
Reduzieren Sie die Gesamtzahl der Anfragen pro Tag, indem Sie mehrere Änderungen nach Möglichkeit in einer einzigen Anfrage zusammenfassen. Fassen Sie Änderungen an Produkten über einen angemessenen Zeitraum hinweg zusammen, um zu vermeiden, dass sich ein Produkt mehrmals schnell ändert. Für Artikelaktualisierungen, die als Mikrodaten auf Ihrer Website dargestellt werden können, sollten Sie diesen Ansatz verwenden, um die Anzahl der Aufrufe der Dienste Products oder Inventory zu begrenzen.
Wenn Sie weiterhin mehr tägliche Aufrufe für eine bestimmte Methode benötigen, wenden Sie sich bitte an uns und teilen Sie uns Ihre Merchant Center-ID, die Methoden, für die Sie das Kontingentlimit erreichen, eine Schätzung der Anzahl der Aufrufe pro Tag, die Sie für diese Methoden benötigen, und den Grund dafür mit. Wir werden dann mit Ihnen zusammenarbeiten, um Ihr Kontingent zu erhöhen.
Tipps zur Vermeidung
Empfohlene Tipps zur Verarbeitung
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
Batchanfragen für Unterkonten, die gelöscht wurden, oder für neu erstellte Unterkonten, bevor sie verfügbar sind.
Empfohlene Vorgehensweise
Vermeiden Sie Aufrufe, die sich auf ein gelöschtes Unterkonto auswirken.
Tipps zur Vermeidung
Empfohlene Tipps zur Verarbeitung
request_too_large
Zusammenfassung
Sie senden zu viele entries pro Batchanfrage oder überschreiten das Größenlimit für custombatch-Anfragen.
Häufige Ursachen
Sie können maximal 10.000 entries pro custombatch-Anfrage einfügen. Das Limit für die komprimierte Übertragungsgröße beträgt 32 MB.
Empfohlene Vorgehensweise
Teilen Sie den Batch in mehrere Batches auf, die die Grenzwerte nicht überschreiten, 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
Achten Sie darauf, dass der Parameter, hier price, wohlgeformt ist. Beispiel: price hat zwei Pflichtfelder: value und currency.
Tipps zur Vermeidung
–
[product] INSERT request must specify
product
Zusammenfassung
Sie haben eine benutzerdefinierte Batchanfrage an die API gesendet, die einen Eintrag mit "method": "insert", aber ohne Produkt enthält.
Häufige Ursachen
Vergessen, die Methode in get oder delete zu ändern.
Empfohlene Vorgehensweise
Geben Sie über das Feld product ein Produkt an, das eingefügt werden soll.
Tipps zur Vermeidung
Achten Sie darauf, dass für Batcheinträge mit der Methode insert ein Produkt und für Batcheinträge mit der Methode get oder delete eine Produkt-ID angegeben ist.
[productId] DELETE request must specify
productId
Zusammenfassung
Sie haben eine benutzerdefinierte Batch-Anfrage an die API gesendet, die einen Eintrag mit "method": "delete", aber ohne Produkt-ID enthält.
Häufige Ursachen
Vergessen, die Methode in insert zu ändern.
Empfohlene Vorgehensweise
Geben Sie über das Feld productID ein zu löschendes Produkt an.
Tipps zur Vermeidung
Achten Sie darauf, dass für Batcheinträge mit der Methode insert ein Produkt und für Batcheinträge mit der Methode get oder delete eine Produkt-ID angegeben ist.
userRateLimitExceeded
User Rate Limit
Exceeded
Zusammenfassung
Anfragen werden zu schnell gestellt. Reduzieren Sie die Häufigkeit der Anfragen.
Häufige Ursachen
Beachten Sie die in den veröffentlichten Limits aufgeführten Limits für HTTP-Anfragen. Wenn Sie diese Grenzwerte überschreiten, wird dieser Fehler angezeigt. Manchmal wird dies durch eine Trafficspitze verursacht oder Ihr Server wird auf eine größere Anzahl von Threads erweitert.
Empfohlene Vorgehensweise
Reduzieren Sie die Gesamtzahl der Anfragen, die pro Minute gesendet werden. Wenn Sie mehrere Methodenaufrufe für denselben Dienst in einer einzigen custombatch-Anfrage zusammenfassen, wird die Anzahl der HTTP-Anfragen reduziert.
Tipps zur Vermeidung
Wenn Sie diesen Fehler erhalten, verwenden Sie Batching und programmatische Backoff-Strategien, um die Anfragerate auf ein angemessenes, nachhaltiges Niveau zu senken.
Validierung
[adwords_redirect]
Zusammenfassung
Sie haben ein Produkt eingereicht, dessen Feld adwords_redirect keine gültige URL ist.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Prüfen Sie, ob der Wert des Felds
adwords_redirect eine gültige URL ist.
Tipps zur Vermeidung
–
[item] auth/frontend/not_claimed
Zusammenfassung
Die Website-URL des Händlers wurde nicht im Merchant Center beansprucht.
Sie haben eine Marke, eine Beschreibung oder ein anderes Attribut als String eingereicht, der mit der angegebenen Anforderungscodierung nicht geparst werden kann.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Prüfen Sie die Meldung, um herauszufinden, welches Attribut das Problem verursacht. Validieren 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
Sie haben eine Farbe, Beschreibung oder ein anderes Attribut eingereicht, das nicht gültig ist.
Sie haben ein Produkt ohne erforderliches oder empfohlenes Attribut eingereicht.
Häufige Ursachen
–
Empfohlene Vorgehensweise
Achten Sie darauf, dass Sie alle empfohlenen und erforderlichen Attribute für Ihr Produkt angeben. Weitere Informationen finden Sie im Hilfeartikel Feed-Spezifikation.
Tipps zur Vermeidung
–
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website
Zusammenfassung
Sie haben ein Produkt mit einer Basis-URL eingereicht, die sich von der URL unterscheidet, die für das Merchant Center-Konto beansprucht wurde.
[[["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: 2026-07-06 (UTC)."],[],["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"]]
