บทความนี้กล่าวถึงกระบวนการเปิดใช้ API เมนูสำหรับบัญชีและการผสานรวมกับ API ของเมนู ด้านล่างนี้คือภาพรวมโดยละเอียดของกระบวนการเริ่มต้นใช้งานและการเปิดตัวข้อกำหนดเบื้องต้น โปรดดูหน้านี้เมื่อวางแผนผสานรวม
- การตั้งค่า - การกำหนดค่าบัญชีและการวางแผนของกระบวนการพัฒนา
- การพัฒนา - การพัฒนาและทดสอบฟีดข้อมูล
- เปิดตัว - การประเมินข้อมูลก่อนการเปิดตัว
ตั้งค่า
ในขั้นตอนนี้ คุณควรยืนยันว่าบัญชีของคุณในพอร์ทัลพาร์ทเนอร์ได้รับการกำหนดค่าอย่างสมบูรณ์และพร้อมยอมรับฟีดข้อมูลที่เกี่ยวข้องกับข้อมูลเมนูแบบคงที่แล้ว หากคุณมีการผสานรวมการเปลี่ยนเส้นทาง OwG หรือ RwG ที่ใช้งานอยู่ซึ่งคุณกำลังเพิ่มข้อมูลเมตาของเมนูอยู่ ระบบจะนำบัญชีที่มีอยู่กลับมาใช้สำหรับการผสานรวมนี้ ในกรณีที่มีการผสานรวม OwG Direct บนแพลตฟอร์มนี้หรือไม่มีการผสานรวมเลย ระบบจะสร้างบัญชีใหม่และจะแชร์รายละเอียดการเข้าถึงทางอีเมล
เข้าถึงบัญชีในพอร์ทัลพาร์ทเนอร์และไปที่หน้าการกำหนดค่าดรอปบ็อกซ์ การกำหนดค่า > ฟีด มีดรอปบ็อกซ์ 2 รายการที่เกี่ยวข้องกับการผสานรวมฟีดข้อมูลเมนู ได้แก่ ทั่วไปและผู้ขาย โปรดตรวจสอบว่าดรอปบ็อกซ์ทั้ง 2 รายการกำหนดค่าคีย์สาธารณะ SSH แล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีกำหนดค่าคีย์ SSH ได้ที่หน้านี้
ดรอปบ็อกซ์ทั่วไปรองรับฟีดต่างๆ ที่เป็นไปตามสคีมาข้อมูลที่แตกต่างกันได้ ประเภทฟีดที่ยอมรับข้อมูลเมนูที่มีโครงสร้างจะมีชื่อว่า google.food_menu และโดยปกติจะเปิดใช้กับบัญชีโดยค่าเริ่มต้นเมื่อเริ่มต้นการเริ่มต้นใช้งาน ในกรณีที่คุณพยายามส่งฟีดและเห็นข้อความแสดงข้อผิดพลาดนี้ -
"การประมวลผลฟีดล้มเหลว เราพบปัญหาภายในขณะแยกวิเคราะห์ฟีดของคุณ ไม่ได้เปิดใช้ "google.food_menu" โปรดแก้ไขแล้วลองอีกครั้ง" โปรดติดต่อตัวแทนของ Google เพื่อเปิดใช้ฟีดประเภทนี้
สุดท้าย ให้ไปที่หน้า การกำหนดค่า > ข้อมูลติดต่อ และตรวจสอบว่าข้อมูลติดต่อทั้งหมดเป็นข้อมูลล่าสุด
การพัฒนา
ขั้นตอนการพัฒนาประกอบด้วยส่วนหลักของความพยายามในการติดตั้งใช้งาน ได้แก่ การสร้างและทดสอบฟีดข้อมูล คุณต้องสร้างและส่งไปยังดรอปบ็อกซ์เป้าหมายทุกวัน โดยฟีดที่ส่งในแซนด์บ็อกซ์จะเริ่มประมวลผลภายใน 1 ชั่วโมงหลังจากส่ง ระบบจะประมวลผลฟีดเวอร์ชันที่ใช้งานจริงทุกวันในเวลา 12:00 น. ในเขตเวลา PST ระบบจะประมวลผลเฉพาะฟีดที่ส่งล่าสุดเท่านั้น โปรดดูข้อกำหนดและตัวอย่างฟีดข้อมูลเมื่อสร้างฟีด แม้ว่าข้อกำหนดจะแสดงในรูปแบบ Protobuf แต่เราขอแนะนำให้อัปโหลดไฟล์ฟีดในรูปแบบ JSON เพราะว่าแก้ปัญหาได้ง่ายกว่า ด้วยเหตุนี้ จึงมีตัวอย่างฟีดในรูปแบบ JSON ด้วย
ไฟล์ฟีดข้อมูล 1 ไฟล์สามารถทดสอบได้อย่างรวดเร็วโดยใช้เครื่องมือออนไลน์สำหรับโปรแกรมตรวจสอบฟีดในการตรวจสอบว่าไฟล์นั้นสอดคล้องกับข้อกำหนดหรือไม่ เครื่องมือจะแสดงให้เห็นว่าไฟล์ตรงกับสคีมาข้อมูลหรือไม่ และหากไม่ตรงกัน เครื่องมือจะแสดงรายการข้อผิดพลาด หากต้องการทดสอบฟีดข้อมูลทั้งหมดที่ประกอบด้วยไฟล์หลายไฟล์ ให้อัปโหลดฟีดดังกล่าวในสภาพแวดล้อมแซนด์บ็อกซ์ และดูผลลัพธ์ในพอร์ทัลพาร์ทเนอร์หลังจากที่นำเข้าข้อมูลเรียบร้อยแล้ว ระหว่างการนำเข้าฟีดมีการใช้กฎการตรวจสอบเพิ่มเติมในการทดสอบตรรกะทางธุรกิจบางอย่างและคุณภาพของข้อมูล
เปิดใช้งาน
ขั้นตอนการเปิดตัวจะเริ่มต้นได้หลังจากงานผสานรวมทั้งหมดเสร็จสมบูรณ์แล้ว และฟีดเวอร์ชันที่ใช้งานจริงจะแสดงสินค้าคงคลังของเมนูอาหารทั้งหมดอย่างถูกต้อง
เปิดข้อกำหนดเบื้องต้น
การผสานรวมต้องมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้
- ระบบประมวลผลฟีดข้อมูลในสภาพแวดล้อมเวอร์ชันที่ใช้งานจริงโดยมีข้อผิดพลาด 0 รายการ
- ฟีดข้อมูลเวอร์ชันที่ใช้งานจริงมีพื้นที่โฆษณาทั้งหมดที่กำหนดขอบเขตสำหรับการผสานรวมนี้เมื่อเริ่มต้นการผสานรวมนี้
- ข้อมูลผู้ขายส่วนใหญ่ตรงกับสถานที่ตั้งใน Google Maps
- ฟีดเวอร์ชันที่ใช้งานจริงผ่านการประเมินคุณภาพของข้อมูล
- การผสานรวมนี้เป็นไปตามนโยบายและข้อกำหนดเมนูอาหารทั้งหมด
การประเมินข้อมูล
หลังจากนำเข้าฟีดข้อมูลที่ใช้งานจริงโดยไม่มีข้อผิดพลาดแล้ว อาจมีกระบวนการภายในเพื่อประเมินคุณภาพของข้อมูลเมนู กระบวนการนี้มีเป้าหมายเพื่อค้นหาความไม่สอดคล้องกันในคุณภาพของข้อมูล เช่น เนื้อหาที่ไม่เกี่ยวข้องกับอาหารในคำอธิบายอาหาร ชื่ออาหาร ราคาไม่ตรงกัน เป็นต้น เราจะแชร์ความคิดเห็นกับทีมพัฒนาหากค้นพบ