Die häufigsten Fehler sind:
notFound: Artikel nicht gefunden.not_inserted: Das Element konnte nicht eingefügt werden.[link] validation/invalid_value for <destinations>: Die URLs gehören nicht zu Ihrer Website.- quota/too_many_items::Händlerkontingent überschritten.
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. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Achten Sie darauf, dass die Währung
und das Land richtig angegeben sind. Weitere Informationen finden Sie im Abschnitt zu price im Hilfeartikel zur Feed-Spezifikation. |
| 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 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. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Beheben Sie das Problem mit dem Artikel. Weitere Informationen finden Sie im Hilfeartikel zur Feed-Spezifikation. |
| Tipps zur Vermeidung | – |
notFound
Item not found |
|
|---|---|
| Zusammenfassung | 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. Wenn Sie diese Lösungen ausprobiert haben und in Ihrem Merchant Center-Konto immer noch nicht genügend Speicherplatz für neue Produkte vorhanden ist, können Sie die Möglichkeit beantragen, weitere Artikel in Ihrem Konto einzureichen. |
| Tipps zur Vermeidung | Empfohlene Tipps zur Verarbeitung |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| Zusammenfassung | Sie haben die maximal zulässige Anzahl von Unterkonten für Ihr Multi-Client-Konto erreicht. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Veraltete Unterkonten löschen Wenn alle Ihre Konten aktiv sind, können Sie beantragen, dass Sie zusätzliche Unterkonten in Ihrem MCA erstellen dürfen. |
| Tipps zur Vermeidung | – |
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 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. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Beanspruchen Sie die URL im Merchant Center. Eine detaillierte Anleitung dazu finden Sie in der Hilfe. |
| Tipps zur Vermeidung | – |
[energy_efficiency_class]
validation/feed |
|
| Zusammenfassung | Sie haben sowohl energyEfficiencyClass als auch
Grundpreis für dasselbe Produkt angegeben. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Geben Sie nur die Energieeffizienzklasse oder den Grundpreis an, nicht beides. |
| Tipps zur Vermeidung | – |
[item] internal |
|
| Zusammenfassung | Ein interner Fehler. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Wiederholen Sie die Anfrage. Wenden Sie sich an uns, wenn der Vorgang wiederholt fehlschlägt. |
| Tipps zur Vermeidung | – |
[item_group_id] invalid_attribute |
|
| Zusammenfassung | Sie haben einen Artikel mit itemGroupId und vielen Werten für ein Variantenattribut (Farbe, Größe, Muster oder Material) eingereicht. |
| Häufige Ursachen | Sie geben mehr als eine Größe für ein Produkt an, während Sie eine Artikelgruppen-ID angeben. |
| Empfohlene Vorgehensweise | Reichen Sie für jeden Wert eines bestimmten Variantenattributs, z. B.
size, ein anderes Produkt ein. |
| Tipps zur Vermeidung | – |
[additional_image_link]
invalid_attribute |
|
| Zusammenfassung | Sie haben mehr als zehn zusätzliche Bildlinks eingereicht. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Begrenzen Sie die Anzahl der zusätzlichen Bildlinks auf 10. |
| Tipps zur Vermeidung | – |
[<attribute>] invalid_character |
|
| Zusammenfassung | 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. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Achten Sie darauf, dass alle Attribute der Feedspezifikation entsprechen. Weitere Informationen finden Sie im Hilfeartikel zur Feedspezifikation. Informationen zu Problemen mit GTIN oder MPN finden Sie im Hilfeartikel Eindeutige Produktkennzeichnungen. |
| Tipps zur Vermeidung | – |
[<attribute>]
missing_recommended/missing_required |
|
| Zusammenfassung | 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. |
| Häufige Ursachen | – |
| Empfohlene Vorgehensweise | Die URLs für eingereichte Produkte müssen mit der im Merchant Center beanspruchten Website übereinstimmen. |
| Tipps zur Vermeidung | – |