คุณใช้ฟีดเสริมเพื่ออัปเดตข้อมูลผลิตภัณฑ์บางส่วนได้โดยการเพิ่ม feedId
เป็นพารามิเตอร์การค้นหาเมื่อเรียกใช้เมธอด products.insert
, products.delete
, products.custombatch.insert
และ products.custombatch.delete
เช่น คุณอาจเรียกเมธอดฟีดเสริม products.insert
ไปยัง URL ต่อไปนี้
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
เมธอด products.insert
ของฟีดเสริมจะเพิ่มช่องผลิตภัณฑ์ที่คุณส่งในเนื้อหาคำขอ โดยเขียนทับช่องเหล่านั้นหากมี เมื่อใช้ฟีดเสริม วิธีนี้ทำให้ช่องผลิตภัณฑ์อื่นๆ ทั้งหมดไม่มีการเปลี่ยนแปลง เว้นแต่ช่องดังกล่าวจะรวมอยู่ในคำขอก่อนหน้าสำหรับฟีดเดียวกัน แม้ว่าข้อมูลที่เพิ่มผ่านฟีดอื่นๆ จะไม่ได้รับผลกระทบ แต่คำขอแต่ละรายการจะเขียนทับคำขอก่อนหน้าสำหรับฟีดเดียวกัน ซึ่งหมายความว่าหากคุณเพิ่มหรืออัปเดตช่องผ่านคำขอฟีดเสริม แต่ไม่ได้รวมช่องดังกล่าวในคำขอต่อมา ระบบจะนำข้อมูลของช่องที่ละเว้นออกจากฟีด ลักษณะการทำงานนี้จะแตกต่างจากการเรียก products.insert
เมื่อไม่มีฟีดเสริม ซึ่งจะลบข้อมูลผลิตภัณฑ์ทั้งหมดที่มีอยู่ทั้งหมดและแทนที่ด้วยช่องที่คุณส่งในเนื้อหาคำขอ
ใช้ URL ต่อไปนี้เพื่อส่งคำขอไปยังบริการ Product.insert
ของฟีดเสริม
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
คุณต้องใส่ช่อง offerId
, feedLabel
, channel
และ contentLanguage
ในเนื้อหาคำขอ ส่วนช่องอื่นๆ ทั้งหมดเป็นตัวเลือก
ตัวอย่าง
หากต้องการเปลี่ยนความพร้อมจำหน่ายของผลิตภัณฑ์จาก "มีสินค้าพร้อมจำหน่าย" เป็น "สินค้าหมด" คุณอาจใช้เนื้อหาคำขอต่อไปนี้เพื่อสร้างการเรียกเมธอด Product.insert
ของฟีดเสริม
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
เมธอด products.delete
จะนำข้อมูลเสริมทั้งหมดที่ก่อนหน้านี้เพิ่มโดยการเรียก products.insert
รายการที่ใช้ฟีดเสริมที่ระบุออก การเรียกวิธีนี้สำหรับฟีดเสริมจะไม่ส่งผลต่อข้อมูลผลิตภัณฑ์เดิมที่เพิ่มก่อนที่จะมีการเรียก Product.insert
ของฟีดเสริม กระบวนการนี้เหมือนกับการนำเลเยอร์ข้อมูลของฟีดหนึ่งๆ ออก ข้อมูลที่เพิ่มผ่านฟีดอื่นๆ จะไม่ได้รับผลกระทบ และผลิตภัณฑ์จะเปลี่ยนกลับไปอยู่ในสถานะก่อนหน้าก่อนที่จะมีการเพิ่มเลเยอร์ฟีดเสริม กรณีนี้ต่างจากการเรียก products.delete
เมื่อไม่มีฟีดเสริม ซึ่งจะลบทั้งผลิตภัณฑ์และข้อมูลของผลิตภัณฑ์ทั้งหมด
ใช้ URL ต่อไปนี้เพื่อส่งคำขอบริการ products.delete
ของฟีดเสริม โดย productId
คือรหัส REST ของผลิตภัณฑ์ ซึ่งแสดงเป็น channel:contentLanguage:feedLabel:offerId
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
ไม่จำเป็นต้องมีเนื้อหาคำขอสำหรับการเรียกใช้เมธอด products.delete
ของฟีดเสริม
products.custombatch
เมธอด custombatch
ช่วยให้คุณinsert
หรือdelete
รับข้อมูลฟีดเสริมของผลิตภัณฑ์หลายรายการได้โดยใช้การเรียก API ครั้งเดียวเพื่อลดจำนวนการเรียก API ที่เกิดขึ้น
ใช้ URL คำขอต่อไปนี้เพื่อโทรจาก custombatch
:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
สำหรับการเรียก custombatch
ของฟีดเสริมทั้งหมด คุณต้องใส่พารามิเตอร์ batchId
, merchantID
, method
และ feedId
ในเนื้อหาคำขอ
products.custombatch:insert
เมื่อเรียกฟีดเสริมไปยังเมธอด products.custombatch:insert
คุณต้องใส่ offerId
, feedLabel
, channel
และ contentLanguage
ไว้ในเนื้อหาของคำขอ นอกเหนือจากพารามิเตอร์ batchId
, merchantID
และ method
ที่ต้องระบุ ช่องผลิตภัณฑ์อื่นๆ ทั้งหมดเป็นแบบไม่บังคับ
ตัวอย่าง
หากต้องการอัปเดตค่า price
สำหรับผลิตภัณฑ์ที่มีอยู่ 2 รายการ คุณสามารถใช้คำขอต่อไปนี้เพื่อเรียกเมธอด products.custombatch:insert
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "30.99",
"currency": "USD"
}
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "2222222222",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "33.99",
"currency": "USD"
},
},
}
}
products.custombatch:delete
หากต้องการนำการอัปเดตทั้งหมดที่เกิดขึ้นกับผลิตภัณฑ์ 2 รายการผ่านฟีดเสริมที่ระบุออก คุณสามารถใช้คำขอต่อไปนี้เพื่อเรียกเมธอด products.custombatch:delete
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:2222222222"
}
]
}