Produktaufrufe

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/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 [gtin] 9504000059422 9504000059446 9504000059452
mpn 00638NIC 00638ANG 00638ABC
brand [Marke] Google Google Google
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"
   ]
  }
 ]
}