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