การโทรติดต่อทรัพยากรผลิตภัณฑ์

products แหล่งข้อมูลช่วยให้มีความยืดหยุ่นและควบคุมแอตทริบิวต์ผลิตภัณฑ์มากกว่า 60 รายการได้เป็นอย่างดี มีฟิลด์หลายรายการที่ต้องระบุ และต้องรวมไว้เพื่อให้ได้รับการอนุมัติให้แสดงใน Google Shopping มีช่องที่ไม่บังคับหลายช่องที่อาจกลายเป็นช่องที่บังคับได้โดยขึ้นอยู่กับเงื่อนไขต่างๆ เช่น สถานที่ ประเภทผลิตภัณฑ์ ผลิตภัณฑ์ย่อย และผลิตภัณฑ์แพ็กเกจ ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์ที่ไม่บังคับกว่า 60 รายการที่กำหนดค่าสำหรับผลิตภัณฑ์ได้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์

แหล่งข้อมูล products ช่วยให้คุณinsert get update และdeleteผลิตภัณฑ์ทีละรายการ รวมถึงlistผลิตภัณฑ์ทั้งหมดในฐานข้อมูล Merchant Center

คุณสามารถใช้แหล่งข้อมูล productstatuses เพื่อตรวจสอบสถานะการอนุมัติหรือไม่อนุมัติของ ผลิตภัณฑ์ที่เฉพาะเจาะจงสำหรับปลายทางได้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับสินค้าที่อาจมีปัญหาด้านคุณภาพของข้อมูลและปัญหาเหล่านั้นได้ที่คู่มือสถานะผลิตภัณฑ์

ในตัวอย่าง API เราใช้ผลิตภัณฑ์ 3 รายการ ได้แก่ เสื้อยืด Google 2 ตัวและหมวก Google 1 ใบ เราใช้ชุดข้อมูลผลิตภัณฑ์ขั้นต่ำที่แสดงในตารางด้านล่างเพื่อproductsเรียกใช้ทรัพยากรเพื่อแทรก รับ อัปเดต แสดง และลบ ผลิตภัณฑ์แต่ละรายการและผลิตภัณฑ์เป็นกลุ่ม

เราขอแนะนำให้กำหนดค่าข้อมูลการจัดส่งและภาษีที่ระดับบัญชีแทนที่จะกำหนดค่าที่ระดับผลิตภัณฑ์

สำหรับบัญชีย่อยผู้ขายหลายรายของมาร์เก็ตเพลส ผลิตภัณฑ์ทั้งหมดต้องมีช่อง external_seller_id ดูรายละเอียดเพิ่มเติมได้ที่รหัสผลิตภัณฑ์

id online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId 1111111111 2222222222 3333333333
title เสื้อยืด Black Google Google Tee Green หมวกแก๊ปผ้าทวิลล์ของ Google
คำอธิบาย เสื้อยืด Black Google เสื้อยืด Google ผ้าฝ้าย 100% หมวก Google แบบคลาสสิก
รหัสกลุ่มสินค้า google_tee google_tee
ลิงก์ http://my.site.com/blacktee http://my.site.com/greentee http://my.site.com/blackhat
เงื่อนไข ใหม่ ใหม่ ใหม่
ราคา 219.90 THB 219.90 THB 10.99 USD
availability มีสินค้าพร้อมจำหน่าย มีสินค้าพร้อมจำหน่าย มีสินค้าพร้อมจำหน่าย
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 00638ABC
brand Google Google Google
หมวดหมู่สินค้า Google เสื้อผ้าและเครื่องประดับ > เสื้อผ้า เสื้อผ้าและเครื่องประดับ > เสื้อผ้า เสื้อผ้าและเครื่องประดับ > เครื่องประดับเสื้อผ้า > หมวก
สี ดำ green ดำ
ขนาด L M M
age_group ผู้ใหญ่ ผู้ใหญ่ ผู้ใหญ่
gender ชาย ชาย ไม่จำกัดเพศ
included_destination Shopping Actions, โฆษณา Shopping Shopping Actions, โฆษณา Shopping Shopping Actions

products.insert

หากต้องการแทรกผลิตภัณฑ์รายการเดียว ให้ใช้ URL ของคำขอต่อไปนี้ โดยระบุ รหัสผู้ขายและเนื้อหา JSON ตัวอย่าง การแทรกจะสร้างผลิตภัณฑ์ใหม่ หากมีค่าสำหรับแอตทริบิวต์ channel, contentLanguage, offerId และ feedLabel สำหรับผลิตภัณฑ์ที่ระบุ วิธีนี้จะอัปเดตรายการดังกล่าวและแทนที่ข้อมูลทั้งหมดจากการเรียก API ก่อนหน้าสำหรับผลิตภัณฑ์ที่ระบุ

ระบบจะลบผลิตภัณฑ์ที่ยกเว้นจากปลายทางทั้งหมดนานกว่า 7 วันโดยอัตโนมัติ

ตัวอย่างที่แสดงจะแทรก "เสื้อยืด Google สีดำ" ใหม่ลงในผลิตภัณฑ์ที่มีจำหน่าย

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

ตัวอย่างเนื้อหาคำขอสำหรับ 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"
 ]
}

นอกจากนี้ ผลิตภัณฑ์ยังมีการตั้งค่าแอตทริบิวต์ที่กำหนดเองภายในเนื้อหา JSON ได้ด้วย เช่น เราสามารถตั้งค่า purchase_quantity_limit สำหรับผลิตภัณฑ์เดียวเพื่อจำกัด จำนวนสินค้าที่ลูกค้าสั่งซื้อได้ ดังนี้

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

โปรดทราบว่าpurchase_quantity_limitแอตทริบิวต์ที่กำหนดเองจะกำหนดขีดจำกัดการซื้อ ต่อคำสั่งซื้อของลูกค้าให้กับคำจำกัดความของผลิตภัณฑ์ และฟีดก็รองรับแอตทริบิวต์นี้ด้วย ขณะนี้แอตทริบิวต์ ยังอยู่ในเวอร์ชันเบต้าจนกว่า API จะรองรับอย่างเต็มรูปแบบ ผู้ขายสามารถเพิ่มแอตทริบิวต์ที่กำหนดเองเพิ่มเติมได้ แต่ API จะไม่ประมวลผลแอตทริบิวต์ดังกล่าวเป็นพิเศษ

การเรียกที่สำเร็จจะแสดงรหัส HTTP 200 และเนื้อหาการตอบกลับที่มี ทรัพยากรผลิตภัณฑ์ที่แทรกโดยมีเพียง id, offerId, contentLanguage, feedLabel และ channel ที่มีข้อมูล

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

products.get

หากต้องการดูข้อมูลเกี่ยวกับผลิตภัณฑ์ที่เฉพาะเจาะจงในฐานข้อมูล Merchant Center ให้ใช้ products.get ระบบอาจใช้เวลาสักครู่ในการทำให้ผลิตภัณฑ์ที่เพิ่งแทรกพร้อมใช้งานผ่านการเรียกนี้

ใช้ URL คำขอ HTTP และพารามิเตอร์ต่อไปนี้ รหัสผู้ขาย และ รหัสผลิตภัณฑ์ (รูปแบบ REST ID) สำหรับผลิตภัณฑ์ที่คุณต้องการรับ

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

การเรียกที่สำเร็จจะแสดง HTTP 200 และ "ทรัพยากรผลิตภัณฑ์" ใน เนื้อหาการตอบกลับ ต่อไปนี้คือตัวอย่างข้อมูลผลิตภัณฑ์ที่ดึงมาจากผลิตภัณฑ์ที่มีรหัส 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

หากต้องการอัปเดตผลิตภัณฑ์รายการเดียว ให้ใช้ URL คำขอต่อไปนี้ด้วยเมธอด PATCH โดยระบุรหัสผู้ขาย รหัสผลิตภัณฑ์ และเนื้อหา JSON ที่มีข้อมูลที่คุณ ต้องการอัปเดตสำหรับผลิตภัณฑ์ products.insert ซึ่งกำหนดให้ต้องระบุฟิลด์ที่เกี่ยวข้องทั้งหมด ต่างจาก products.update ที่กำหนดให้คุณต้องระบุเฉพาะฟิลด์ที่ต้องการเปลี่ยนแปลง

หากต้องการเพิ่มหรือแก้ไขแอตทริบิวต์ ให้ระบุฟิลด์ที่มีค่าใหม่ในเนื้อหา JSON ตัวอย่างที่แสดงจะอัปเดต title และ description ของ "เสื้อยืด Google สีดำ" ที่มีอยู่ด้วยข้อมูลผลิตภัณฑ์ที่ระบุในเนื้อหาคำขอ โดยไม่เปลี่ยนแปลง ฟิลด์อื่นๆ ทั้งหมด

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

ตัวอย่างเนื้อหาคำขอสำหรับ products.update

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

อัปเดตได้เฉพาะฟิลด์ระดับบนสุดผ่านคำขอ products.update หากต้องการอัปเดตฟิลด์ที่ซ้อนกัน คุณต้องระบุออบเจ็กต์ระดับบนสุดทั้งหมด

ตัวอย่างที่แสดงจะอัปเดตออบเจ็กต์ระดับบนสุด salePrice รวมถึงฟิลด์ที่ซ้อนกัน ของผลิตภัณฑ์ที่มีอยู่ด้วยข้อมูลผลิตภัณฑ์ที่ระบุใน ส่วนเนื้อหาของคำขอ โดยจะไม่เปลี่ยนแปลงฟิลด์อื่นๆ ทั้งหมด

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

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

หากต้องการเลือกช่องบางช่องเพื่ออัปเดตโดยไม่ต้องทำการเปลี่ยนแปลงช่องอื่นๆ ที่รวมอยู่ในเนื้อหาของคำขอ คุณสามารถระบุ updateMaskได้ พารามิเตอร์สตริงการค้นหานี้ควรเป็นรายการฟิลด์ที่คั่นด้วยคอมมาซึ่งคุณต้องการแก้ไข updateMask มีประโยชน์เมื่อคุณต้องการยืนยันว่าระบบจะอัปเดตเฉพาะฟิลด์ที่ระบุ เท่านั้น การไม่ระบุ updateMask จะเทียบเท่ากับการทําเครื่องหมายฟิลด์ทั้งหมดในคําขอที่จะอัปเดตตามที่แสดงในตัวอย่างด้านบน

ตัวอย่างที่แสดงจะอัปเดตเฉพาะ description และ availability ของ "เสื้อยืด Google สีดำ" ที่มีอยู่ด้วยข้อมูลผลิตภัณฑ์ที่เกี่ยวข้องซึ่งระบุไว้ใน ส่วนเนื้อหาของคำขอ โดยจะไม่เปลี่ยนแปลงฟิลด์อื่นๆ ทั้งหมด รวมถึง title

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

ตัวอย่างเนื้อหาคำขอสำหรับ products.update

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

หากมีการระบุฟิลด์ในรายการ updateMask แต่ไม่ได้ระบุในเนื้อหาของคำขอ ระบบจะลบฟิลด์นั้นออกจากทรัพยากร Product หากมี

ตัวอย่างที่แสดงจะใช้ updateMask เพื่อนำค่าของฟิลด์ salePriceออก

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

เนื้อหาคำขอตัวอย่างไม่ควรรวมฟิลด์ salePrice เพื่อลบ นอกจากนี้ คุณยังไม่ระบุเนื้อหาหรือระบุเนื้อหาว่างเปล่าได้ด้วย ส่วนฟิลด์อื่นๆ จะยังคงเหมือนเดิมหากไม่ได้ปรากฏใน updateMask

หากต้องการใช้ updateMask ภายในคำขอ products.custombatch คุณควรระบุ updateMask ในเนื้อหาของคำขอ

ตัวอย่างที่แสดงจะอัปเดต price และ availability ของ "เสื้อยืด Google สีดำ" ที่มีอยู่ โดยใช้ products.custombatch กับข้อมูลผลิตภัณฑ์ที่ระบุ ในรายการแบบกลุ่ม โดยจะไม่เปลี่ยนแปลงช่องอื่นๆ ทั้งหมด รวมถึง title และ description 

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

หากต้องการลบผลิตภัณฑ์รายการเดียว ให้ใช้ products.delete กับตัวอย่างคำขอ HTTP URL, รหัสผู้ขาย และรหัสผลิตภัณฑ์ (ในรูปแบบ REST ID เช่น online:en:US:1111111111) สำหรับผลิตภัณฑ์ที่ต้องการลบ

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

การตอบกลับที่สำเร็จจะแสดง HTTP Status 204 โดยไม่มีเนื้อหาการตอบกลับ

products.list

products.list แสดงผลิตภัณฑ์ทั้งหมดที่ผู้ขายมีในฐานข้อมูล Merchant Center ใช้ URL คำขอต่อไปนี้

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

การเรียกที่สำเร็จจะแสดง HTTP 200 และข้อมูล JSON สำหรับผลิตภัณฑ์ในคีย์ "resources"

ระบบจะแสดงผลิตภัณฑ์ตัวอย่าง 3 รายการต่อไปนี้

{
 "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"
   ]
  }
 ]
}
ก่อนหน้า
รหัสผลิตภัณฑ์
ถัดไป
โหมดกลุ่ม