REST Resource: accounts.products

Ressource: Produkt

Das verarbeitete Produkt, das nach Anwenden von Regeln und zusätzlichen Datenquellen aus mehreren product inputs erstellt wurde. Dieses verarbeitete Produkt stimmt mit den Angaben in Ihrem Merchant Center-Konto sowie in Shopping-Anzeigen und auf anderen Plattformen auf Google überein. Jedes Produkt wird aus genau einer Produkteingabe der primären Datenquelle und mehreren Eingaben der ergänzenden Datenquelle erstellt. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das aktualisierte verarbeitete Produkt abgerufen werden kann.

Alle Felder im verarbeiteten Produkt und in seinen untergeordneten Nachrichten stimmen mit einigen Ausnahmen mit dem Namen des entsprechenden Attributs in der Produktdatenspezifikation überein.

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

string

Der Name des Produkts. Format: "{product.name=accounts/{account}/products/{product}}", wobei der letzte Abschnitt product aus vier Teilen besteht: channel~contentLanguage~feedLabel~offerId. Beispiel für einen Produktnamen: „accounts/123/products/online~en~US~sku123“
channel

enum (ChannelEnum)

Nur Ausgabe. Der Kanal des Produkts.
offerId

string

Nur Ausgabe. 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

Nur Ausgabe. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt.
feedLabel

string

Nur Ausgabe. Das Feedlabel für das Produkt.
dataSource

string

Nur Ausgabe. Die primäre Datenquelle des Produkts.
attributes

object (Attributes)

Nur Ausgabe. Eine Liste von Produktattributen.
customAttributes[]

object (CustomAttribute)

Nur Ausgabe. Eine Liste von benutzerdefinierten (vom Händler bereitgestellten) Attributen. Außerdem können Sie damit jedes Attribut der Datenspezifikation in seiner generischen Form einreichen (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.
productStatus

object (ProductStatus)

Nur Ausgabe. Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem Produkt, die asynchron berechnet werden.
versionNumber

string (int64 format)

Nur Ausgabe. 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.

ProductStatus

Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem Produkt, die asynchron berechnet werden.

JSON-Darstellung 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Felder
destinationStatuses[]

object (DestinationStatus)

Die vorgesehenen Ziele des Produkts
itemLevelIssues[]

object (ItemLevelIssue)

Eine Liste aller Probleme im Zusammenhang mit dem Produkt.
creationDate

string (Timestamp format)

Das Datum, an dem der Artikel erstellt wurde, im ISO 8601-Format.
lastUpdateDate

string (Timestamp format)

Datum, an dem der Artikel zuletzt aktualisiert wurde. Die Angabe erfolgt im ISO 8601-Format.
googleExpirationDate

string (Timestamp format)

Datum, an dem das Element abläuft, im ISO 8601-Format.

DestinationStatus

Der Zielstatus des Produktstatus.

JSON-Darstellung 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Felder
reportingContext

enum (ReportingContextEnum)

Der Name des Berichtskontexts.
approvedCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot genehmigt wurde.
pendingCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Angebot noch nicht genehmigt wurde.
disapprovedCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot abgelehnt wurde.

ItemLevelIssue

Das Problem auf Artikelebene des Produktstatus.

JSON-Darstellung 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Felder
code

string

Der Fehlercode des Problems
severity

enum (Severity)

Wie sich dieses Problem auf die Zustellung des Angebots auswirkt.
resolution

string

Ob das Problem vom Händler behoben werden kann.
attribute

string

Der Attributname, falls das Problem durch ein einzelnes Attribut verursacht wird.
reportingContext

enum (ReportingContextEnum)

Der Berichtskontext, auf den sich das Problem bezieht.
description

string

Eine kurze Problembeschreibung in Englisch.
detail

string

Ausführliche Problembeschreibung in Englisch.
documentation

string

Die URL einer Webseite, die bei der Lösung des Problems helfen kann.
applicableCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), auf die das Problem zutrifft.

Schweregrad

Wie sich das Problem auf die Auslieferung des Produkts auswirkt.

Enums
SEVERITY_UNSPECIFIED Nicht angegeben.
NOT_IMPACTED Dieses Problem ist eine Warnung und hat keine direkten Auswirkungen auf das Produkt.
DEMOTED Das Produkt wird herabgestuft und hat höchstwahrscheinlich eine eingeschränkte Leistung in den Suchergebnissen.
DISAPPROVED Das Produkt wird aufgrund des Problems abgelehnt.

Methoden

get

 Ruft das verarbeitete Produkt aus Ihrem Merchant Center-Konto ab.

list

 Hier werden die verarbeiteten Produkte in Ihrem Merchant Center-Konto aufgeführt.