REST Resource: accounts.productInputs

Ressource: ProductInput

Diese Ressource enthält die Eingabedaten, die Sie für ein Produkt einreichen, nicht das verarbeitete Produkt, das Sie im Merchant Center, in Shopping-Anzeigen oder auf Google-Plattformen sehen. Produkteingaben, Regeln und Daten aus zusätzlichen Datenquellen werden kombiniert, um die verarbeiteten Product zu erstellen.

Die erforderlichen Eingabeattribute für Produkte, die die Datenvalidierungschecks bestehen müssen, sind in erster Linie in der Produktdatenspezifikation definiert.

Die folgenden Attribute sind erforderlich: feedLabel, contentLanguage und offerId.

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 ihren untergeordneten Nachrichten stimmen mit dem englischen Namen des entsprechenden Attributs in der Branchenspezifikation überein, mit einigen Ausnahmen.

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}}", wobei der letzte Abschnitt productinput aus vier Teilen besteht: channel~contentLanguage~feedLabel~offerId. Beispiel für den Namen der Produkteingabe: „accounts/123/productInputs/online~en~US~sku123“.
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 Kennung für das Produkt. Das gilt sowohl für die Produktaufnahme als auch für das verarbeitete Produkt. Vorangehende und nachstehende Leerzeichen werden entfernt und mehrere Leerzeichen werden beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation.
contentLanguage

string

Erforderlich. Nicht veränderbar. Der aus zwei Buchstaben bestehende 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 von benutzerdefinierten (vom Händler bereitgestellten) Attributen. Außerdem kann es zum Einreichen beliebiger Attribute der Datenspezifikation in ihrer generischen Form verwendet werden (z. B. { "name": "size type", "value": "regular" }). Das ist nützlich, um Attribute einzureichen, die nicht explizit von der API bereitgestellt werden, z. B. zusätzliche Attribute, die für Buy on Google verwendet werden. Die maximale Anzahl von Zeichen für jedes benutzerdefinierte Attribut beträgt 10.240 (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. Stellt die vorhandene Version (Aktualität) des Produkts dar. Damit kann die richtige Reihenfolge bei mehreren gleichzeitigen Aktualisierungen beibehalten werden.

Wenn diese Option festgelegt ist, wird die Einfügung verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Die erneute Einfügung (z. B. Produktaktualisierung nach 30 Tagen) kann mit der aktuellen versionNumber erfolgen.

Nur für Einfügungen in primäre Datenquellen unterstützt.

Wenn der Vorgang verhindert wird, wird die abgebrochene Ausnahme ausgelöst.

Methoden

delete

 Löscht eine Produkteingabe aus Ihrem Merchant Center-Konto.

insert

 Hiermit wird eine Produkteingabe in Ihr Merchant Center-Konto hochgeladen.