Produktaufrufe

Mit der Ressource products lassen sich mehr als 60 Produktattribute flexibel verwalten und verwalten.Es gibt eine Reihe von Pflichtfeldern, die ausgefüllt werden müssen, damit die Anzeige bei Google Shopping genehmigt werden kann. Es gibt einige optionale Felder, die aufgrund unterschiedlicher Bedingungen wie Standort, Produkttyp, Produktvarianten und Produktsets obligatorisch sind. Weitere Informationen zu den mehr als 60 optionalen Parametern, die für Produkte konfiguriert werden können, finden Sie in den Produktdatenspezifikationen.

Mit der Ressource products können Sie für jeweils ein Produkt insert, get, update und delete sowie list für alle Produkte in der Merchant Center-Datenbank verwenden.

Mit der Ressource productstatuses können Sie den Genehmigungs- oder Ablehnungsstatus eines bestimmten Produkts für ein Ziel prüfen. Im Leitfaden zum Produktstatus finden Sie weitere Informationen dazu, bei welchen Produkten Probleme mit der Datenqualität auftreten können und was diese Probleme haben können.

In unseren API-Beispielen verwenden wir drei Produkte: zwei Google-T-Shirts und eine Google-Kappe. Wir verwenden den minimalen Satz von Produktdaten, der in der unten stehenden Tabelle aufgeführt ist, um products-Ressourcenaufrufe zum Einfügen, Abrufen, Aktualisieren, Auflisten und Löschen einzelner Produkte und Batches von Produkten durchzuführen.

Wir empfehlen, Versand- und Steuerinformationen auf Kontoebene und nicht auf Produktebene zu konfigurieren.

Bei Mehrfachkundenkonten von Marktplätzen muss das Feld external_seller_id bei allen Produkten enthalten sein. Weitere Informationen finden Sie unter Produkt-IDs.

id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
title	Schwarzes Google-T-Shirt	Google-T-Shirt Grün	Google-Twill-Cap
Beschreibung	Schwarzes Google-T-Shirt	Google-T-Shirt, 100% Baumwolle	Klassisches Google-Cap
Artikelgruppen-ID	google_tee	google_tee
Link	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
Bedingung	Neu	Neu	Neu
Preis	21.99 EUR	21.99 EUR	10,99 EUR
Verfügbarkeit	Auf Lager	Auf Lager	Auf Lager
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
GTIN	9504000059422	9504000059446	9504000059452
mpn	00638NIC	00638ANG	00638
brand	Google	Google	Google
Google-Produktkategorie	Bekleidung & Accessoires > Bekleidung	Bekleidung & Accessoires > Bekleidung	Bekleidung & Accessoires > Bekleidungsaccessoires > Hüte
Farbe	Schwarz	green	Schwarz
Größe	L	M	M
age_group	pornografisch	pornografisch	pornografisch
gender	männlich	männlich	Unisex
included_destination	Shopping Actions, Shopping-Anzeigen	Shopping Actions, Shopping-Anzeigen	Shopping Actions

products.insert

Verwende die folgende Anfrage-URL, um ein einzelnes Produkt einzufügen. Gib dabei deine Händler-ID und einen JSON-Beispieltext an. Durch eine Einfügung wird das neue Produkt erstellt. Wenn Werte für die Attribute channel, contentLanguage, offerId und feedLabel für ein bestimmtes Produkt vorhanden sind, aktualisiert diese Methode diesen Eintrag und ersetzt alle Daten aus früheren API-Aufrufen für das jeweilige Produkt.

Produkte, die länger als 7 Tage von allen Zielen ausgeschlossen sind, werden automatisch gelöscht.

Im folgenden Beispiel wird den verfügbaren Produkten ein neues „Schwarzes Google-T-Shirt“ hinzugefügt.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

Beispiel für einen Anfragetext für products.insert:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

Für ein Produkt können auch benutzerdefinierte Attribute im JSON-Text festgelegt werden. Wir können beispielsweise eine purchase_quantity_limit für ein einzelnes Produkt festlegen, um die Anzahl der Artikel zu begrenzen, die ein Kunde bestellen kann:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

Das benutzerdefinierte Attribut purchase_quantity_limit legt ein Kauflimit pro Kundenbestellung auf die Produktdefinition fest. Es wird auch von Feeds unterstützt. Das Attribut befindet sich derzeit in der Betaphase, bis es vollständig von der API unterstützt wird. Jedes zusätzliche benutzerdefinierte Attribut kann von einem Händler hinzugefügt werden, führt jedoch nicht zu einer bestimmten Verarbeitung durch die APIs.

Ein erfolgreicher Aufruf gibt einen HTTP 200-Code und einen Antworttext zurück, der die eingefügte Produktressource enthält, wobei nur id, offerId, contentLanguage, feedLabel und channel ausgefüllt sind:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Verwenden Sie products.get, um Informationen zu einem bestimmten Produkt in der Merchant Center-Datenbank abzurufen. Es kann einige Minuten dauern, bis ein neu eingefügtes Produkt über diesen Aufruf verfügbar ist.

Verwende die folgende HTTP-Anfrage-URL und die folgenden Parameter, deine Händler-ID und die Produkt-ID (REST-ID-Format) für das Produkt, das du abrufen möchtest:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Bei einem erfolgreichen Aufruf werden ein HTTP 200 und die "Produktressource" im Antworttext zurückgegeben. Hier sehen Sie Beispielproduktdaten, die aus einem Produkt mit der ID online:en:US:1111111111 abgerufen werden:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

Verwende zum Aktualisieren eines einzelnen Produkts die folgende Anfrage-URL mit der PATCH-Methode. Gib dabei deine Händler-ID, deine Produkt-ID und einen JSON-Text mit den Daten an, die du für das Produkt aktualisieren möchtest. Im Gegensatz zu products.insert, bei dem alle anwendbaren Felder angegeben werden müssen, müssen Sie bei products.update nur die Felder angeben, die Sie ändern möchten.

Hinweis: Das Aktualisieren eines Produkts funktioniert ähnlich wie products.insert und kann einige Minuten dauern, bis die Änderungen verarbeitet sind. Wenn products.update ohne Fehler erfolgreich ist, ist das Update erfolgreich. Die folgenden Aufrufe von products.get geben möglicherweise den vorherigen Wert zurück, bis die Aktualisierung verarbeitet wurde.

Warnung: Änderungen, die mit product.update vorgenommen wurden, bleiben nicht erhalten, wenn das Produkt mit derselben Produkt-ID noch einmal über den Hauptfeed, den Subfeed oder die API gesendet wird. Wenn ein Wert nach der erneuten Einreichung erhalten bleiben soll, muss der aktualisierte Wert im Feed oder über den API-Aufruf products.insert enthalten sein.

Wenn Sie ein Attribut hinzufügen oder ändern möchten, geben Sie das Feld mit dem neuen Wert im JSON-Text an. Im gezeigten Beispiel werden title und description eines vorhandenen schwarzen Google-T-Shirts mit den Produktdaten im Anfragetext aktualisiert. Alle anderen Felder bleiben unverändert.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Beispiel für einen Anfragetext für products.update:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

Nur Felder der obersten Ebene können mit einer products.update-Anfrage aktualisiert werden. Wenn Sie verschachtelte Felder aktualisieren möchten, müssen Sie das gesamte übergeordnete Objekt angeben.

Im gezeigten Beispiel wird das übergeordnete Objekt salePrice, einschließlich der verschachtelten Felder eines vorhandenen Produkts, mit den Produktdaten im Anfragetext aktualisiert. Alle anderen Felder bleiben unverändert.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

Wenn Sie bestimmte Felder zum Aktualisieren auswählen möchten, ohne Änderungen an den anderen im Text der Anfrage vorzunehmen, können Sie ein updateMask angeben. Dieser Abfragestringparameter sollte eine durch Kommas getrennte Liste von Feldern sein, die Sie ändern möchten. Ein updateMask ist nützlich, wenn Sie bestätigen möchten, dass nur die benannten Felder aktualisiert werden. Wenn Sie kein updateMask angeben, entspricht dies der Markierung aller Felder in der Anfrage zur Aktualisierung, wie im obigen Beispiel gezeigt.

Im gezeigten Beispiel werden nur description und availability eines vorhandenen schwarzen Google-T-Shirts mit den entsprechenden Produktdaten im Anfragetext aktualisiert. Alle anderen Felder, einschließlich title, bleiben unverändert.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

Beispiel für einen Anfragetext für products.update:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

Wenn ein Feld in der Liste updateMask, aber nicht im Text der Anfrage angegeben ist, wird dieses Feld aus der Ressource Product gelöscht, sofern vorhanden.

Im gezeigten Beispiel wird updateMask verwendet, um den Wert für das Feld salePrice zu entfernen.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

Der Text der Beispielanfrage darf zum Löschen das Feld salePrice nicht enthalten. Sie können auch keinen Text oder einen leeren Textkörper angeben. Andere Felder bleiben unverändert, sofern sie nicht im updateMask angezeigt werden.

Warnung: Wenn Sie updateMask verwenden, achten Sie darauf, für alle in updateMask aufgeführten Felder den richtigen Wert anzugeben. Wenn Sie den Wert nicht in den Text der Anfrage aufnehmen, entspricht dies dem Löschen des Felds.

Wenn Sie updateMask in einer products.custombatch-Anfrage verwenden möchten, muss updateMask im Text der Anfrage angegeben werden.

Im gezeigten Beispiel werden price und availability eines vorhandenen schwarzen Google-T-Shirts mithilfe von products.custombatch mit den im Batcheintrag bereitgestellten Produktdaten aktualisiert. Alle anderen Felder, einschließlich title und description, bleiben unverändert.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

Wenn du ein einzelnes Produkt löschen möchtest, verwende products.delete mit der Beispiel-HTTP-Anfrage-URL, deiner Händler-ID und der Produkt-ID (im REST-ID-Format wie online:en:US:1111111111) für das zu löschende Produkt:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Bei einer erfolgreichen Antwort wird ein HTTP Status 204 ohne Antworttext zurückgegeben.

products.list

products.list listet alle Produkte eines Händlers in der Merchant Center-Datenbank auf. Verwenden Sie die folgende Anfrage-URL:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

Bei einem erfolgreichen Aufruf werden ein HTTP 200 und JSON-Daten für Produkte im Schlüssel "resources" zurückgegeben.

Die folgenden drei Beispielprodukte werden zurückgegeben:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}