ภาพรวม

พาร์ทเนอร์ของ Google สามารถให้ข้อมูลเมนูที่มีโครงสร้างแก่ Google ผ่านการผสานรวมการจองแบบครบวงจร เพื่อใช้ในส่วนเมนูของ Google Business Profile ของร้านอาหารและจุดแรกเข้าอื่นๆ ในแพลตฟอร์มสำหรับผู้บริโภคของ Google

ระบบจะนำเข้าข้อมูลเมนูโดยใช้ฟีดทั่วไป ก่อนเริ่มใช้งาน

  1. โปรดตรวจสอบว่าคุณได้สร้างบัญชีเสร็จสมบูรณ์แล้ว
  2. ทำความเข้าใจกระบวนการอัปโหลดฟีดทั่วไป
  3. ทำความเข้าใจวิธีกำหนดค่าบัญชีสำหรับการอัปโหลดฟีดทั่วไป

การสร้างและอัปโหลดฟีดเมนู

เมื่อสร้างและอัปโหลดฟีดเมนู ให้ทำตามหลักเกณฑ์และข้อกำหนดต่อไปนี้
  • หากต้องการระบุรายละเอียดร้านอาหาร ให้ทำตามข้อกำหนดของข้อมูลที่อธิบายไว้ในฟีดผู้ขาย ดูตัวอย่างไฟล์ JSON ได้ที่ตัวอย่าง JSON ชื่อไฟล์ข้อมูลควรไม่ซ้ำกันระหว่างการอัปโหลด ขอแนะนำให้ใส่การประทับเวลาใน ชื่อไฟล์ เช่น menu1_1633621547.json
  • ในตัวอธิบายชุดไฟล์สำหรับฟีดเมนู ให้ตั้งค่าฟิลด์ name เป็น google.food_menu หากต้องการดูตัวอย่างเนื้อหาของไฟล์ตัวอธิบาย โปรดดูตัวอย่าง JSON ของไฟล์ตัวอธิบาย ชื่อไฟล์ตัวอธิบายควรไม่ซ้ำกันระหว่างการอัปโหลด ขอแนะนำให้ใส่ การประทับเวลาในชื่อไฟล์ เช่น descriptor_1633621547.filesetdesc.json คุณต้องอัปโหลดไฟล์ตัวอธิบายไปยังเซิร์ฟเวอร์ SFTP ทั่วไปซึ่งเป็นส่วนหนึ่งของฟีดเมนู
  • คุณต้องอัปโหลดฟีดไปยังเซิร์ฟเวอร์ SFTP ทั่วไปทุกวันเพื่อรีเฟรชข้อมูลทั้งหมด
  • จำกัดฟีดไว้ที่ 1,000 Shard (ไฟล์) ตามที่ระบุไว้ในการใช้ SFTP ฟีดทั่วไป

คุณดูสถานะการส่งผ่านข้อมูลฟีดได้ในส่วนการส่งผ่านข้อมูล > ประวัติ ของพอร์ทัลพาร์ทเนอร์ คุณดูข้อมูลเซิร์ฟเวอร์ SFTP ของฟีดได้ในส่วนการกำหนดค่า > ฟีด ของพอร์ทัลพาร์ทเนอร์

การเลือกเซิร์ฟเวอร์ SFTP ของฟีด

รูปที่ 1: ข้อมูลเซิร์ฟเวอร์ SFTP ทั่วไป

คุณดูสถานะการส่งผ่านข้อมูลฟีดได้ในส่วนการส่งผ่านข้อมูล > ประวัติ ของพอร์ทัลพาร์ทเนอร์ คุณดูข้อมูลเซิร์ฟเวอร์ SFTP ของฟีดได้ในส่วนการกำหนดค่า > ฟีด ของพอร์ทัลพาร์ทเนอร์

การทำงานกับตัวเลือกรายการเมนู

คุณระบุตัวเลือกรายการเมนูได้โดยใช้ โปรโต MenuItemOption

พาร์ทเนอร์ที่มีชุด ตัวเลือกที่จำเป็นหลายชุดสำหรับรายการเมนูเดียว (เช่น ลาเต้ที่มีตัวเลือกขนาดและตัวเลือกนม) ต้องตัดสินใจว่าจะแสดงตัวเลือกเหล่านั้นใน Google อย่างไรให้ดีที่สุด Google ขอแนะนำให้ทำดังนี้

  • ฟีดเมนูควรตรงกับเว็บไซต์การสั่งซื้อของพาร์ทเนอร์ (หรือเมนูรับประทานอาหารที่ร้านของร้านอาหารหาก คุณไม่มีเว็บไซต์การสั่งซื้อสำหรับสถานที่ตั้ง) หากสินค้าแสดงพร้อมราคาแต่ละรายการในเว็บไซต์สั่งซื้อ คุณควรใช้ MenuItem หากแสดงสินค้าพร้อมราคาฐานและตัวเลือกหลายรายการ คุณควรใช้ MenuItemOption
  • หลีกเลี่ยงการใส่รายการตัวเลือกยาวๆ เช่น
    • เบอร์ริโตไก่
    • เบอร์ริโต้ไก่ใส่ชีส
    • บูริโตไก่กับซัลซ่า
    • เบอร์ริโตไก่กับซัลซ่าและชีส
    • เบอร์ริโตไก่กับกัวคาโมเล
    • เบอร์ริโตไก่กับกัวกาโมเลและซัลซ่า
  • ระบบจะรองรับตัวเลือกรายการในเมนูเฉพาะในกรณีที่อาหารต้องเลือกตัวเลือกใดตัวเลือกหนึ่ง เท่านั้น เช่น เมื่อสั่งพิซซ่า ขนาดเป็นตัวเลือกที่จำเป็น ระบบไม่รองรับตัวเลือกรายการเมนูที่ มีไว้สำหรับส่วนเสริม (เช่น "ตัวเลือกในการเพิ่มอะโวคาโด") และไม่ควรระบุไว้ในฟีด

ราคาตัวเลือกของรายการในเมนูควรเป็นราคาเต็มของรายการเมื่อเลือกตัวเลือกนั้น คุณควรกำหนดราคาสำหรับรายการเมนูหรือตัวเลือกของรายการ แต่ไม่ควรตั้งค่าทั้ง 2 อย่าง

ร้านอาหารที่มีหลายเมนู

ร้านอาหาร (เอนทิตี) 1 แห่งจะมีเมนูได้เพียง 1 รายการ สำหรับร้านอาหารที่มีหลายเมนู (เช่น เมนูมื้อเที่ยงและมื้อค่ำแยกกัน) คุณสามารถรวมเมนูทั้งหมดเป็นเมนูเดียวด้วย MenuSections (เช่น เมนูเดียวที่มีส่วนสำหรับมื้อเที่ยงและส่วนสำหรับมื้อค่ำ) เมนูที่ได้จะมีโครงสร้างดังนี้ the following structure:

  • เมนู
    • ส่วนอาหารกลางวัน
      • ซุป
        • ซุป 1
        • ซุป 2
      • แซนด์วิช
        • แซนด์วิช 1
        • แซนด์วิช 2
    • ส่วนอาหารค่ำ
      • จานเรียกน้ำย่อย
        • Starter 1
        • Starter 2
      • อาหารจานหลัก
        • จานหลัก 1
        • จานหลัก 2

การแชร์เมนูในร้านอาหารต่างๆ

คุณแชร์เมนูเดียวในร้านอาหารหลายแห่งได้โดยใส่ร้านอาหารทั้งหมดไว้ในmerchant_idsรายการของเมนู โปรดทราบว่ารายการนี้ยอมรับรหัสเอนทิตีสำหรับพาร์ทเนอร์ที่ใช้ฟีดเอนทิตี

แนวทางปฏิบัติแนะนำ

แนวทางปฏิบัติแนะนำที่ควรทำตามเมื่อพัฒนาฟีดเมนูมีดังนี้

  • เชื่อมโยงเมนู กับร้านอาหารเพียงรายการเดียว
  • อนุญาตให้มีออบเจ็กต์ MenuItem ที่ไม่ซ้ำกันได้สูงสุด 3,000 รายการ (ในทุกส่วนและส่วนย่อยที่ซ้อนกัน)
  • อนุญาตให้มีเอนทิตีที่ไม่ซ้ำกันสูงสุด 100,000 รายการต่อประเภทเอนทิตี (MenuSection, MenuItem, MenuItemOption) ภายใน Menu เดียว
  • Menu ที่ประกอบเสร็จสมบูรณ์ (รวมส่วน รายการ และตัวเลือกทั้งหมดหลังจากการขจัดข้อมูลที่ซ้ำกัน) ต้องมีขนาดไม่เกิน 3.8 MB
  • ฟิลด์รหัสทั้งหมด (menu_id, merchant_ids, menu_section_ids, menu_item_ids, menu_item_option_ids, addon_menu_section_ids) ต้องมีไม่เกิน 580 อักขระ
  • ระบุภาษาที่ต้องการเป็นภาษาแรกใน TextField หากคุณส่งออบเจ็กต์ LocalizedText หลายรายการ ระบบจะแสดงออบเจ็กต์แรกในรายการข้อความต่อผู้ใช้
  • คุณต้องเพิ่มรายการในเมนู ทั้งหมดลงในส่วนเมนู อย่าเพิ่มรายการในเมนูลงในออบเจ็กต์เมนูโดยตรง
  • ระบุเนื้อหาโดยใช้การเข้ารหัส UTF-8 คุณไม่จำเป็นต้องยกเว้นอักขระที่ไม่ใช่ ASCII
  • หากคุณเปิดตัวในหลายภูมิภาค โปรดตรวจสอบว่าคุณใช้รหัสสกุลเงินและ หน่วยเงินที่ถูกต้องในฟิลด์หน่วยและฟิลด์นาโน - โปรดระมัดระวังเป็นพิเศษในฟิลด์นาโนซึ่งมีค่า 10^-9 ของหน่วย ใช้เครื่องมือแสดงภาพเมนูในเครื่องมือดูพื้นที่โฆษณา เพื่อยืนยันว่าคุณได้ตั้งราคาอย่างถูกต้อง
  • การแสดงเมนูที่สมบูรณ์ ครอบคลุม และใหม่ล่าสุดแก่ผู้ใช้เป็นกุญแจสำคัญในการมอบ ประสบการณ์การใช้งานที่เป็นประโยชน์และน่าสนใจ ราคา คำอธิบาย รูปภาพ และข้อมูลด้านอาหาร เป็นองค์ประกอบสำคัญในการกระตุ้นการตัดสินใจ และเราขอแนะนำให้พาร์ทเนอร์ระบุข้อมูลเหล่านี้ให้มากที่สุด เพื่อมอบประสบการณ์การใช้งานที่ดีที่สุดแก่ผู้ใช้และผู้ขาย
  • หากต้องการไม่แสดงราคา ให้ใส่โปรโต Price ที่ว่างเปล่าในโปรโต Offer

หลังจาก เปิดตัวฟีดเมนูแล้ว ข้อมูลฟีดเมนูจะมีสิทธิ์ปรากฏในประสบการณ์การค้นพบ และอาจ แสดงในแท็บ "เมนู" ของเพลสชีตร้านอาหาร แท็บเมนูรองรับใน Google Search (อุปกรณ์เคลื่อนที่และเดสก์ท็อป) และจะขยายประสบการณ์การใช้งานไปยังแพลตฟอร์มอื่นๆ รวมถึง Google Maps ประสบการณ์การใช้งานที่แสดงผลอาจแตกต่างกันไปตามแพลตฟอร์ม

ตัวอย่างเมนูที่แสดงรายการเมนูพร้อมคำอธิบาย

รูปที่ 3: ตัวอย่างวิธีแสดงเนื้อหาฟีดเมนูใน Business Profile บนอุปกรณ์เคลื่อนที่

หากต้องการให้มั่นใจว่าเมนูมีโครงสร้างถูกต้อง ให้ใช้เครื่องมือแสดงภาพเมนูในเครื่องมือดูพื้นที่โฆษณา เพื่อดูตัวอย่างเมนู

เมนูร้านอาหารอาจมาจากหลายแหล่งที่มา รวมถึงจากร้านอาหารเองผ่าน Google Business Profile, พาร์ทเนอร์การสั่งอาหารและการจอง, รูปภาพเมนูที่ผู้ใช้ถ่าย และอื่นๆ หากมีแหล่งที่มาหลายแห่งที่ให้เมนูสำหรับร้านอาหารเดียวกัน ผู้ขายสามารถเลือกผู้ให้บริการที่ต้องการ ในเครื่องมือแก้ไขเมนูของ Google Business Profile

สคีมา

ดูสคีมาเมนูทั้งหมดได้ที่นี่

FoodMenuFeed

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
dataอาร์เรย์ของออบเจ็กต์
(MenuComponent)

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
oneOf
(type)

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้

แคตตาล็อกระดับบนสุดของรายการอาหารที่สถานประกอบการด้านอาหารเสนอ เมนู ประกอบด้วยรายการรหัสผู้ขายและเมนูที่ใช้กับผู้ขายเหล่านั้น คุณใช้เมนูเพื่อแสดงผู้ขายรายเดียวที่มีเมนู หรือผู้ขายหลายราย (โดยทั่วไปคือร้านอาหารในเครือ) ที่มีเมนูได้

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menu_idสตริง

ต้องระบุ

สตริงทึบแสงจากพาร์ทเนอร์ซึ่งระบุเมนูในฟีดของพาร์ทเนอร์อย่างไม่ซ้ำกัน ต้องระบุ
merchant_idsอาร์เรย์ของสตริง

ต้องระบุ

ผู้ขายที่ใช้เมนู หมายเหตุ: ฟิลด์นี้จะซ้ำกันเพื่อให้ร้านอาหารในเครือแชร์เมนูเดียวกัน ในหลายๆ สถานที่ตั้ง ซึ่งแต่ละแห่งเป็นผู้ขายแยกกัน ต้องระบุ
display_nameobject
(TextField)

ชื่อที่ระบุเมนูได้เมื่อผู้ใช้เรียกดูเมนู ไม่บังคับ
languageสตริง

รหัสภาษาเริ่มต้นที่เชื่อมโยงกับป้ายกำกับข้อความที่มีอยู่ใน เมนู คาดหวังรหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier ไม่บังคับ

TextField

เพย์โหลดข้อความที่มีค่าที่แปลแล้วอย่างน้อย 1 ค่า

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
textอาร์เรย์ของออบเจ็กต์
(LocalizedText)

ต้องระบุ

ค่าข้อความต่อภาษา หากต้องการรองรับภาษาเดียว ไม่จำเป็นต้องตั้งค่า language_code ภายใน แต่ละข้อความ และระบบจะอนุมานภาษาจาก ภาษาเริ่มต้นของเมนู หากมีข้อความหลายรายการในภาษาต่างๆ คุณต้องตั้งค่า language_code สำหรับข้อความแต่ละรายการ ข้อความแรกในรายการจะถือเป็น การแสดงที่ต้องการ ต้องระบุ

LocalizedText

ข้อความในภาษาหนึ่งๆ ที่แปลแล้ว

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
textสตริง

สตริงที่แปลเป็นภาษาที่สอดคล้องกับ [language_code][google.type.LocalizedText.language_code] ด้านล่าง
language_codeสตริง

รหัสภาษา BCP-47 ของข้อความ เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier

ส่วนเมนูคือการจัดกลุ่มรายการในเมนู โดยปกติแล้ว ระบบจะสร้าง MenuSection แยกต่างหาก สำหรับการจัดกลุ่มรายการในเมนูตามตรรกะแต่ละรายการ เช่น ประเภทคอร์สอาหาร (อาหารเรียกน้ำย่อย อาหารจานหลัก ของหวาน) และหมวดหมู่อาหาร (เบอร์เกอร์ เครื่องดื่ม) เป็นส่วนทั่วไป

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menu_section_idสตริง

ต้องระบุ

สตริงทึบแสงจากพาร์ทเนอร์ที่ระบุ MenuSection ในฟีดพาร์ทเนอร์อย่างไม่ซ้ำกัน ต้องระบุ
display_nameobject
(TextField)

ต้องระบุ

ชื่อที่ระบุ MenuSection ได้เมื่อผู้ใช้เรียกดูเมนู ต้องระบุ
descriptionobject
(TextField)

คำอธิบายของส่วนเมนู ไม่บังคับ
imagesอาร์เรย์ของออบเจ็กต์
(Image)

รูปภาพส่วนเมนู ไม่บังคับ

รูปภาพ

แสดงรูปภาพที่เชื่อมโยงกับเอนทิตีเมนู

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
uriสตริง

ต้องระบุ

URL ที่มีพิกเซลดิบของรูปภาพ ต้องระบุ

แสดงรายการอาหารหรือเครื่องดื่มรายการเดียวที่สถานประกอบการด้านอาหารเสนอ

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menu_item_idสตริง

ต้องระบุ

สตริงทึบแสงจากพาร์ทเนอร์ที่ระบุ MenuItem ในฟีดพาร์ทเนอร์อย่างไม่ซ้ำกัน ต้องระบุ
display_nameobject
(TextField)

ต้องระบุ

ชื่อที่ระบุ MenuItem ได้เมื่อผู้ใช้เรียกดูเมนู ต้องระบุ
descriptionobject
(TextField)

คำอธิบายของรายการในเมนู ไม่บังคับ
imagesอาร์เรย์ของออบเจ็กต์
(Image)

รูปภาพของรายการในเมนู ไม่บังคับ
oneOf
(pricing)

ต้องระบุ

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้
item_attributesobject
(MenuItemAttributes)

แอตทริบิวต์เกี่ยวกับรายการในเมนูนี้ ไม่บังคับ

OfferSet

คอนเทนเนอร์สำหรับรายการข้อเสนอที่พร้อมใช้งานในรายการเมนู / ตัวเลือก ควรมีข้อเสนอที่ใช้ได้/มีผลครั้งละ 1 รายการเท่านั้น เช่น เครื่องดื่มอาจมีข้อเสนอ 2 รายการ โดยรายการหนึ่งใช้ได้ในตอนเช้า ส่วนอีกรายการใช้ได้ในตอนเย็นช่วงแฮปปี้อาวร์

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
offersอาร์เรย์ของออบเจ็กต์
(Offer)

ต้องระบุ

รายการข้อเสนอที่เป็นไปได้ ต้องระบุ

ข้อเสนอ

แสดงข้อมูลราคาและความพร้อมจำหน่ายสินค้าสำหรับ MenuItem และ MenuItemOption

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
priceobject
(Money)

กรณีต่อไปนี้ไม่ถูกต้องและจะส่งผลให้รายการเมนูถูก ทิ้ง: ราคาที่ไม่มีรหัสสกุลเงินแต่มีหน่วยหรือนาโนหรือทั้ง 2 อย่าง price {units: 100, nanos: 1000000} price {units: 100} price {nanos: 1000000} ราคาที่มีรหัสสกุลเงินไม่ถูกต้องแต่มีหน่วยหรือนาโนหรือทั้ง 2 อย่าง price {currency_code: 'gXYZ', units: 100, nanos: 1000000} price {currency_code: 'gXYZ', units: 100} price {currency_code: 'gXYZ', nanos: 1000000} ราคาที่มีรหัสสกุลเงินแต่มีหน่วยหรือนาโนไม่ถูกต้อง price {currency_code: 'USD', units: 100, nanos: -100} price {currency_code: 'USD', units: -100, nanos: 100}

เงินทอง

แสดงจำนวนเงินพร้อมประเภทสกุลเงิน

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
currency_codeสตริง

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217
unitsตัวเลข

หน่วยเต็มของจำนวนเงิน เช่น หาก currencyCode คือ "USD" หน่วย 1 หน่วยจะเท่ากับ 1 ดอลลาร์สหรัฐ
nanosตัวเลข

จำนวนหน่วยนาโน (10^-9) ของจำนวนเงิน ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 รวมสองค่านี้ด้วย หาก units เป็นบวก nanos ต้องเป็นบวกหรือ 0 หาก units เป็น 0 nanos จะเป็นค่าบวก 0 หรือค่าลบก็ได้ หาก units ติดลบ nanos ต้องติดลบหรือเป็น 0 เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000

คอนเทนเนอร์ที่ระบุรายการตัวเลือกที่มีในสินค้า

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menu_item_option_idsอาร์เรย์ของสตริง

ต้องระบุ

รหัสของตัวเลือกรายการเมนูที่ใช้ได้กับรายการเมนูนี้ ต้องระบุ

อธิบายแอตทริบิวต์เกี่ยวกับรายการหรือตัวเลือกในเมนูที่เฉพาะเจาะจง

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
number_of_servingsตัวเลข

จำนวนหน่วยบริโภคที่มีในรายการเมนูที่ระบุ ไม่บังคับ
nutrition_informationobject
(NutritionInformation)

อธิบายข้อมูลโภชนาการทั้งหมดของสินค้า เช่น แคลอรี่ ปริมาณไขมัน ไม่บังคับ
suitable_dietsอาร์เรย์ของ enum
(DietaryRestriction)

ข้อจำกัดด้านอาหารที่รายการเมนูนี้เป็นไปตาม ไม่บังคับ
additiveอาร์เรย์ของออบเจ็กต์
(Additive)

สารเติมแต่งของรายการในเมนูนี้ ไม่บังคับ
allergenอาร์เรย์ของออบเจ็กต์
(Allergen)

สารก่อภูมิแพ้ของรายการในเมนูนี้ ไม่บังคับ
packaging_deposit_infoobject
(DepositInfo)

ข้อมูลบรรจุภัณฑ์และการรีไซเคิลของรายการเมนูนี้ ไม่บังคับ

NutritionInformation

อธิบายการวัดค่าโภชนาการทั้งหมดของ MenuItem หรือส่วนเสริม

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
energyobject
(NutritionValue)

ปริมาณพลังงานทางโภชนาการของอาหาร 1 หน่วยบริโภค กำหนดได้ เป็นแคลอรี่หรือกิโลจูล ไม่บังคับ
sodium_contentobject
(NutritionValue)

ปริมาณโซเดียมที่วัดเป็นกรัมหรือมิลลิกรัม ไม่บังคับ
serving_sizeตัวเลข

จำนวนหน่วยบริโภคที่ใช้ค่าโภชนาการ ไม่บังคับ
descriptionobject
(TextField)

ข้อมูลโภชนาการในข้อความอิสระ เช่น "มีสารกันบูด" ไม่บังคับ

NutritionValue

อธิบายการวัดโภชนาการครั้งเดียวของอาหาร 1 หน่วยบริโภค

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
oneOf
(value)

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้
unitenum
(NutritionValueUnit)

ต้องระบุ

หน่วยที่เชื่อมโยงกับจํานวนเงินตามที่ระบุจากพาร์ทเนอร์ เราจะตรวจสอบฟีดเพื่อให้มั่นใจว่าหน่วยสำหรับค่าโภชนาการแต่ละประเภท เป็นไปตามที่คาดไว้สำหรับค่าประเภทนั้น เช่น คาดว่าจะมีเฉพาะ ENERGY_CALORIES และ ENERGY_KILOJOULES ในพร็อพเพอร์ตี้พลังงานของ NutritionalInformation ต้องระบุ

ช่วง

อธิบายช่วงปิดสำหรับคุณค่าทางโภชนาการ เช่น "100-150 แคลอรี่"

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
minตัวเลข

ต้องระบุ

ปริมาณคุณค่าทางโภชนาการขั้นต่ำ ต้องระบุ
maxตัวเลข

ต้องระบุ

ปริมาณคุณค่าทางโภชนาการสูงสุด ต้องระบุ

สารเติมแต่ง

สารเติมแต่งที่แสดงต่อผู้ใช้ใน MenuItem สารเติมแต่งช่วยรักษาหรือปรับปรุง คุณภาพของอาหาร

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
nameobject
(TextField)

ต้องระบุ

ข้อความอธิบายของสารเติมแต่ง เช่น "สารกันบูด" ต้องระบุ
containment_level_codeenum
(ContainmentLevelCode)

ระบุว่า MenuItem มี อาจมี หรือไม่มีสารเติมแต่งนี้ ค่าเริ่มต้นคือ "มี" ไม่บังคับ

สารก่อภูมิแพ้

สารก่อภูมิแพ้ที่แสดงต่อผู้ใช้ใน MenuItem สารก่อภูมิแพ้เกี่ยวข้องกับคุณภาพ ของอาหารที่ทำให้เกิดอาการแพ้

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
allergen_type_codeenum
(AllergenTypeCode)

ต้องระบุ

ประเภทสารก่อภูมิแพ้ ต้องระบุ
containment_level_codeenum
(ContainmentLevelCode)

ไม่ว่า MenuItem จะมี อาจมี หรือไม่มีสารก่อภูมิแพ้นี้ ค่าเริ่มต้นคือ "มี" ไม่บังคับ

DepositInfo

ข้อมูลการฝากที่พาร์ทเนอร์ระบุเพื่อแนะนำผู้ใช้เกี่ยวกับวิธีฝากคืนภาชนะใส่อาหาร หรือขวด และมูลค่าของการฝากคืนดังกล่าว

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
deposit_codeenum
(DepositCode)

กลยุทธ์การฝากที่ใช้ เช่น "นำกลับมาใช้ใหม่ได้" ไม่บังคับ
deposit_valueobject
(Money)

มูลค่าที่คืนเงินสำหรับการฝากไอเทมอย่างถูกต้อง ไม่บังคับ

อธิบายตัวเลือกที่ผู้ใช้จะต้องเลือกเมื่อเลือก จาน / ชุดอาหาร ผู้ใช้ต้องเลือกตัวเลือก มิฉะนั้นระบบจะถือว่าคำสั่งซื้อไม่ถูกต้อง (เช่น ผู้ใช้ต้องเลือกขนาดเล็ก กลาง หรือใหญ่สำหรับพิซซ่า)

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menu_item_option_idสตริง

ต้องระบุ

สตริงทึบจากพาร์ทเนอร์ที่ระบุ MenuItemOption ในฟีดพาร์ทเนอร์โดยไม่ซ้ำกัน ต้องระบุ
valueobject
(MenuItemOptionProperty)

ต้องระบุ

พร็อพเพอร์ตี้และค่าของตัวเลือก เช่น ขนาด: เล็ก ต้องระบุ

อธิบายพร็อพเพอร์ตี้ของตัวเลือกรายการเมนูและค่าของตัวเลือก

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
property_typeenum
(PropertyType)

ต้องระบุ

ประเภทของพร็อพเพอร์ตี้ตัวเลือกนี้ ต้องระบุ
oneOf
(value)

ต้องระบุ

ตั้งค่าได้เพียง 1 ฟิลด์ใน oneOf นี้

NutritionValueUnit

ชื่อคำอธิบาย
NUTRITION_VALUE_UNIT_UNSPECIFIEDโปรดอย่าใช้ ไม่ได้ตั้งค่าหน่วยของค่าโภชนาการอย่างชัดเจน
ENERGY_CALORIESหน่วยที่ใช้แสดงปริมาณพลังงานในรายการเมนู
ENERGY_KILOJOULES
WEIGHT_MILLIGRAMSหน่วยที่ใช้แสดงปริมาณน้ำหนักของสารที่มีอยู่ในรายการเมนู
WEIGHT_GRAMS

DietaryRestriction

ระบุข้อจำกัดด้านอาหารหรือหลักเกณฑ์ที่ปฏิบัติตามในระหว่าง การเตรียมอาหาร

ชื่อคำอธิบาย
DIET_UNSPECIFIEDโปรดอย่าใช้ ไม่ได้ระบุข้อจำกัดด้านอาหารอย่างชัดเจน
DIET_DIABETIC
DIET_GLUTEN_FREE
DIET_HALAL
DIET_HINDU
DIET_KOSHER
DIET_LOW_CALORIE
DIET_LOW_FAT
DIET_LOW_LACTOSE
DIET_LOW_SALT
DIET_VEGAN
DIET_VEGETARIAN

ContainmentLevelCode

ระบุระดับการมีแอตทริบิวต์หนึ่งๆ ในรายการอาหาร เช่น สารก่อภูมิแพ้หรือสารเติมแต่ง

ชื่อคำอธิบาย
CONTAINMENT_LEVEL_CODE_UNSPECIFIEDโปรดอย่าใช้ ไม่ได้ระบุรหัสระดับการล้อมองค์ประกอบอย่างชัดเจน
CONTAINMENT_LEVEL_CODE_CONTAINS
CONTAINMENT_LEVEL_CODE_DOES_NOT_CONTAIN
CONTAINMENT_LEVEL_CODE_MAY_CONTAIN

AllergenTypeCode

ประเภทสารก่อภูมิแพ้ที่ได้จาก GS1: http://gs1.org/voc/AllergenTypeCode

ชื่อคำอธิบาย
ALLERGEN_TYPE_CODE_UNSPECIFIEDโปรดอย่าใช้ ไม่ได้ระบุรหัสประเภทสารก่อภูมิแพ้อย่างชัดแจ้ง
ALLERGEN_TYPE_CODE_ALMONDS
ALLERGEN_TYPE_CODE_ALPHA_ISOMETHYL_IONONE
ALLERGEN_TYPE_CODE_ALCOHOL
ALLERGEN_TYPE_CODE_AMYL_CINNAMAL
ALLERGEN_TYPE_CODE_ANISE_ALCOHOL
ALLERGEN_TYPE_CODE_BARLEY
ALLERGEN_TYPE_CODE_BENZYL_ALCOHOL
ALLERGEN_TYPE_CODE_BENZYL_BENZOATE
ALLERGEN_TYPE_CODE_BENZYL_CINNAMATE
ALLERGEN_TYPE_CODE_BENZYL_SALICYLATE
ALLERGEN_TYPE_CODE_BRAZIL_NUTS
ALLERGEN_TYPE_CODE_BUTYLPHENYL_METHYLPROPIONATE
ALLERGEN_TYPE_CODE_CARROTS
ALLERGEN_TYPE_CODE_CASHEW_NUTS
ALLERGEN_TYPE_CODE_CELERY
ALLERGEN_TYPE_CODE_CEREALS_CONTAINING_GLUTEN
ALLERGEN_TYPE_CODE_CINNAMAL
ALLERGEN_TYPE_CODE_CINNAMYL_ALCOHOL
ALLERGEN_TYPE_CODE_CITRAL
ALLERGEN_TYPE_CODE_CITRONELLOL
ALLERGEN_TYPE_CODE_COCOA
ALLERGEN_TYPE_CODE_CORIANDER
ALLERGEN_TYPE_CODE_CORN
ALLERGEN_TYPE_CODE_COUMARIN
ALLERGEN_TYPE_CODE_CRUSTACEANS
ALLERGEN_TYPE_CODE_EGGS
ALLERGEN_TYPE_CODE_EUGENOL
ALLERGEN_TYPE_CODE_EVERNIA_FURFURACEA
ALLERGEN_TYPE_CODE_EVERNIA_PRUNASTRI
ALLERGEN_TYPE_CODE_FARNESOL
ALLERGEN_TYPE_CODE_FISH
ALLERGEN_TYPE_CODE_GERANIOL
ALLERGEN_TYPE_CODE_GLUTEN
ALLERGEN_TYPE_CODE_HAZELNUTS
ALLERGEN_TYPE_CODE_HEXYL_CINNAMAL
ALLERGEN_TYPE_CODE_HYDROXYCITRONELLAL
ALLERGEN_TYPE_CODE_HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
ALLERGEN_TYPE_CODE_KAMUT
ALLERGEN_TYPE_CODE_LACTOSE
ALLERGEN_TYPE_CODE_LUPINE
ALLERGEN_TYPE_CODE_MACADAMIA_NUTS
ALLERGEN_TYPE_CODE_METHYL_2_OCTYNOATE
ALLERGEN_TYPE_CODE_MILK
ALLERGEN_TYPE_CODE_MOLLUSCS
ALLERGEN_TYPE_CODE_MUSTARD
ALLERGEN_TYPE_CODE_NO_DECLARED_ALLERGENS
ALLERGEN_TYPE_CODE_OAT
ALLERGEN_TYPE_CODE_PEANUTS
ALLERGEN_TYPE_CODE_PEAS
ALLERGEN_TYPE_CODE_PECAN_NUTS
ALLERGEN_TYPE_CODE_PISTACHIOS
ALLERGEN_TYPE_CODE_POD_FRUITS
ALLERGEN_TYPE_CODE_QUEENSLAND_NUTS
ALLERGEN_TYPE_CODE_RYE
ALLERGEN_TYPE_CODE_SESAME_SEEDS
ALLERGEN_TYPE_CODE_SOYBEANS
ALLERGEN_TYPE_CODE_SPELT
ALLERGEN_TYPE_CODE_SULPHUR_DIOXIDE
ALLERGEN_TYPE_CODE_TREE_NUTS
ALLERGEN_TYPE_CODE_TREE_NUT_TRACES
ALLERGEN_TYPE_CODE_WALNUTS
ALLERGEN_TYPE_CODE_WHEAT

DepositCode

ระบุวิธีฝากคืนภาชนะหรือขวดอย่างถูกต้อง

ชื่อคำอธิบาย
DEPOSIT_CODE_UNSPECIFIEDโปรดอย่าใช้ ไม่ได้ระบุรหัสการฝากอย่างชัดเจน
DEPOSIT_CODE_REUSABLE
DEPOSIT_CODE_RECYCLABLE

PropertyType

ประเภทที่พักที่ตัวเลือกนี้ใช้ได้

ชื่อคำอธิบาย
UNKNOWN_PROPERTY_TYPEโปรดอย่าใช้ ไม่ได้ระบุประเภทพร็อพเพอร์ตี้อย่างชัดเจน
OPTIONพร็อพเพอร์ตี้ตัวเลือกรายการเมนูทั่วไป ซึ่งไม่ใช่ประเภทที่เฉพาะเจาะจงกว่าด้านล่าง ใช้ในกรณีที่พร็อพเพอร์ตี้ไม่ได้มีประเภทเป็น SIZE หรือ PIZZA_SIDE
SIZEระบุพร็อพเพอร์ตี้ตัวเลือกของรายการในเมนูที่มีขนาด (เช่น เล็ก กลาง หรือ ใหญ่)
PIZZA_SIDEพร็อพเพอร์ตี้เฉพาะสำหรับพิซซ่า เช่น MenuItemOption นี้ใช้ได้กับพิซซ่าบางส่วน/ทั้งถาดเท่านั้น เช่น ท็อปปิ้งเห็ดที่ด้านซ้าย ด้านขวา หรือทั้งถาด)

PropertyValue

ค่าที่กำหนดไว้อย่างดีสำหรับพร็อพเพอร์ตี้ตัวเลือก

ชื่อคำอธิบาย
UNKNOWN_PROPERTY_VALUEโปรดอย่าใช้ ไม่ได้ระบุค่าพร็อพเพอร์ตี้อย่างชัดเจน
PIZZA_SIDE_LEFTMenuItemOption ใช้ได้กับด้านซ้ายของพิซซ่าเท่านั้น
PIZZA_SIDE_RIGHTMenuItemOption ใช้ได้กับด้านขวาของพิซซ่าเท่านั้น
PIZZA_SIDE_WHOLEMenuItemOption มีผลกับพิซซ่าทั้งถาด

ประเภท

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
menuobject
(Menu)

ใช้ร่วมกับ section, item, option ไม่ได้

sectionobject
(MenuSection)

ใช้ร่วมกับ menu, item, option ไม่ได้

itemobject
(MenuItem)

ใช้ร่วมกับ menu, section, option ไม่ได้

optionobject
(MenuItemOption)

ใช้ร่วมกับ menu, section, item ไม่ได้

ราคา

รายการในเมนูต้องมีราคาหรือชุดตัวเลือกรายการในเมนู ต้องระบุ

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
offer_setobject
(OfferSet)

ใช้ร่วมกับ menu_item_option_set ไม่ได้

ข้อเสนอที่มีให้ซื้ออาหารรายการนี้
menu_item_option_setobject
(MenuItemOptionSet)

ใช้ร่วมกับ offer_set ไม่ได้

ตัวเลือกที่ใช้ได้สำหรับรายการเมนูนี้

value

ต้องระบุ oneof

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
amountตัวเลข

ใช้ร่วมกับ range ไม่ได้

ตัวเลขเดียวที่แสดงปริมาณคุณค่าทางโภชนาการ
rangeobject
(Range)

ใช้ร่วมกับ amount ไม่ได้

ช่วงที่แสดงปริมาณคุณค่าทางโภชนาการ

value

ต้องระบุ

ชื่อช่องประเภทข้อกำหนดคำอธิบาย
property_valenum
(PropertyValue)

ใช้ร่วมกับ text_val ไม่ได้

ค่าที่กำหนดไว้อย่างดีสำหรับพร็อพเพอร์ตี้ตัวเลือก ปัจจุบันคาดว่าจะมีเฉพาะในกรณีที่ property_type เป็น PIZZA_SIDE
text_valobject
(TextField)

ใช้ร่วมกับ property_val ไม่ได้

ข้อความรูปแบบอิสระสำหรับค่าของพร็อพเพอร์ตี้ คาดหวังสำหรับ property_type OPTION และ SIZE