Im Folgenden finden Sie eine Liste mit Fehlern in alphabetischer Reihenfolge.
auth/account_access_denied
User cannot access account
<account_number>
Zusammenfassung
Eine Anfrage wurde gesendet, die auf ein Konto ausgerichtet ist, auf das der authentifizierte Nutzer keinen Zugriff hat.
Allgemeine Ursachen
Fehler in der Zielhändler-ID oder Vergessenwerden, den Nutzer im Merchant Center zu registrieren.
Empfohlene Vorgehensweise
Achte darauf, dass die Ausrichtung auf das richtige Konto erfolgt, oder registriere dich im Merchant Center (Einstellungen > Nutzer) als Nutzer des Kontos.
Tipps zur Prävention
Nicht zutreffend
User is not an administrator of
account <account_number>
Zusammenfassung
Eine Anfrage zum Ändern eines Kontos gesendet, für das der authentifizierte Nutzer keine Administratorrechte hat.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Legen Sie Administratorrechte für den authentifizierten Nutzer fest.
Tipps zur Prävention
Nicht zutreffend
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
Tipps zur Vorbeugung ansehen.
Tipps zur Prävention
Sie können alle Änderungen für ein bestimmtes Produkt an einem einzelnen Vorgang in einer Gruppe von Anfragen in Batches zusammenfassen. Vermeiden Sie mehrere gleichzeitige Aufrufe der Content API für denselben Händler- und Geschäftscode oder achten Sie darauf, dass diese Aufrufe keine sich überschneidenden Produkte enthalten.
internalError
Internal error
Zusammenfassung
Es gibt ein Problem mit dem Google-Backend.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Wiederholen Sie die Anfrage.
Sollte es immer wieder zu Fehlern kommen, wenden Sie sich an uns.
Tipps zur Prävention
Nicht zutreffend
ungültig
Invalid channel:
'<channel>'
Zusammenfassung
Ungültiger Kanal als Teil einer Produkt-ID angegeben.
Beispiel: not_a_channel:en:US:sku123.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Nicht zutreffend
Tipps zur Prävention
Deine 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
Als Teil einer Produkt-ID wurde ein ungültiger Ländercode angegeben.
Beispiel: online:en:not_a_country_code:sku123.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Nicht zutreffend
Tipps zur Prävention
Deine Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben 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.
Allgemeine Ursachen
Angabe einer Angebots-ID anstelle einer Produkt-ID in einer GET- oder DELETE-Anfrage.
Empfohlene Vorgehensweise
Nicht zutreffend
Tipps zur Prävention
Deine Produkt-ID muss das Format channel:languageCode:countryCode:offerId haben.
Sie haben versucht, den Preis und die Verfügbarkeit eines Onlineprodukts über den Inventarfeed zu aktualisieren, haben aber einen anderen Wert als den Sonderwert online als Geschäfts-ID in der URL angegeben.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Ändern Sie in der Anfrage-URL die Store-ID in online.
Tipps zur Prävention
Gib in allen Inventarabfragen online für Onlineprodukte und die Shop-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.
Allgemeine Ursachen
Es wird versucht, ein nicht vorhandenes Produkt zu löschen oder die Produkt-ID in der URL zum Löschen nicht korrekt anzugeben.
Empfohlene Vorgehensweise
Erstelle mit Products.list eine Liste von Produkten und versuche nur, die dort angezeigten Elemente abzurufen, zu aktualisieren oder zu löschen. Gib die Produkt-ID im Format channel:languageCode:countryCode:offerId an, z. B. online:ru:RU:277104-ekb und nicht als Angebots-ID, die so aussieht: 277104-ekb.
Tipps zur Prävention
Nicht zutreffend
not_inserted
The item could not be
inserted.
Zusammenfassung
Aufgrund anderer Fehler konnte das Produkt nicht eingefügt werden, da es einen vorhandenen gültigen Eintrag überschreiben würde.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Prüfen Sie die anderen Fehler für denselben Aufruf und beheben Sie sie, bevor Sie versuchen, die neuen Produktinformationen wieder einzufügen.
Tipps zur Prävention
Nicht zutreffend
Kontingent
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 trotzdem eingefügt werden, wenn sie kein vorhandenes gültiges Produkt ersetzen. Sie können das Flag includeInvalidInsertedItems für Productstatuses.list verwenden, damit Ihr Konto nicht übermäßig viele ungültige Produkte enthält.
Empfohlene Vorgehensweise
Prüfen Sie, wie oben erwähnt, eine übermäßige Anzahl ungültiger Produkte und entfernen Sie diese. Außerdem müssen Sie beim Hochladen von Produkten
Ablaufdaten angeben. Wenn das Ablaufdatum erreicht ist, wird das Produkt automatisch gelöscht. Beachten Sie, dass das standardmäßige und maximale Ablaufdatum 30 Tage nach dem Einfügen oder Aktualisieren des Produkts beträgt.
Hinweis: Das Artikelkontingent für ein Mehrfachkundenkonto wird mit der Gesamtzahl der Produkte in allen Unterkonten verglichen. Wenn dieser Fehler bei einem Unterkonto auftritt, prüfen Sie, ob sowohl das Unterkonto als auch Ihr MCA genügend Produktkontingente haben.
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
Die Kontingente pro Minute sind in den veröffentlichten Limits aufgeführt. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Dies kann manchmal durch eine Spitze im Traffic verursacht werden oder der Server erweitert sich zu einer größeren Anzahl von Threads.
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 geeignetes tragfähiges Niveau zu reduzieren.
daily_limit_exceeded:
merchant quota exceeded
Zusammenfassung
Sie stellen mehr als die zulässige Anzahl von Anfragen pro Tag für die angegebene Dienstmethode.
Allgemeine Ursachen
Weitere Informationen finden Sie in den veröffentlichten Limits. 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. Sie sollten Änderungen an Produkten über einen geeigneten Zeitraum in Batches zusammenfassen, um ein schnelles mehrfaches Ändern eines Produkts zu vermeiden. Mit diesem Ansatz können Sie die Anzahl der Aufrufe der Dienste Products oder Inventory für Artikelupdates, die auf Ihrer Website als Mikrodaten dargestellt werden können, begrenzen.
Wenn Sie mehr tägliche Aufrufe für eine bestimmte Methode benötigen, kontaktieren Sie uns und teilen Sie uns Ihre Merchant Center-ID mit, bei welchen Methoden Sie die Kontingentlimits erreichen, und eine Schätzung, wie viele Aufrufe pro Tag Sie für diese Methoden benötigen und warum. Wir arbeiten mit Ihnen zusammen, um Ihr Kontingent zu erhöhen.
Tipps zur Prävention
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
Mehrere Anfragen für bereits gelöschte Unterkonten oder für neu erstellte Unterkonten senden, bevor diese verfügbar sind.
Empfohlene Vorgehensweise
Vermeiden Sie Aufrufe, die sich auf ein gelöschtes Unterkonto auswirken.
Tipps zur Prävention
Empfohlene Verwendung
request_too_large
Zusammenfassung
Sie senden zu viele entries pro Batchanfrage oder überschreiten die Größenbeschränkung 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 die Limits unterschreiten, 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
Sie haben einen Preis ohne Wert angegeben. Beispiel: { "currency": "USD" } statt { "value": 123, "currency": "USD" }.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Der Parameter, hier price, muss korrekt formatiert sein. price hat beispielsweise zwei Pflichtfelder: value und currency.
Tipps zur Prävention
Nicht zutreffend
[product] INSERT request must specify
product
Zusammenfassung
Eine benutzerdefinierte Batchanfrage wurde an die API gesendet, die einen Eintrag mit "method": "insert", aber kein Produkt enthält.
Allgemeine Ursachen
Es wird vergessen, die Methode in get oder delete zu ändern.
Empfohlene Vorgehensweise
Geben Sie ein Produkt an, das über das Feld product 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
Eine benutzerdefinierte Batch-Anfrage wurde 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 über das Feld productID ein 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 in den Limits für HTTP-Anfragen, die in den Limits für Veröffentlichungen aufgeführt sind. Wenn Sie diese Grenzwerte überschreiten, erhalten Sie diese Fehlermeldung. Manchmal kommt es zu einer Spitze im Traffic, die dies verursacht, oder der Server erweitert sich zu einer größeren Anzahl von Threads.
Empfohlene Vorgehensweise
Reduzieren Sie die Gesamtzahl der pro Minute gesendeten Anfragen. Werden mehrere Methodenaufrufe an denselben Dienst in einer einzigen custombatch-Anfrage zusammengefasst, sinkt die Anzahl der HTTP-Anfragen.
Tipps zur Prävention
Wenn Sie diesen Fehler erhalten, verwenden Sie Batch- und programmatische Backoff-Strategien, um Ihre Anfragerate auf ein geeignetes Niveau zu reduzieren.
validation
[adwords_redirect]
Zusammenfassung
Sie haben ein Produkt eingereicht, dessen Feld adwords_redirect keine gültige URL enthält.
Die Marke, eine Beschreibung oder ein anderes Attribut wurde als String eingereicht, der nicht mit der angegebenen Anfragecodierung geparst werden kann.
Allgemeine Ursachen
Nicht zutreffend
Empfohlene Vorgehensweise
Sehen Sie in der Nachricht nach, welches Attribut das Problem verursacht. Überprüfen Sie dann die Textcodierung des entsprechenden Werts, bevor Sie ihn noch einmal senden. Die API akzeptiert nur gültige UTF-8-Zeichen.
Tipps zur Prävention
Nicht zutreffend
[<attribute>] invalid_value
Zusammenfassung
Sie haben eine Farbe, eine Beschreibung oder ein anderes Attribut angegeben, das ungültig ist.
[null,null,["Zuletzt aktualisiert: 2024-07-03 (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"]]
