คุณใช้ฟีดเสริมเพื่ออัปเดตข้อมูลผลิตภัณฑ์บางส่วนได้โดยเพิ่ม 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"
}
]
}