ขอแนะนำ Merchant API ซึ่งเป็นเวอร์ชันต่อไปอย่างเป็นทางการของ Content API for Shopping

รับข้อมูลล่าสุด เกี่ยวกับฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการอัปเดตของ Merchant API

เริ่มต้นใช้งาน Merchant API และรับสิทธิ์เข้าถึงข้อมูล ข้อมูลเชิงลึก และความสามารถเฉพาะตัวในวงกว้าง

หมายเหตุ: Content API for Shopping จะหยุดให้บริการในวันที่ 18 สิงหาคม 2026

หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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 Twill
คำอธิบาย	เสื้อยืด 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	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 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"
   ]
  }
 ]
}

รหัสผลิตภัณฑ์

โหมดกลุ่ม