Lädt eine Produkteingabe in Ihr Merchant Center-Konto hoch. Wenn bereits eine Eingabe mit denselben Werten für contentLanguage, OfferId und dataSource vorhanden ist, wird dieser Eintrag durch diese Methode ersetzt.
Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das verarbeitete Produkt abgerufen werden kann.
HTTP-Anfrage
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Das Konto, in das das Produkt eingefügt wird. Format: accounts/{account} |
Abfrageparameter
Parameter | |
---|---|
dataSource |
Erforderlich. Der Name der primären oder ergänzenden Produktdatenquelle. Wenn das Produkt bereits vorhanden ist und die angegebene Datenquelle nicht übereinstimmt, wird das Produkt in eine neue Datenquelle verschoben. Format: |
Anfragetext
Der Anfragetext enthält eine Instanz von ProductInput
.
Antworttext
Diese Ressource bezieht sich auf die Eingabedaten, die Sie für ein Produkt einreichen, nicht für das verarbeitete Produkt, das Sie im Merchant Center, in Shopping-Anzeigen oder auf Google-Plattformen sehen. Produkteingaben, Regeln und ergänzende Datenquellendaten werden kombiniert, um das verarbeitete [Produkt][google.shopping.content.bundles.Products.Product] zu erstellen.
Die erforderlichen Produkteingabeattribute zum Bestehen von Datenvalidierungsprüfungen werden primär in der Produktdatenspezifikation definiert.
Die folgenden Attribute sind erforderlich: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] und [offerId][google.shopping.content.bundles.Products.offer_id].
Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das verarbeitete Produkt abgerufen werden kann.
Alle Felder in der Produkteingabe und den zugehörigen Untermitteilungen stimmen bis auf einige Ausnahmen mit dem englischen Namen des entsprechenden Attributs in der Branchenspezifikation überein.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "name": string, "product": string, "channel": enum ( |
Felder | |
---|---|
name |
Kennung. Der Name der Produkteingabe. Format: |
product |
Nur Ausgabe. Der Name des verarbeiteten Produkts. Format: |
channel |
Erforderlich. Nicht veränderbar. Der Kanal des Produkts. |
offerId |
Erforderlich. Nicht veränderbar. Ihre eindeutige Kennzeichnung für das Produkt. Dies gilt auch für die Produkteingabe und das verarbeitete Produkt. Voran- und nachgestellte Leerzeichen werden entfernt und mehrere Leerzeichen beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation. |
contentLanguage |
Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode für das Produkt. |
feedLabel |
Erforderlich. Nicht veränderbar. Das Feedlabel für das Produkt. |
attributes |
Optional. Eine Liste von Produktattributen. |
customAttributes[] |
Optional. Eine Liste benutzerdefinierter (vom Händler bereitgestellt) Attribute. Sie kann auch verwendet werden, um beliebige Attribute der Datenspezifikation in generischer Form einzureichen (z. B. |
versionNumber |
Optional. Die vorhandene Version (Aktualität) des Produkts, mit der die richtige Reihenfolge beibehalten werden kann, wenn mehrere Updates gleichzeitig vorgenommen werden. Wenn diese Richtlinie konfiguriert ist, wird das Einfügen verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Mit dem aktuellen Wird nur für Einfügungen in primäre Datenquellen unterstützt. Wenn der Vorgang verhindert wird, wird die abgebrochene Ausnahme ausgelöst. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/content
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.