Die products
Ressource ermöglicht ein hohes Maß an Flexibilität und Kontrolle über mehr
mehr als 60 Produktattributen.Es gibt einige Pflichtfelder,
und müssen enthalten sein, damit die Anzeige auf Google Shopping genehmigt wird.
Es gibt eine Reihe optionaler Felder, die je nach
Bedingungen wie Standort, Produkttyp, Produktvarianten und Produkt
Sets. Weitere Informationen zu den mehr als 60 optionalen Parametern,
die für Produkte konfiguriert sind, siehe Produktdaten
Technische Daten.
Mit der Ressource products können Sie insert, get, update und delete eines erstellen
und list alle Produkte in der Merchant Center-Datenbank.
Die
productstatuses
Ressource verwendet, um den Genehmigungs- oder Ablehnungsstatus einer bestimmten
Produkt für ein Ziel. Siehe Produktstatus
finden Sie weitere Informationen dazu,
kann es Probleme mit der Datenqualität geben.
In unseren API-Beispielen verwenden wir drei Produkte: zwei Google-T-Shirts und ein
Google-Obergrenze. Wir verwenden die in der Tabelle unten gezeigten minimalen Produktdaten,
products Ressourcenaufrufe zum Einfügen, Abrufen, Aktualisieren, Auflisten und Löschen ausführen
einzelne Produkte und Sätze von Produkten.
Wir empfehlen, Versand- und Steuerinformationen zu konfigurieren im Konto statt auf Produktebene.
Für Mehrfachkunden-Unterkonten von
Marktplätze, alle Produkte müssen
Das Feld external_seller_id muss enthalten sein. Weitere Informationen finden Sie unter
Weitere Informationen
 |
 |
 |
|
| id | online:en:US:1111111111 | online:en:US:2222222222 | online:en:US:3333333333 |
| offerId | 1111111111 | 2222222222 | 3333333333 |
| Titel | Das schwarze Google-T-Shirt | Google-T-Shirt grün | Google Twill Cap |
| Beschreibung | Das schwarze Google-T-Shirt | Google-T-Shirt aus 100% Baumwolle | Klassische Google-Cap |
| Artikelgruppen-ID | google_tee | google_tee | |
| Link | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
| condition | 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/ |
https://shop.example.com/ |
https://shop.example.com/ |
| gtin [gtin] | 9504000059422 | 9504000059446 | 9504000059452 |
| mpn | 00638NIC | 00638ANG | 00638ABC |
| brand [Marke] | |||
| Google-Produktkategorie | Bekleidung & Zubehör > Kleidung | Bekleidung & Zubehör > Kleidung | Bekleidung & Zubehör > Bekleidungsaccessoires > Hüte & Mützen |
| 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 die
Händler-ID und einen JSON-Beispieltext. Mit einer Einfügung wird das neue Produkt erstellt. Wenn-Werte
gibt es für die Attribute channel, contentLanguage, offerId und
feedLabel für ein bestimmtes Produkt aktualisiert, aktualisiert diese Methode diesen Eintrag und ersetzt
alle Daten aus vorherigen API-Aufrufen für das jeweilige Produkt.
Produkte, die länger als 7 Tage von allen Zielen ausgeschlossen sind, werden automatisch gelöscht.
Im gezeigten Beispiel wird ein neues „Schwarzes Google-T-Shirt“ eingefügt. zu den verfügbaren Produkten.
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. Beispiel:
können wir eine purchase_quantity_limit für ein einzelnes Produkt festlegen,
Anzahl der Artikel, die ein Kunde bestellen kann:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
Das benutzerdefinierte Attribut purchase_quantity_limit legt ein Kauflimit fest.
pro Kundenbestellung in der Produktdefinition und wird auch von Feeds unterstützt. Die
befindet sich derzeit in der Betaphase, bis sie vollständig von der API unterstützt wird. Beliebig
Zusätzliche benutzerdefinierte Attribute können von einem Händler hinzugefügt werden. Dies führt jedoch nicht zu
eine spezifische Verarbeitung durch die APIs.
Bei einem erfolgreichen Aufruf werden ein HTTP 200-Code und ein Antworttext mit
Eingefügte Produktressource mit nur id, offerId, contentLanguage
feedLabel und channel ausgefüllt:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online"
}
products.get
Um Informationen zu einem bestimmten Produkt in der Merchant Center-Datenbank zu erhalten, verwenden Sie
products.get Es kann einige Minuten dauern, bis ein neu eingefügtes Produkt angezeigt wird
über diesen Anruf verfügbar.
Verwenden Sie die folgende HTTP-Anfrage-URL und die folgenden Parameter, Ihre Händler-ID und den 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 werden ein HTTP 200 und die „Produktressource“ zurückgegeben. in der
Antworttext. Hier sehen Sie Beispiele für Produktdaten, die von einem Produkt mit ID abgerufen wurden
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
Um ein einzelnes Produkt zu aktualisieren, verwenden Sie die folgende Anfrage-URL mit der PATCH-Methode:
geben Ihre Händler-ID, Ihre Produkt-ID und einen JSON-Text mit den Daten an,
die Sie für das Produkt aktualisieren möchten. Im Gegensatz zu products.insert erfordert dies
müssen alle zutreffenden Felder ausgefüllt werden. Für products.update sind lediglich folgende Schritte erforderlich:
geben Sie die Felder an, die Sie ändern möchten.
Wenn Sie ein Attribut hinzufügen oder ändern möchten, geben Sie das Feld mit dem neuen Wert in der JSON-Datei an
Textkörper. Im gezeigten Beispiel werden title und description eines vorhandenen
„Schwarzes Google-T-Shirt“ mit den Produktdaten aus dem Anfragetext,
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."
}
Mit einer 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 übergeordnete salePrice-Objekt aktualisiert, einschließlich des verschachtelten
eines vorhandenen Produkts mit den Produktdaten aus dem
Anfragetext und alle anderen Felder bleiben unverändert.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Um bestimmte Felder auszuwählen, die aktualisiert werden sollen, ohne Änderungen an den anderen enthaltenen Feldern vorzunehmen
im Anfragetext können Sie ein updateMask angeben. Dieser Abfragestring
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
wird aktualisiert. Ohne Angabe eines updateMask-Werts entspricht das Markieren aller
in der Anfrage zu aktualisieren, wie im obigen Beispiel gezeigt.
Im gezeigten Beispiel werden nur description und availability aktualisiert.
eines vorhandenen "Black Google Tee" mit den entsprechenden Produktdaten in
den Anfragetext und lassen Sie alle anderen Felder einschließlich title 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 updateMask-Liste, aber nicht im Text der Anfrage enthalten ist,
Dieses Feld wird aus der Ressource Product gelöscht, sofern vorhanden.
Im gezeigten Beispiel wird updateMask verwendet, um den Wert für das Feld zu entfernen
salePrice.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
Der Text der Beispielanfrage darf das Feld salePrice nicht enthalten, um
löschen. Sie können auch keinen Text oder einen leeren Textkörper angeben. Andere Felder werden
bleiben unberührt, sofern sie nicht im updateMask erscheinen.
Wenn Sie updateMask in einer products.custombatch-Anfrage verwenden möchten, muss die updateMask
sollte im Text der Anfrage angegeben werden.
Im gezeigten Beispiel werden price und availability eines vorhandenen
„Schwarzes Google-T-Shirt“ Verwendung von products.custombatch mit den bereitgestellten Produktdaten
im Batcheintrag ein, wobei alle anderen Felder, einschließlich title und description, beibehalten werden.
unberührt bleiben.
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
Verwenden Sie products.delete mit der HTTP-Beispielanfrage, um ein einzelnes Produkt zu löschen
URL, Ihre Händler-ID und die 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}
Bei einer erfolgreichen Antwort wird ein HTTP Status 204 ohne Antworttext zurückgegeben.
products.list
In products.list sind alle Produkte eines Händlers im Merchant Center aufgeführt
Datenbank. 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
„Ressourcen“ .
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"
]
}
]
}