Method: accounts.productInputs.insert

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

string

Erforderlich. Das Konto, in das dieses Produkt eingefügt wird. Format: accounts/{account}

Abfrageparameter

Parameter
dataSource

string

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: accounts/{account}/dataSources/{datasource}.

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 hauptsächlich 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.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Felder
name

string

Kennung. Der Name der Produkteingabe. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Nur Ausgabe. Der Name des verarbeiteten Produkts. Format: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Erforderlich. Nicht veränderbar. Der Kanal des Produkts.
offerId

string

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

string

Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode für das Produkt.
feedLabel

string

Erforderlich. Nicht veränderbar. Das Feedlabel für das Produkt.
attributes

object (Attributes)

Optional. Eine Liste von Produktattributen.
customAttributes[]

object (CustomAttribute)

Optional. Eine Liste benutzerdefinierter (vom Händler bereitgestellt) Attribute. Sie können damit auch Attribute der Datenspezifikation in generischer Form einreichen (z. B. { "name": "size type", "value": "regular" }). Dies ist nützlich, um Attribute einzureichen, die nicht explizit von der API freigegeben werden, z. B. zusätzliche Attribute für Buy on Google. Die maximal zulässige Anzahl von Zeichen für jedes benutzerdefinierte Attribut beträgt 10.240 (die Summe der Zeichen für Name und Wert). Pro Produkt können maximal 2.500 benutzerdefinierte Attribute mit einer Gesamtgröße von 102, 4 KB festgelegt werden. Unterstriche in benutzerdefinierten Attributnamen werden beim Einfügen durch Leerzeichen ersetzt.
versionNumber

string (int64 format)

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 versionNumber kann das Produkt wieder eingefügt werden (z. B. eine Produktaktualisierung nach 30 Tagen).

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.