Die products-Ressource bietet viel Flexibilität und Kontrolle über mehr als 60 Produktattribute.Es gibt eine Reihe von Feldern, die obligatorisch sind und angegeben werden müssen, damit die Produkte in Google Shopping angezeigt werden können.
Es gibt eine Reihe optionaler Felder, die je nach Bedingungen wie Standort, Produkttyp, Produktvarianten und Produktpaketen obligatorisch werden können. Weitere Informationen zu den über 60 optionalen Parametern, die für Produkte konfiguriert werden können, finden Sie in den Produktdatenspezifikationen.
Mit der products-Ressource können Sie jeweils ein Produkt insert, get, update und delete und alle Produkte in der Merchant Center-Datenbank list.
Mit der Ressource productstatuses können Sie den Genehmigungs- oder Ablehnungsstatus eines bestimmten Produkts für ein Ziel prüfen. Weitere Informationen dazu, bei welchen Produkten Probleme mit der Datenqualität auftreten können und welche Probleme das sein können, finden Sie im Leitfaden zum Produktstatus.
In unseren API-Beispielen verwenden wir drei Produkte: zwei Google-T-Shirts und eine Google-Kappe. Wir verwenden eine minimale Menge an Produktdaten, die in der Tabelle unten aufgeführt sind, um products-Ressourcenaufrufe zum Einfügen, Abrufen, Aktualisieren, Auflisten und Löschen einzelner Produkte und Produktbatches zu erstellen.
Wir empfehlen, Versand- und Steuerinformationen auf Kontoebene und nicht auf Produktebene zu konfigurieren.
Für Mehrfachkunden-Unterkonten von Marktplätzen muss für alle Produkte das Feld external_seller_id angegeben werden. Weitere Informationen finden Sie unter Produkt-IDs.
 |
 |
 |
|
| id | online:en:US:1111111111 | online:en:US:2222222222 | online:en:US:3333333333 |
| offerId | 1111111111 | 2222222222 | 3333333333 |
| Titel | Das schwarze Google-T-Shirt | Google Tee Green | Google Twill Cap |
| Beschreibung | Das schwarze Google-T-Shirt | Google-T-Shirt aus 100% Baumwolle | Klassisches Google-Limit |
| 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 $ | 21,99 $ | 10,99 € |
| Verfügbarkeit | Auf Lager | Auf Lager | Auf Lager |
| imageLink | https://shop.example.com/ |
https://shop.example.com/ |
https://shop.example.com/ |
| gtin | 9504000059422 | 9504000059446 | 9504000059452 |
| mpn | 00638NIC | 00638ANG | 00638ABC |
| brand [Marke] | |||
| Google-Produktkategorie | Bekleidung & Accessoires > Bekleidung | Bekleidung & Accessoires > Bekleidung | Bekleidung & Accessoires > Bekleidungszubehör > Hüte |
| Farbe | Schwarz | Grün | Schwarz |
| Größe | L | M | M |
| age_group | Erwachsene | Erwachsene | Erwachsene |
| gender | Männlich | Männlich | Unisex |
| included_destination | Shopping Actions, Shopping-Anzeigen | Shopping Actions, Shopping-Anzeigen | Shopping Actions |
products.insert
Wenn Sie ein einzelnes Produkt einfügen möchten, verwenden Sie die folgende Anfrage-URL und geben Sie Ihre Händler-ID und einen JSON-Beispieltext an. Durch einen Insert wird das neue Produkt erstellt. Wenn für die Attribute channel, contentLanguage, offerId und feedLabel eines bestimmten Produkts Werte vorhanden sind, wird der entsprechende Eintrag mit dieser Methode aktualisiert und alle Daten aus vorherigen API-Aufrufen für das jeweilige Produkt werden ersetzt.
Produkte, die länger als sieben Tage von allen Zielen ausgeschlossen sind, werden automatisch gelöscht.
Im Beispiel wird ein neues Produkt („Black Google Tee“) eingefü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 ein 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 für die Produktdefinition fest und wird auch von Feeds unterstützt. Das Attribut befindet sich derzeit in der Betaphase, bis es vollständig von der API unterstützt wird. Händler können zusätzliche benutzerdefinierte Attribute hinzufügen, die jedoch nicht von den APIs verarbeitet werden.
Bei einem erfolgreichen Aufruf wird der Code HTTP 200 und ein Antworttext zurückgegeben, der die eingefügte Produktressource enthält, in der 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
Wenn Sie Informationen zu einem bestimmten Produkt in der Merchant Center-Datenbank abrufen möchten, verwenden Sie products.get. Es kann einige Minuten dauern, bis ein neu eingefügtes Produkt über diesen Aufruf verfügbar ist.
Verwenden Sie die folgende HTTP-Anfrage-URL und die Parameter, Ihre Händler-ID und die Produkt-ID (REST-ID-Format) für das Produkt, das Sie abrufen möchten:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Bei einem erfolgreichen Aufruf wird ein HTTP 200 und die „Produktressource“ im Antworttext zurückgegeben. Hier sind Beispieldaten für ein Produkt mit der ID online:en:US:1111111111:
{
"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
Wenn Sie ein einzelnes Produkt aktualisieren möchten, verwenden Sie die folgende Anfrage-URL mit der PATCH-Methode. Geben Sie Ihre Händler-ID, Produkt-ID und einen JSON-Textkörper mit den Daten an, die Sie für das Produkt aktualisieren möchten. Im Gegensatz zu products.insert, bei dem alle zutreffenden Felder angegeben werden müssen, müssen Sie bei products.update nur die Felder angeben, die Sie ändern möchten.
Wenn Sie ein Attribut hinzufügen oder ändern möchten, geben Sie das Feld mit dem neuen Wert im JSON-Body an. Im gezeigten Beispiel werden die title und description eines vorhandenen „Black Google Tee“ mit den im Anfragebody bereitgestellten Produktdaten 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."
}
Über eine products.update-Anfrage können nur Felder der obersten Ebene aktualisiert werden.
Wenn Sie verschachtelte Felder aktualisieren möchten, müssen Sie das gesamte Objekt der obersten Ebene angeben.
Im gezeigten Beispiel wird das salePrice-Objekt der obersten Ebene, einschließlich der verschachtelten Felder eines vorhandenen Produkts, mit den im Anfragetext angegebenen Produktdaten 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 die anderen Felder im Anfragetext zu ändern, können Sie ein updateMask angeben. Dieser Abfragestringparameter sollte eine durch Kommas getrennte Liste der Felder 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, werden alle Felder in der Anfrage aktualisiert, wie im Beispiel oben gezeigt.
Im gezeigten Beispiel werden nur die Felder description und availability eines vorhandenen „Black Google Tee“ mit den entsprechenden Produktdaten im Anfragebody 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 es aus der Ressource Product gelöscht, sofern es vorhanden ist.
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 Beispielanfragetext sollte das Feld salePrice nicht enthalten, um es zu löschen. Sie können auch keinen oder einen leeren Textkörper angeben. Andere Felder bleiben unverändert, sofern sie nicht in der updateMask enthalten sind.
Wenn Sie updateMask in einer products.custombatch-Anfrage verwenden möchten, muss updateMask im Text der Anfrage angegeben werden.
Im gezeigten Beispiel werden die price und availability eines vorhandenen „Black Google Tee“ mit products.custombatch und den im Batch-Eintrag angegebenen 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 Sie ein einzelnes Produkt löschen möchten, verwenden Sie products.delete mit der Beispiel-HTTP-Anfrage-URL, Ihrer Händler-ID und der Produkt-ID (im REST-ID-Format wie online:en:US:1111111111) für das Produkt, das Sie löschen möchten:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Eine erfolgreiche Antwort gibt ein HTTP Status 204 ohne Antworttext zurück.
products.list
products.list enthält alle Produkte, die ein Händler in der Merchant Center-Datenbank hat. Verwenden Sie die folgende Anfrage-URL:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Ein erfolgreicher Aufruf gibt eine HTTP 200 und JSON-Daten für Produkte im Schlüssel „resources“ zurück.
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"
]
}
]
}