บทแนะนํานี้จะอธิบายสิ่งต่อไปนี้
- คําอธิบายระดับสูงเกี่ยวกับวิธีแสดงความพร้อมของผู้ใช้และประเภทของข้อมูลที่ต้องระบุ
- วิธีการที่เจาะจงเกี่ยวกับวิธีเข้ารหัสข้อมูลความพร้อมจําหน่ายสินค้าลงใน
action_linkในฟีด - วิธีการอัปเดตความพร้อมจําหน่ายสินค้าดังกล่าวหากมีการเปลี่ยนแปลงตลอดทั้งวัน
- ความคาดหวังของความถูกต้องของความพร้อมจําหน่ายสินค้า
นอกเหนือจากข้อมูลเมตาความพร้อมจําหน่ายสินค้าแล้ว คุณควรระบุข้อมูลเมตาเกี่ยวกับค่าธรรมเนียมที่เกี่ยวข้องกับการนําส่งหรือรับสินค้าด้วย รวมถึงจํานวนคําสั่งซื้อขั้นต่ํา ดูตัวอย่างฟีดที่สมบูรณ์ที่แสดงการใช้งานความพร้อมจําหน่ายสินค้า ค่าธรรมเนียม และคําสั่งซื้อขั้นต่ําได้ที่ตัวอย่างฟีดคําสั่งซื้อค้าปลีก v1
ต้องมีข้อมูลความพร้อมใดบ้าง
ระบบจะรวบรวมความพร้อมในการค้าปลีกสําหรับประสบการณ์นี้ที่ระดับรายละเอียดวัน ข้อมูลความพร้อมจําหน่ายสินค้านี้จะแสดงแก่ผู้ใช้พร้อมกับค่าธรรมเนียมและมูลค่าการสั่งซื้อขั้นต่ําพร้อมข้อความ เช่น "พร้อมให้บริการวันนี้" "พร้อมให้บริการพรุ่งนี้" หรือ "วว วว/ดด" ตามวันที่พร้อมให้บริการที่เร็วที่สุด
เมื่อส่งข้อมูลนี้ในฟีด คุณจะส่งวันที่ในอนาคตที่มีความพร้อมจําหน่ายสินค้า รวมถึงเวลาล่าสุดที่ผู้ใช้สั่งซื้อและกําหนดเวลารับสินค้าหรือการนําส่งสําหรับแต่ละวันได้ ข้อมูล 2 ชิ้นนี้คือวันที่ดําเนินการและเวลาสั่งซื้อล่าสุดตามลําดับ
เช่น หากวันนี้คือวันที่ 23 มีนาคม 2021 และพร้อมนําส่งวันพรุ่งนี้ ตราบใดที่ผู้ใช้สั่งซื้อภายในวันนี้ เวลา 16:00 น. ข้อมูลที่คุณให้ก็จะแสดงในสถานะดังกล่าว
- วันที่เผยแพร่: 24/03/2021
- สั่งซื้อครั้งล่าสุด: 23/03/2021 16:00 น.
เนื่องจากระบบจะรวมเวลาการสั่งซื้อครั้งล่าสุดไว้หลังจากพ้นเวลาดังกล่าวไปแล้ว ส่วนหน้าของ Google จะอัปเดตเป็นวันที่พร้อมให้บริการครั้งถัดไปโดยอัตโนมัติ หลังจากเวลาสุดท้ายที่สั่งซื้อผ่านไป
เมื่อระบุฟีดผู้ขายใหม่ คุณต้องระบุข้อมูลความพร้อมจําหน่ายสินค้าใหม่ในแต่ละวัน เนื่องจากส่วนหน้าจะแสดงเฉพาะความพร้อมจําหน่ายสินค้าปัจจุบันเท่านั้น คุณจึงต้องระบุวันที่ที่พร้อมให้บริการ 3-5 ครั้งถัดไปสําหรับสถานที่นั้นๆ การดําเนินการนี้ช่วยให้ส่วนหน้าแสดงความพร้อมจําหน่ายสินค้าในปัจจุบันและพร้อมให้แสดงรายการถัดไปหลังเวลาสั่งซื้อล่าสุดผ่านไปแล้ว
การระบุความพร้อมให้บริการผ่านฟีด
ความพร้อมใช้งานของลิงก์การดําเนินการจะรวมอยู่ในข้อความ action_link ของฟีด Merchant โดยเป็นส่วนหนึ่งของช่อง order_online_metadata ข้อความแต่ละรายการของ AvailableDay ในเส้นทางมีดังนี้ สําหรับผู้ขายแต่ละรายและตัวเลือกการดําเนินการตามคําสั่งซื้อแต่ละรายการ
Merchant.action_link.order_online_metadata.fulfillment_option.available_day
ข้อความเหล่านี้จะต้องอยู่ในรูปแบบต่อไปนี้
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
},
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
}
ในรูปแบบนี้ fulfillment_date คือปี เดือน และวันที่มีความพร้อมจําหน่ายสินค้า วันที่นี้ควรอ้างอิงถึงตําแหน่งที่ระบุโดยผู้ขายรายนี้
last_ordering_time เป็นการประทับเวลาแบบ Unix ในหน่วยวินาที เขตเวลาจะเป็นเขตเวลาอิสระ และทําเครื่องหมายช่วงเวลาสุดท้ายที่ผู้ขายสามารถรับคําสั่งซื้อสําหรับวันที่ที่ระบุใน fulfillment_date เวลาสุดท้ายที่สั่งซื้ออาจอยู่ก่อนหรือระหว่างวันที่ดําเนินการตามคําสั่งซื้อก็ได้ เมื่อหมดเวลาสั่งซื้อครั้งล่าสุด Google จะหยุดแสดงความพร้อมจําหน่ายสินค้าโดยอัตโนมัติสําหรับวันจําหน่ายที่ระบุ และเริ่มแสดงความพร้อมจําหน่ายสินค้าตามวันที่ดําเนินการตามคําสั่งซื้อถัดไป
ดูคําจํากัดความอ้างอิงของ order_online_metadata ได้ที่ข้อมูลอ้างอิงฟีดผู้ขาย สําหรับตัวอย่างฟีดที่มีความพร้อมจําหน่ายสินค้าในรูปแบบ JSON โปรดดูหัวข้อตัวอย่างฟีดสําหรับธุรกิจค้าปลีก + ข้อมูลเมตา
กําลังอัปเดตความพร้อมอัปเดตแบบเรียลไทม์
หากความพร้อมให้บริการของสถานที่สําหรับการจัดส่งหรือรับสินค้ามีการเปลี่ยนแปลงในระหว่างการส่งฟีดรายวัน ระบบจะใช้ REST API แบบเรียลไทม์เพื่ออัปเดตความพร้อมจําหน่ายสินค้าที่แสดงต่อผู้ใช้
และจะอัปเดตผู้ขายทีละราย เมื่อทําการอัปเดต คุณจะระบุผู้ขายที่จะอัปเดต และช่องที่ควรอัปเดตเป็นส่วนหนึ่งของปลายทาง API จากนั้นในเนื้อหาของคําขอ คุณจะใส่ข้อมูลใหม่สําหรับช่องเหล่านั้น ช่องที่กําลังอัปเดตจะถูกแทนที่ด้วยข้อมูลที่ระบุ
หากต้องการอัปเดตความพร้อมจําหน่ายสินค้า คุณจะต้องส่งคําขอแพตช์ไปยังปลายทางต่อไปนี้
PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link
จากนั้นเนื้อหาของคําขอจะเป็นออบเจ็กต์ Merchant ที่มี action_link รวมอยู่ด้วยเท่านั้น (เนื่องจากเราได้ตั้งค่าให้ updateMask รวมเฉพาะ action_link)
{
"action_link": [
..., // all required action_link fields here
"order_online_metadata": {
"fulfillment_option": [
"fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
"available_day": [ // Include the updated availability here
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
}
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
},
... // Other updated availability_days
]
]
}
]
}
หากคําขอ API สําเร็จ การตอบกลับจะรวมออบเจ็กต์ Merchant ที่มีข้อมูลที่อัปเดตใหม่
ดูข้อมูลจําเพาะฉบับเต็มของวิธีการอัปเดตผู้ขายได้ที่เมธอด:inventory.partners.merchants.patch
ความถูกต้องของความพร้อมจําหน่ายสินค้า
"จองกับ Google" เข้าใจดีว่าความพร้อมให้บริการที่เจาะจงนั้นเปลี่ยนแปลงไปตามปัจจัยต่างๆ ปัจจัยดังกล่าว ได้แก่
- การเปลี่ยนแปลงความพร้อมจําหน่ายสินค้าตามขนาดคําสั่งซื้อ
- การเปลี่ยนแปลงความพร้อมจําหน่ายสินค้าตามเวลาที่ใช้ดําเนินการสั่งซื้อและชําระเงินให้เสร็จสมบูรณ์
- ความล่าช้าระหว่างเวลาที่อัปเดตความพร้อมจําหน่ายสินค้า ไม่ว่าจะผ่านฟีดหรือผ่านการอัปเดตแบบเรียลไทม์
ปัจจัยเหล่านี้อาจทําให้เกิดสถานการณ์ที่ความพร้อมจําหน่ายสินค้าที่แสดงต่อผู้ใช้ในตอนแรกไม่ใช่ความพร้อมจําหน่ายสินค้าสุดท้ายที่จุดชําระเงิน เป้าหมายการติดตั้งใช้งานความพร้อมใช้งานไม่ใช่การกําจัดทั้งหมด แต่เป็นการให้ข้อมูลที่ชัดเจนแก่ผู้ใช้บ่อยที่สุด
พาร์ทเนอร์ควรคาดหวังว่าจะมีการนําไปใช้งานซึ่งนําไปสู่ความพร้อมจําหน่ายสินค้าที่ถูกต้องซึ่งแสดงต่อผู้ใช้ให้บ่อยที่สุดเท่าที่จะทําได้ นอกจากนี้ หากความพร้อมจําหน่ายมีการเปลี่ยนแปลงเนื่องจากรายละเอียดคําสั่งซื้อ ผู้ใช้ควรเห็นข้อมูลนี้อย่างชัดเจน หากไม่แน่ใจว่าสิ่งใดคือสิ่งที่กําหนดในกรณีที่แน่นอน โปรดติดต่อตัวแทนของ "จองกับ Google"