Häufige Fehler

Dies sind die häufigsten Fehler:

• notFound: Element nicht gefunden.
• not_inserted: Das Element konnte nicht eingefügt werden.
• [link] validation/invalid_value for <destinations>: URLs gehören nicht zu Ihrer Website.
• quota/too_many_items::Händlerkontingent überschritten.

Im Folgenden finden Sie eine Liste von Fehlern in alphabetischer Reihenfolge.

Hinweis :Weitere Informationen zu Problemen mit der Datenqualität oder Kontosperrungen, unabhängig von der Content API for Shopping, finden Sie unter Maßnahmen auf Kontoebene bei Nichterfüllung der Anforderungen an Produktdaten. Sie können fehlerhafte Anfragen auch über das API-Dashboard aufrufen.

auth/account_access_denied

User cannot access account <account_number>
Zusammenfassung	Hat eine Anfrage an ein Konto gesendet, auf das der authentifizierte Nutzer keinen Zugriff hat.
Allgemeine Ursachen	Fehler in der Zielhändler-ID oder vergessen, den Nutzer im Merchant Center zu registrieren.
Empfohlene Vorgehensweise	Prüfen Sie, ob Sie Ihre Anzeigen auf das richtige Konto ausrichten, oder registrieren Sie sich im Merchant Center (Einstellungen > Nutzer) als Nutzer des Kontos.
Tipps zur Prävention	NA
User is not an administrator of account <account_number>
Zusammenfassung	Anfrage zum Ändern eines Kontos gesendet, für das der authentifizierte Nutzer keine Administratorrechte hat
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Legen Sie Administratorrechte für den authentifizierten Nutzer fest.
Tipps zur Prävention	NA

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 in Konflikt stehende Vorgänge gleichzeitig versucht.
Allgemeine Ursachen	Eine einzelne Batchanfrage enthält mehrere in Konflikt stehende Vorgänge für dasselbe Produkt oder mehrere in Konflikt stehende Vorgänge für dasselbe Produkt wurden gleichzeitig an die Content API gesendet.
Empfohlene Vorgehensweise	Sehen Sie sich die Tipps zur Vorbeugung an.
Tipps zur Prävention	Alle Änderungen für ein bestimmtes Produkt an einem einzelnen Vorgang in einem Batch-Satz von Anfragen enthalten. Vermeiden Sie mehrere gleichzeitige Aufrufe der Content API für denselben Händler und Geschäftscode und achten Sie darauf, dass diese Aufrufe keine sich überschneidenden Produkte enthalten.

internalError

Internal error
Zusammenfassung	Es gibt ein Problem mit dem Google-Back-End.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Wiederholen Sie die Anfrage. Teilen Sie uns im Forum mit, wenn es wiederholt fehlschlägt.
Tipps zur Prävention	NA

ungültig

Invalid channel: '<channel>'
Zusammenfassung	Ungültiger Kanal als Teil einer Produkt-ID angegeben. Beispiel: not_a_channel:en:US:sku123.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	NA
Tipps zur Prävention	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 als Teil einer Produkt-ID angegeben. Beispiel: online:en:not_a_country_code:sku123.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	NA
Tipps zur Prävention	Deine Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben und der Ländercode ist ein gültiger ISO 3166-Ländercode.
[item id] Invalid item id: '<id>'
Zusammenfassung	Ungültige Artikel-ID, z.B. sku123 anstelle von online:en:US:sku123.
Allgemeine Ursachen	Angabe einer Angebots-ID anstelle einer Produkt-ID in einer GET- oder DELETE-Anfrage.
Empfohlene Vorgehensweise	NA
Tipps zur Prävention	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.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Verwenden Sie einen zulässigen Namen. Weitere Informationen finden Sie im Hilfeartikel zu Feedspezifikationen.
Tipps zur Prävention	NA
[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.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Währung und Land müssen korrekt angegeben sein. Weitere Informationen finden Sie im Abschnitt zu price im Hilfeartikel zu Feedspezifikationen.
Tipps zur Prävention	NA
[storeCode] storeCode must be 'online'
Zusammenfassung	Es wurde versucht, den Preis und die Verfügbarkeit eines Onlineprodukts über den Inventarfeed zu aktualisieren, aber in der URL wurde etwas anderes als den speziellen Wert online als Geschäfts-ID angegeben.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Ändern Sie in der Anfrage-URL die Geschäfts-ID zu online.
Tipps zur Prävention	Achten Sie darauf, dass Sie in allen Ihren Inventarabfragen online für Onlineprodukte und die Geschäfts-ID für lokal erhältliche Produkte angeben.
[<attribute>]
Zusammenfassung	Das in den eckigen Klammern angegebene Element ist ungültig.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Korrigieren Sie die Spezifikation des problematischen Elements. Weitere Informationen finden Sie im Hilfeartikel zur Feedspezifikation.
Tipps zur Prävention	NA

notFound

Item not found
Zusammenfassung	Das Element, das Sie abrufen, aktualisieren oder löschen möchten, ist nicht vorhanden.
Allgemeine Ursachen	Sie versuchen, ein nicht vorhandenes Produkt zu löschen, oder Sie geben die Produkt-ID in der zu löschenden URL nicht richtig an.
Empfohlene Vorgehensweise	Sie können mit Products.list eine Liste der Produkte abrufen und nur versuchen, dort vorhandene Elemente abzurufen, zu aktualisieren oder zu löschen. Gib die Produkt-ID im Format channel:languageCode:countryCode:offerId an. Beispiel: online:ru:RU:277104-ekb anstelle der Angebots-ID, die so aussieht: 277104-ekb.
Tipps zur Prävention	NA

not_inserted

The item could not be inserted.
Zusammenfassung	Aufgrund anderer Fehler konnte das Produkt nicht eingefügt werden, da es einen vorhandenen fehlerfreien Eintrag überschreiben würde.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Prüfen Sie die anderen Fehler auf denselben Aufruf und beheben Sie sie, bevor Sie versuchen, die neuen Produktinformationen noch einmal einzugeben.
Tipps zur Prävention	NA

quota

too_many_items: Merchant quota exceeded
Zusammenfassung	Es wurden zu viele Artikel auf Google Shopping hochgeladen.
Allgemeine Ursachen	Produkte, die nicht validiert werden können, können weiterhin eingefügt werden, wenn sie ein vorhandenes gültiges Produkt nicht ersetzen. Sie können das Flag includeInvalidInsertedItems für Productstatuses.list verwenden, damit Ihr Konto nicht zu viele ungültige Produkte enthält.
Empfohlene Vorgehensweise	Prüfen Sie, ob wie oben erwähnt übermäßig viele ungültige Produkte vorhanden sind, und entfernen Sie diese. Außerdem müssen Sie beim Hochladen von Produkten ein Ablaufdatum angeben. Wenn das Ablaufdatum erreicht ist, wird das Produkt automatisch gelöscht. Das standardmäßige und maximale Ablaufdatum beträgt 30 Tage nach dem Einfügen oder Aktualisieren von Produkten. Hinweis: Das Artikelkontingent für ein Mehrfachkundenkonto wird mit der Gesamtzahl der Produkte in allen Unterkonten verglichen. Wenn Sie diesen Fehler bei einem Unterkonto erhalten, prüfen Sie, ob sowohl das Unterkonto als auch Ihr Mehrfachkundenkonto genügend Produktkontingent haben. Wenn Sie diese Lösungen ausprobiert haben und immer noch nicht genügend Speicherplatz für neue Produkte in Ihrem Merchant Center-Konto vorhanden ist, können Sie die Möglichkeit zum Einreichen weiterer Artikel in Ihrem Konto beantragen.
Tipps zur Prävention	Weitere Informationen finden Sie unter Empfohlene Verwendung.
too_many_subaccounts: Maximum number of subaccounts reached
Zusammenfassung	Sie haben die maximal zulässige Anzahl von Unterkonten für Ihr Mehrfachkundenkonto erreicht.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Veraltete Unterkonten löschen Wenn alle Ihre Konten aktiv sind, können Sie die Erstellung zusätzlicher Unterkonten in Ihrem Mehrfachkundenkonto anfordern.
Tipps zur Prävention	NA
request_rate_too_high: Request rate too high. Please reduce your throughput
Zusammenfassung	Anfragen werden zu schnell gestellt. Verringern Sie die Anfragehäufigkeit.
Allgemeine Ursachen	Beachten Sie die unter veröffentlichten Limits aufgeführten Kontingente pro Minute. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Manchmal gibt es eine Traffic-Spitze, die dies verursacht, oder Ihr Server wird zu einer größeren Anzahl von Threads erweitert.
Empfohlene Vorgehensweise	Reduzieren Sie die Gesamtzahl der pro Minute gesendeten Anfragen.
Tipps zur Prävention	Wenn Sie diesen Fehler erhalten, verwenden Sie programmatische Backoff-Strategien, um Ihre Anfragerate auf ein angemessenes nachhaltiges Niveau zu senken.
daily_limit_exceeded: merchant quota exceeded
Zusammenfassung	Sie senden mehr als die zulässige Anzahl von Anfragen pro Tag für die angegebene Dienstmethode.
Allgemeine Ursachen	Beachten Sie die Tageskontingente, die unter veröffentlichte Limits aufgeführt sind. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung.
Empfohlene Vorgehensweise	Reduzieren Sie die Gesamtzahl der pro Tag gesendeten Anfragen, indem Sie nach Möglichkeit mehrere Änderungen in einer einzigen Anfrage zusammenfassen. Ziehen Sie in Betracht, Änderungen an Produkten über einen angemessenen Zeitraum im Batch vorzunehmen, um zu vermeiden, dass sich ein Produkt mehrmals schnell ändert. Bei Artikelupdates, die auf deiner Website als Mikrodaten dargestellt werden können, kannst du mit diesem Ansatz die Anzahl der Aufrufe der Dienste Products oder Inventory begrenzen. Wenn Sie noch mehr tägliche Aufrufe für eine bestimmte Methode benötigen, kontaktieren Sie uns und teilen Sie uns Ihre Merchant Center-ID mit, für welche Methoden Sie Kontingentlimits erreichen und wie viele Aufrufe pro Tag Sie schätzungsweise für diese Methoden benötigen. Wir helfen Ihnen dann gern dabei, Ihr Kontingent zu erhöhen.
Tipps zur Prävention	Weitere Informationen finden Sie unter Empfohlene Verwendung.
too_many_failed_auths: Too many failed authentications.
Zusammenfassung	Sie stellen zu viele Batchanfragen für Konten, auf die Sie keinen Zugriff haben.
Allgemeine Ursachen	Anfragen für gelöschte oder neu erstellte Unterkonten stapelweise stellen, bevor diese verfügbar sind.
Empfohlene Vorgehensweise	Vermeiden Sie Aufrufe, die ein gelöschtes Unterkonto betreffen.
Tipps zur Prävention	Weitere Informationen finden Sie unter Empfohlene Verwendung.
request_too_large
Zusammenfassung	Sie senden zu viele entries pro Batchanfrage oder überschreiten das Größenlimit von custombatch für Anfragen.
Allgemeine Ursachen	Sie können maximal 10.000 entries pro custombatch-Anfrage angeben. Die komprimierte Übertragungsgröße beträgt 32 MB.
Empfohlene Vorgehensweise	Teilen Sie den Batch in mehrere Batches auf, die unter den Limits liegen, und versuchen Sie es dann noch einmal.
Tipps zur Prävention	Wir empfehlen,nicht mehr als 1.000 Einträge pro Batch zu senden.

erforderlich

[price.value] Required parameter: price.value
Zusammenfassung	Preis ohne Wert angegeben. Beispiel: { "currency": "USD" } anstelle von { "value": 123, "currency": "USD" }.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Achten Sie darauf, dass der Parameter, hier price, korrekt formatiert ist. price hat beispielsweise zwei Pflichtfelder: value und currency.
Tipps zur Prävention	NA
[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.
Allgemeine Ursachen	Es wird vergessen, die Methode zu get oder delete zu ändern.
Empfohlene Vorgehensweise	Geben Sie über das Feld product ein Produkt an, das eingefügt werden soll.
Tipps zur Prävention	Achten Sie darauf, dass Batcheinträge mit der Methode insert ein Produkt und Batcheinträge mit der Methode get oder delete eine Produkt-ID angeben.
[productId] DELETE request must specify productId
Zusammenfassung	Es wurde eine benutzerdefinierte Batchanfrage an die API gesendet, die einen Eintrag mit "method": "delete", aber ohne Produkt-ID enthält.
Allgemeine Ursachen	Es wird vergessen, die Methode in insert zu ändern.
Empfohlene Vorgehensweise	Geben Sie im Feld productID das Produkt an, das gelöscht werden soll.
Tipps zur Prävention	Achten Sie darauf, dass Batcheinträge mit der Methode insert ein Produkt und Batcheinträge mit der Methode get oder delete eine Produkt-ID angeben.

userRateLimitExceeded

User Rate Limit Exceeded
Zusammenfassung	Anfragen werden zu schnell gestellt. Verringern Sie die Anfragehäufigkeit.
Allgemeine Ursachen	Weitere Informationen finden Sie unter Beschränkungen für HTTP-Anfragen. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Manchmal gibt es eine Traffic-Spitze, die dies verursacht, oder Ihr Server erweitert sich zu einer größeren Anzahl von Threads.
Empfohlene Vorgehensweise	Reduzieren Sie die Gesamtzahl der pro Minute gesendeten Anfragen. Wenn Sie mehrere Methodenaufrufe an denselben Dienst in einer einzigen custombatch-Anfrage zusammenfassen, wird die Anzahl der HTTP-Anfragen verringert.
Tipps zur Prävention	Wenn Sie diesen Fehler erhalten, verwenden Sie Batch- und programmatische Backoff-Strategien, um Ihre Anfragerate auf ein angemessenes nachhaltiges Niveau zu reduzieren.

validation

[adwords_redirect]
Zusammenfassung	Sie haben ein Produkt eingereicht, dessen Feld adwords_redirect keine gültige URL enthält.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Achten Sie darauf, dass der Wert des Felds adwords_redirect eine gültige URL ist.
Tipps zur Prävention	NA
[item] auth/frontend/not_claimed
Zusammenfassung	Die Website-URL des Händlers wurde im Merchant Center nicht beansprucht.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Beanspruchen Sie die URL im Merchant Center. Eine detaillierte Anleitung dazu finden Sie in der Hilfe.
Tipps zur Prävention	NA
[energy_efficiency_class] validation/feed
Zusammenfassung	Für dasselbe Produkt wurden sowohl energyEfficiencyClass als auch Preis pro Einheit angegeben.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Geben Sie nur die Energieeffizienzklasse oder den Preis pro Einheit an, nicht beides.
Tipps zur Prävention	NA
[item] internal
Zusammenfassung	Ein interner Fehler ist aufgetreten.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Wiederholen Sie die Anfrage. Teilen Sie uns dies im Forum mit, wenn es wiederholt fehlschlägt.
Tipps zur Prävention	NA
[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.
Allgemeine Ursachen	Mehr als eine Größe für ein Produkt und eine Artikelgruppen-ID angeben
Empfohlene Vorgehensweise	Reichen Sie für jeden Wert eines bestimmten Variantenattributs ein anderes Produkt ein, z. B. size.
Tipps zur Prävention	NA
[additional_image_link] invalid_attribute
Zusammenfassung	Mehr als zehn zusätzliche Bildlinks eingereicht.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Begrenzen Sie die Anzahl der zusätzlichen Bildlinks auf zehn.
Tipps zur Prävention	NA
[<attribute>] invalid_character
Zusammenfassung	Hat eine Marke, eine Beschreibung oder ein anderes Attribut als String eingereicht, der nicht mit der angegebenen Anfragecodierung geparst wird.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Prüfen Sie die Nachricht, um herauszufinden, welches Attribut das Problem verursacht. Prüfen Sie dann die Textcodierung des entsprechenden Werts, bevor Sie die Anfrage noch einmal senden. Die API akzeptiert nur gültige UTF-8-Zeichen.
Tipps zur Prävention	NA
[<attribute>] invalid_value
Zusammenfassung	Eine Farbe, eine Beschreibung oder ein anderes Attribut ist ungültig.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Es wird sichergestellt, 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 zu eindeutigen Produktkennzeichnungen.
Tipps zur Prävention	NA
[<attribute>] missing_recommended / missing_required
Zusammenfassung	Sie haben ein Produkt ohne erforderliches/empfohlenes Attribut eingereicht.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Achten Sie darauf, dass Sie alle empfohlenen / erforderlichen Attribute für Ihr Produkt angeben. Weitere Informationen finden Sie im Hilfeartikel zu Feedspezifikationen.
Tipps zur Prävention	NA
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
Zusammenfassung	Sie haben ein Produkt mit einer Basis-URL eingereicht, die von der URL abweicht, die vom Merchant Center-Konto beansprucht wird.
Allgemeine Ursachen	NA
Empfohlene Vorgehensweise	Achten Sie darauf, dass die URLs der eingereichten Produkte mit der Website übereinstimmen, die vom Merchant Center beansprucht wird.
Tipps zur Prävention	NA