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

เราขอแนะนำ Merchant API เวอร์ชันเบต้า ซึ่งเป็น Content API เวอร์ชันใหม่และในอนาคต

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

ทรัพยากร products ช่วยให้คุณinsert, get, update และ delete ผลิตภัณฑ์ได้ครั้งละ 1 รายการ รวมถึง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	Google Tee สีดำ	ทีกรีน Google	ขีดจำกัดสิ่งทอของ Google
คำอธิบาย	Google Tee สีดำ	เสื้อยืด 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	109.90 THB
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 ทั้งนี้ อาจใช้เวลา 2-3 นาทีเพื่อให้ผลิตภัณฑ์ที่แทรกใหม่พร้อมใช้งานผ่านการเรียกนี้

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

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

หมายเหตุ: การอัปเดตผลิตภัณฑ์จะทำงานคล้ายกับ products.insert และใช้เวลา 2-3 นาทีในการประมวลผลการเปลี่ยนแปลง หาก products.update สำเร็จโดยไม่มีข้อผิดพลาด การอัปเดตก็จะสำเร็จ การเรียก products.get ต่อไปนี้อาจแสดงค่าก่อนหน้าจนกว่าการอัปเดตจะประมวลผล

คำเตือน: การเปลี่ยนแปลงที่ทำกับ product.update จะไม่คงอยู่ หากผลิตภัณฑ์ที่มีรหัสผลิตภัณฑ์เดียวกันถูกส่งอีกครั้งผ่านฟีดหลัก ฟีดเสริม หรือ API หากต้องการคงค่าไว้หลังจากส่งอีกครั้ง โปรดตรวจสอบว่าค่าที่อัปเดตรวมอยู่ในฟีดหรือผ่านการเรียก API ของ products.insert

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

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 ของ "Black Google Tee" ที่มีอยู่" ซึ่งมีข้อมูลผลิตภัณฑ์ที่เกี่ยวข้องซึ่งระบุไว้ในส่วนเนื้อหาของคำขอ โดยจะไม่ปรับแต่งช่องอื่นๆ ทั้งหมด รวมถึง 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 โปรดระบุค่าที่ถูกต้องในทุกช่องที่แสดงอยู่ใน updateMask หากไม่ระบุค่าในส่วนเนื้อหาของคำขอ ค่าดังกล่าวจะเทียบเท่ากับการลบช่อง

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

ตัวอย่างที่แสดงจะอัปเดต price และ availability ของ "Black Google Tee" ที่มีอยู่โดยใช้ 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 กับตัวอย่าง URL ของคำขอ HTTP, รหัสผู้ขาย และรหัสผลิตภัณฑ์ (ในรูปแบบรหัส REST เช่น 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 สำหรับผลิตภัณฑ์ในคีย์ "ทรัพยากร"

ระบบจะแสดงผลิตภัณฑ์ตัวอย่าง 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"
   ]
  }
 ]
}