สคีมาพื้นที่โฆษณาที่เกี่ยวข้อง

หน้านี้อธิบายรูปแบบฟีดข้อมูลการสั่งอาหารจากต้นทางถึงปลายทาง (ข้อกำหนดแคตตาล็อกอาหาร) ที่คุณส่งให้ Google หากต้องการข้อมูลที่เครื่องอ่านได้นี้ โปรดดาวน์โหลดสคีมา JSON

ข้อกำหนดทั่วไป

เอนทิตีต้องมีโครงสร้างให้อยู่ใน 1 บรรทัดต่อ 1 เอนทิตีในฟีด (เอนทิตีคั่นด้วยอักขระขึ้นบรรทัดใหม่) ตัวอย่าง JSON ในหน้านี้จะไม่สอดคล้องกับโครงสร้างดังกล่าวเพื่อให้อ่านได้ง่าย อย่างไรก็ตาม คุณต้องทำตามโครงสร้างดังกล่าวเมื่อส่งฟีด ตัวอย่างเช่น เอนทิตีเมนูต้องมีโครงสร้างดังนี้ 

{"@type": "Menu","name": "Coffee Shop A","@id": "1535"}

เอนทิตี "ร้านอาหาร" แต่ละรายการอาจมีเอนทิตีบริการ 2 รายการ (แต่ละรายการสำหรับประเภทบริการ "DELIVERY" และ "TAKEOUT") เอนทิตี "บริการ" แต่ละรายการจะมีเอนทิตี "เมนู" ได้เพียง 1 รายการเท่านั้น

จะนำเอนทิตีย่อยกลับมาใช้ซ้ำในร้านอาหารหลายแห่งได้

หลักเกณฑ์ค่า JSON

ประเภทการบีบบังคับ

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

การบีบบังคับประเภทยังใช้ได้กับพร็อพเพอร์ตี้ที่ซ้ำกันด้วย พร็อพเพอร์ตี้ที่ซ้ำกันจะยอมรับค่าเป็นอินพุตได้โดยไม่ต้องอยู่ในวงเล็บ [] เช่น พร็อพเพอร์ตี้ OperationHours.serviceId ยอมรับทั้ง "service_id" และ ["service_id"] เป็นอินพุตที่ถูกต้อง

ค่า DateTime และเวลา

DateTime อิงตามประเภท schema.org และต้องเป็นไปตามรูปแบบ ISO 8601 รวมถึงวันที่ เวลา และเขตเวลา เว้นแต่จะระบุไว้เป็นอย่างอื่น ใช้ไวยากรณ์ต่อไปนี้สำหรับ DateTime

// DateTime format:
YYYY-MM-DDTHH:MM:SS[∓HH:MM|Z]

เช่น

2017-05-01T06:30:00-07:00 // UTC minus 7 hours
2017-05-01T06:30:00Z  // UTC time zone. The optional "Z" suffix represents the UTC time zone.

Time เป็นเวลาท้องถิ่นของเขตเวลาของร้านอาหารหรือสถานที่ให้บริการ ก็ขึ้นอยู่กับประเภทของ schema.org และต้องเป็นไปตามรูปแบบ ISO 8601 ด้วย เวลาใช้ไวยากรณ์ต่อไปนี้

// Time format:
THH:MM:SS

เช่น

T08:08:00 // 8:08 AM

สิ่งที่ควรทราบเมื่อใดก็ตามที่ระบุ DateTime หรือ Time

  • ต้องใส่คำนำหน้า "T" ก่อนเวลา
  • ต้องระบุเขตเวลาสำหรับ DATETIME ซึ่งไม่จำเป็นสำหรับ TIME
  • ต้องระบุเวลาเป็นเวลาท้องถิ่นของร้านอาหารหรือบริการ

ข้อมูลร้านอาหาร

ร้านอาหาร (ต้องระบุ)

เอนทิตีที่จำเป็นเพื่อติดตั้งใช้งาน อธิบายร้านอาหาร

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Restaurant

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Restaurant
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของร้านอาหารหรือผู้ให้บริการจัดส่ง

เช่น restaurant_1
name String

ต้องระบุ

ชื่อร้านอาหาร

เช่น Foo
description String

คำอธิบายของร้านอาหาร

เช่น Best seafood in town
url URL

URL ที่แสดงถึงร้านอาหาร ระบบจะเลือกใช้โดเมนร้านอาหารมากกว่าโดเมนผู้รวบรวมข้อมูล

เช่น http://www.provider.com/somerestaurant
sameAs URL

เว็บไซต์อย่างเป็นทางการของร้านอาหาร

เช่น http://www.provider2.com/somerestaurant
telephone String

หมายเลขโทรศัพท์ของร้านอาหาร

เช่น +12345665898
streetAddress String

ต้องระบุ

ที่อยู่ของร้านอาหาร

เช่น 12345 Bar Avenu
addressLocality String

ต้องระบุ

ย่านหรือเมือง

เช่น San Francisco
addressRegion String

ต้องระบุ

ภูมิภาคหรือรัฐ

เช่น CA
postalCode String

ต้องระบุ

รหัสไปรษณีย์

เช่น 94124
addressCountry String

ต้องระบุ

รหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO 3166-1 alpha-2

เช่น US
latitude Number

ละติจูดเป็นองศา ค่าต่างๆ จะถูกจำกัดไว้ที่ช่วง [[-90, 90]] ควรใช้ทศนิยมอย่างน้อย 5 ตำแหน่งเพื่อความแม่นยำ

เช่น 35.7392607
longitude Number

ลองจิจูดเป็นองศา ค่าต่างๆ จะถูกจำกัดไว้ที่ช่วง [[-180, 180]] ควรใช้ทศนิยมอย่างน้อย 5 ตำแหน่งเพื่อความแม่นยำ

เช่น -120.3895522
dealId List<String>

Deal ที่เกี่ยวข้องจากร้านอาหาร
imprint String

สำนักพิมพ์ร้านอาหารคือส่วนหนึ่งของข้อมูลเพิ่มเติมเกี่ยวกับร้านอาหาร เช่น ชื่อตามกฎหมาย ที่อยู่ตามกฎหมาย และหมายเลขจดทะเบียน ข้อมูลนี้สามารถจัดรูปแบบโดยใช้ " "

เช่น 

Three Brothers Tacos
123 FooSt
Mountain View
CA 94041, United States
email: contact@threebrotherstacos.com

Commercial Register: 123456789
economicOperator String

ข้อมูลผู้ดำเนินการด้านเศรษฐกิจที่เกี่ยวข้องกับร้านอาหาร (หากมี) ข้อมูลนี้จะแสดงในส่วน "ข้อมูลผู้ค้า" คุณจัดรูปแบบข้อความได้โดยใช้ " "

เช่น 

XYZ Corp
123 Main Street
555-555-5555
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีร้านอาหารในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Restaurant

ตัวอย่าง

{
  "@type": "Restaurant",
  "@id": "10824",
  "name": "Pronto Wood Fired Pizzeria",
  "url": "https://www.provider.com/pronto-wood-fired-pizzeria",
  "telephone": "+16503659978",
  "streetAddress": "2560 El Camino Real",
  "addressLocality": "Palo Alto",
  "addressRegion": "CA",
  "postalCode": "94061",
  "addressCountry": "US",
  "latitude": 37.472842,
  "longitude": -122.217144
}

ดีล

ประเภทส่วนลดที่ใช้กับรถเข็นได้

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Deal

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Deal
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของดีล

เช่น FREEDELIVERY
dealCode String

ต้องระบุ

รหัสดีลที่ไม่ซ้ำกันต่อดีลต่อพาร์ทเนอร์ รหัสนี้ต้องระบุดีลในระบบโปรโมชันโดยไม่ซ้ำกัน Google จะส่งตัวระบุนี้ให้คุณในช่อง promotions.coupon ของ CheckoutRequest เพื่อตรวจสอบ

เช่น ADETRE23
applicableServiceType รายการ<ServiceType>

บริการที่ดีลนี้มีผลบังคับใช้ ค่าเริ่มต้นจะถือว่าดีลที่ใช้ได้ทั้งหมด
eligibleMaxOrders จำนวนเต็ม

ดีลนี้จะมีสิทธิ์เฉพาะเมื่อผู้ใช้มีคำสั่งซื้อที่สำเร็จที่ผ่านมาน้อยกว่าหรือเท่ากับจำนวนนี้
availabilityId List<String>

ค่า @id ของเอนทิตีความพร้อมจำหน่ายสินค้า ซึ่งจะให้รายละเอียดเกี่ยวกับช่วงเวลาที่ส่วนเมนูจะพร้อมใช้งาน

เช่น [ "availability_1" ]
isDisabled บูลีน

การดำเนินการนี้จะลบล้างการตรวจสอบความถูกต้องอื่นๆ
dealType DealType

ต้องระบุ

หมวดหมู่ของดีลที่จะใช้ส่วนลด โดยหมวดหมู่อาจเป็นราคารวมของรถเข็น ค่าบริการ หรือค่าธรรมเนียมการนำส่ง
priceCurrency String

ต้องระบุเมื่อ discount is defined

ต้องระบุเมื่อ eligibleTransactionVolumeMin is defined

สกุลเงินของส่วนลด (ในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว)

เช่น USD
eligibleTransactionVolumeMin Number

ปริมาณธุรกรรมเป็นหน่วยเงินซึ่งใช้โปรโมชันนี้ได้
termsOfServiceUrl URL

ต้องระบุ

เอกสารข้อกำหนดในการให้บริการที่มนุษย์อ่านได้
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีของดีลในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00
ต้องมีกลุ่มพร็อพเพอร์ตี้กลุ่มใดกลุ่มหนึ่งต่อไปนี้
discount กลุ่ม 1 Number

มูลค่าของส่วนลดเป็นตัวเลข
discountPercentage กลุ่ม 2 Number

มูลค่าของส่วนลดเป็นเปอร์เซ็นต์ของราคาเดิม

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Deal

ตัวอย่างที่ 1

{
  "@type": "Deal",
  "@id": "ONEDOLLARFEE",
  "dealCode": "THREEDOLLARFEE",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_may2020"
  ],
  "termsOfServiceUrl": "http://www.provider.com/onedollardeal",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "discount": 3,
  "priceCurrency": "USD"
}

ตัวอย่างที่ 2

{
  "@type": "Deal",
  "@id": "10PERCOFF",
  "dealCode": "10PERCOFF",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_weekdays_evening"
  ],
  "termsOfServiceUrl": "http://www.provider.com/deal",
  "discountPercentage": 10,
  "priceCurrency": "USD"
}

ตัวอย่าง 3

{
  "@type": "Deal",
  "@id": "FREEDELIVERY",
  "dealCode": "FREEDELIVERY",
  "dealType": "DELIVERY_OFF",
  "availabilityId": [
    "availability_may"
  ],
  "applicableServiceType": [
    "DELIVERY"
  ],
  "termsOfServiceUrl": "http://www.provider.com/free_delivery_deal",
  "discountPercentage": 100,
  "eligibleTransactionVolumeMin": 25,
  "priceCurrency": "USD"
}

ข้อมูลบริการ

บริการ (ต้องระบุ)

อธิบายรายละเอียดบริการสั่งอาหารสำหรับร้านอาหาร Service เป็นเอนทิตีที่จำเป็นต้องใช้งาน

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Service

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Service
@id String

ต้องระบุ

ตัวระบุสำหรับบริการดำเนินการตามคำสั่งซื้อ

เช่น service_1
serviceType ServiceType

ต้องระบุ

ประเภทของบริการที่นำเสนอ ค่าที่เป็นไปได้คือ "DELIVERY" หรือ "TAKEOUT"

เช่น DELIVERY
restaurantId String

ต้องระบุ

ค่า @id ของเอนทิตีร้านอาหารที่สัมพันธ์กับเอนทิตีบริการนี้

เช่น restaurant_1
menuId String

ต้องระบุ

ค่า @id ของเอนทิตีเมนูที่สัมพันธ์กับเอนทิตีบริการนี้

เช่น menu_1
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีบริการในรูปแบบการประทับเวลา ISO

เช่น 2017-01-02T00:00:00-07:00
isDisabled บูลีน

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

เช่น true
servingConfig ServingConfig

การกำหนดค่าการแสดงผลสำหรับบริการที่ใช้ควบคุมฟีเจอร์ต่างๆ เช่น การปิดใช้วิดเจ็ตโปรโมชัน ฯลฯ
actionLinkUrl String

มี URL สำหรับบริการส่ง/สั่งกลับบ้านที่จะใช้ขณะย้ายข้อมูลจากการสั่งอาหารตั้งแต่ต้นจนจบเพื่อเปลี่ยนเส้นทาง

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Service

ตัวอย่างที่ 1

{
  "@type": "Service",
  "@id": "10824/takeout",
  "serviceType": "TAKEOUT",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderpickup/merchant_foepa_3"
}

ตัวอย่างที่ 2

{
  "@type": "Service",
  "@id": "10824/delivery",
  "serviceType": "DELIVERY",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderdelivery/merchant_foepa_3"
}

ServiceArea

อธิบายภูมิภาคทางภูมิศาสตร์ที่สามารถส่งอาหารได้ เอนทิตีนี้จำเป็นต้องใช้หากเอนทิตี Service ที่เกี่ยวข้องตั้งค่า serviceType เป็น "DELIVERY"

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท ServiceArea

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: ServiceArea
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของพื้นที่ให้บริการ

เช่น service_area_1
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่สัมพันธ์กับเอนทิตี ServiceArea นี้

เช่น [ "service_1" ]
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี ServiceArea ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00
exclude บูลีน

ยกเว้นพื้นที่ให้บริการนี้จากภูมิภาคที่มีการนำส่งทั้งหมด ตัวอย่างเช่น รหัสไปรษณีย์อาจได้รับการยกเว้นจากพื้นที่รูปหลายเหลี่ยมที่ใหญ่กว่า
ต้องมีกลุ่มพร็อพเพอร์ตี้กลุ่มใดกลุ่มหนึ่งต่อไปนี้
polygon กลุ่ม 1 List<String>

รูปหลายเหลี่ยมหรือรูปหลายเหลี่ยมหลายรูปซึ่งแสดงชุดจุดคั่นด้วยช่องว่างอย่างน้อย 3 จุด ขอแนะนำให้จุดแรกและประเด็นสุดท้ายเหมือนกัน แต่ไม่บังคับ แต่ละจุดในรูปหลายเหลี่ยมหรือรูปหลายเหลี่ยมหลายรูปจะกำหนดด้วยจุดละติจูดตามด้วยจุดลองจิจูด และต้องระบุจุดในทิศทางทวนเข็มนาฬิกาด้วย

เช่น [ "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747" ]
geoMidpointLatitude กลุ่ม 2 Number

ระบุพิกัดละติจูดที่ศูนย์กลางของพื้นที่ CIRCLE

เช่น 37.806000
geoMidpointLongitude กลุ่ม 2 Number

ระบุพิกัดลองจิจูดที่ศูนย์กลางของพื้นที่ CIRCLE

เช่น -122.425592
geoRadius กลุ่ม 2 จำนวนเต็ม

แสดงรัศมีโดยประมาณ (เป็นเมตร) ของพื้นที่ CIRCLE

เช่น 10000
postalCode กลุ่ม 3 String

ระบุรหัสไปรษณีย์

เช่น 91234
addressCountry กลุ่ม 3 String

ระบุรหัสประเทศแบบ 2 ตัวอักษรตามมาตรฐาน ISO 3166-1 alpha-2

เช่น US

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ ServiceArea

ตัวอย่าง

{
  "@type": "ServiceArea",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "polygon": [
    "37.4818562 -122.25801303 37.48247836 -122.25801303 37.48434484 -122.25621319 37.48621133 -122.25424681 37.49181077 -122.24704744 37.49305509 -122.24541414 37.49429942 -122.2436143 37.49803238 -122.23821477 37.49803238 -122.21285044 37.49367726 -122.15885517 37.49056645 -122.15722187 37.48621133 -122.15542202 37.48558917 -122.15525548 37.4818562 -122.15525548 37.43191387 -122.17865343 37.43191387 -122.23444854"
  ]
}

เวลาทําการ (ต้องระบุ)

อธิบายกรอบเวลาการสั่งซื้อที่ผู้ใช้เข้าถึงขั้นตอนและทำการสั่งซื้อโดยเร็วที่สุดหรือในอนาคตได้ คุณจำเป็นต้องใช้ OperationHours โดยมีค่าเริ่มต้นเป็นแสดงเวลาทำการทุกวัน

แอตทริบิวต์ OperationHours opens และ closes ระบุเวลาเปิดและปิดของระบบออนไลน์ที่อนุญาตให้ผู้ใช้สั่งซื้อสินค้า ภายในช่วงเวลาของระบบออนไลน์ ให้ใช้ ServiceHours เพื่อระบุเวลาเปิดและปิดที่จะดำเนินการตามคำสั่งซื้อของผู้ใช้ได้

ต้องระบุเวลาให้บริการเป็นเวลาท้องถิ่น อย่ารวมเขตเวลาไว้ในค่า opens หากมีการระบุเขตเวลา Google จะไม่สนใจข้อมูลนี้ ดูข้อมูลเพิ่มเติมได้ที่รูปแบบวันที่และเวลา

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท OperationHours

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: OperationHours
@id String

ต้องระบุ

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

เช่น operation_hour_1
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่สัมพันธ์กับเอนทิตี OperatingHours นี้

เช่น [ "service_1" ]
opens เวลา ISO (ท้องถิ่น)

ระบุเวลาที่เฉพาะเจาะจงของวันในรูปแบบ ISO โดยเริ่มจากจุดที่ผู้ใช้ทำการสั่งซื้อได้

เช่น T00:00
closes เวลา ISO (ท้องถิ่น)

ระบุเวลาที่เฉพาะเจาะจงของวันในรูปแบบ ISO ซึ่งไม่สามารถสั่งซื้อได้

เช่น T16:00
dayOfWeek รายการ<DayOfWeek>

รายการวันของสัปดาห์ที่เวลาทำการเหล่านี้ถูกต้อง ค่าที่ยอมรับได้ ได้แก่ "วันจันทร์" "อังคาร" "วันพุธ" "วันพฤหัสบดี" "วันศุกร์" "วันเสาร์" และ "วันอาทิตย์"

เช่น [ "MONDAY", "TUESDAY" ]
validFrom การประทับเวลา ISO

ต้องระบุเมื่อ isSpecialHour = true

การประทับเวลา ISO ระบุเวลาเริ่มต้นของหน้าต่างการสั่งซื้อซึ่งผู้ใช้สามารถเข้าถึงขั้นตอนการสั่งซื้อและสั่งซื้อโดยเร็วที่สุด/ในอนาคต

เช่น 2017-01-01T00:00:00-07:00
validThrough การประทับเวลา ISO

ต้องระบุเมื่อ isSpecialHour = true

การประทับเวลา ISO ระบุเวลาสิ้นสุดของกรอบเวลาการสั่งซื้อ ทำให้ผู้ใช้ไม่สามารถเข้าถึงขั้นตอนและสั่งซื้อโดยเร็วที่สุด/ในอนาคต

เช่น 2017-01-02T00:00:00-07:00
isSpecialHour บูลีน

บูลีนที่ระบุว่า OperatingHours ใช้สำหรับเวลาทำการพิเศษหรือไม่ ค่าที่ยอมรับได้คือ "false" และ "true"

เช่น False
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี OperatingHours ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ OperationHours

ตัวอย่างที่ 1

{
  "@type": "OperationHours",
  "@id": "10824/deliveryOh",
  "serviceId": [
    "10824/delivery"
  ],
  "isSpecialHour": false
}

ตัวอย่างที่ 2

{
  "@type": "OperationHours",
  "@id": "10824/takeoutOh",
  "serviceId": [
    "10824/takeout"
  ],
  "isSpecialHour": false
}

เวลาให้บริการ (ต้องระบุ)

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

แอตทริบิวต์ OperationHours opens และ closes ระบุเวลาเปิดและปิดของระบบออนไลน์ที่อนุญาตให้ผู้ใช้สั่งซื้อสินค้า ภายในช่วงเวลาของระบบออนไลน์ ให้ใช้ ServiceHours เพื่อระบุเวลาเปิดและปิดที่จะดำเนินการตามคำสั่งซื้อของผู้ใช้ได้

ต้องระบุเวลาให้บริการเป็นเวลาท้องถิ่น อย่ารวมเขตเวลาไว้ในค่า opens หากมีการระบุเขตเวลา Google จะไม่สนใจข้อมูลนี้ ดูข้อมูลเพิ่มเติมได้ที่รูปแบบวันที่และเวลา

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท ServiceHours

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: ServiceHours
@id String

ต้องระบุ

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

เช่น service_hour_1
orderType OrderType

ต้องระบุ

สตริงที่ระบุว่าช่วงเวลาให้บริการมีผลกับคำสั่งซื้อ "โดยเร็วที่สุด" หรือ "ขั้นสูง" ค่าที่ยอมรับได้คือ "ASAP" และ "ADVANCE"

เช่น ASAP
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่สัมพันธ์กับเอนทิตี ServiceHours นี้

เช่น [ "service_1" ]
operationHoursId List<String>

ต้องระบุเมื่อ isSpecialHour = false

ค่า @id ของเอนทิตี OperatingHours ที่สัมพันธ์กับเอนทิตี ServiceHours นี้

เช่น [ "operation_hour_1" ]
opens เวลา ISO (ท้องถิ่น)

ระบุเวลาที่เจาะจงของวันในรูปแบบ ISO ซึ่งเริ่มจากเวลาที่ผู้ใช้ดำเนินการตามคำสั่งซื้อได้

เช่น T00:00
closes เวลา ISO (ท้องถิ่น)

ระบุเวลาที่เฉพาะเจาะจงของวันในรูปแบบ ISO ซึ่งไม่สามารถดำเนินการตามคำสั่งซื้อของผู้ใช้ได้

เช่น T16:00
dayOfWeek รายการ<DayOfWeek>

รายการวันของสัปดาห์ที่เวลาทำการเหล่านี้ถูกต้อง

เช่น [ "MONDAY", "TUESDAY" ]
validFrom การประทับเวลา ISO

ต้องระบุเมื่อ isSpecialHour = true

การประทับเวลา ISO ระบุเวลาเริ่มต้นของหน้าต่างการสั่งซื้อซึ่งผู้ใช้สามารถเข้าถึงขั้นตอนการสั่งซื้อและสั่งซื้อโดยเร็วที่สุด/ในอนาคต

เช่น 2017-01-01T00:00:00-07:00
validThrough การประทับเวลา ISO

ต้องระบุเมื่อ isSpecialHour = true

การประทับเวลา ISO ระบุเวลาสิ้นสุดของกรอบเวลาการสั่งซื้อ ทำให้ผู้ใช้ไม่สามารถเข้าถึงขั้นตอนและสั่งซื้อโดยเร็วที่สุด/ในอนาคต

เช่น 2017-01-02T00:00:00-07:00
isSpecialHour บูลีน

บูลีนที่ระบุว่า OperatingHours ใช้สำหรับเวลาทำการพิเศษหรือไม่ ค่าที่ยอมรับได้คือ "false" และ "true"

เช่น False
leadTimeMin จำนวนเต็ม

เวลานำส่ง/รับสินค้าโดยประมาณขั้นต่ำเป็นนาที หลังจากสั่งซื้อโดยเร็วที่สุด เราแนะนําอย่างยิ่งให้คุณตั้งค่าพร็อพเพอร์ตี้นี้

เช่น 60
leadTimeMax จำนวนเต็ม

เวลานำส่ง/รับสินค้าโดยประมาณสูงสุดในหน่วยนาทีหลังจากสั่งซื้อโดยเร็วที่สุด เราแนะนําอย่างยิ่งให้คุณตั้งค่าพร็อพเพอร์ตี้นี้

เช่น 70
advanceBookingRequirementMin จำนวนเต็ม

ต้องระบุเมื่อ orderType = "ADVANCE"

จำนวนนาทีขั้นต่ำนับตั้งแต่เวลาสั่งซื้อที่จะใช้ดำเนินการตามคำสั่งซื้อล่วงหน้าได้ เช่น หากต้องดําเนินการตามคําสั่งซื้อล่วงหน้าอย่างน้อย 60 นาที แล้ว AdvancedBookingrequiredmentMin จะเท่ากับ 60

เช่น 15
advanceBookingRequirementMax จำนวนเต็ม

ต้องระบุเมื่อ orderType = "ADVANCE"

จำนวนนาทีสูงสุดจากเวลาสั่งซื้อที่ใช้ดำเนินการตามคำสั่งซื้อล่วงหน้าได้ เช่น หากคำสั่งซื้อล่วงหน้าถูกจำกัดไม่ให้ดำเนินการเกิน 2 วันต่อมา ค่า AdvancedBookingrequiredmentMax จะเป็น 2880

เช่น 10080
advanceBookingSlotInterval String

ต้องระบุเมื่อ orderType = "ADVANCE"

ช่วงเวลาระหว่างเวลาของช่องการจองล่วงหน้า 2 ครั้งติดต่อกัน เช่น หากเวลาเปิดและปิดคือ 8:00 น. และ 20:00 น. และ BookingSlotInterval ล่วงหน้าคือ 15 นาที ผู้ใช้จะเลือกเวลาดำเนินการตามคำสั่งซื้อเป็น 8:00, 8:15 น., 8:30 น., 8:45 น. และเวลาต่อๆ ไปได้จนถึง 20:45 น. ต้องระบุระยะเวลาเป็นระยะเวลาของ ISO เช่น "PT15M" หมายถึงช่วงเวลา 15 นาที

เช่น PT15M
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี ServiceHours ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ ServiceHours

ตัวอย่างที่ 1

{
  "@type": "ServiceHours",
  "@id": "613741/delivery",
  "orderType": "ASAP",
  "serviceId": [
    "10824/delivery"
  ],
  "opens": "T00:00",
  "closes": "T00:00",
  "isSpecialHour": true,
  "validFrom": "2017-12-25T00:00:00-07:00",
  "validThrough": "2017-12-25T23:59:00-07:00"
}

ตัวอย่างที่ 2

{
  "@type": "ServiceHours",
  "@id": "10824/takeoutSh_0",
  "orderType": "ASAP",
  "serviceId": [
    "10824/takeout"
  ],
  "operationHoursId": [
    "10824/takeoutOh"
  ],
  "opens": "11:00",
  "closes": "21:00",
  "dayOfWeek": [
    "MONDAY",
    "TUESDAY",
    "WEDNESDAY",
    "THURSDAY"
  ],
  "isSpecialHour": false
}

ค่าธรรมเนียม

อธิบายค่าธรรมเนียม หากเอนทิตี Service ที่เชื่อมโยง serviceType มีการตั้งค่าเป็น "DELIVERY" จะต้องกำหนด Fee ที่มี feeType เป็น "DELIVERY"

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Fee

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Fee
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของนิติบุคคลที่อธิบายค่าธรรมเนียม

เช่น service_fee_1
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่สัมพันธ์กับเอนทิตีค่าธรรมเนียมนี้

เช่น [ "service_1" ]
feeType FeeType

ต้องระบุ

สตริงที่ระบุว่ามีค่าธรรมเนียมกับคำสั่งซื้อแบบจัดส่งหรือให้บริการหรือไม่ ค่าที่ยอมรับได้คือ "DELIVERY" และ "SERVICE"

เช่น DELIVERY
priceCurrency String

ต้องระบุ

รหัสสกุลเงินแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว

เช่น USD
basePrice Number

ราคาฐานของค่าธรรมเนียม ซึ่งจะมีผลเมื่อใช้ percentageOfCart หรือ pricePerMeter

เช่น 2.0
minPrice Number

ค่าธรรมเนียมขั้นต่ำ มูลค่าสูงสุดเมื่อใช้ percentageOfCart หรือ pricePerMeter

เช่น 2.0
maxPrice Number

ค่าธรรมเนียมสูงสุด ค่าธรรมเนียมสูงสุดเมื่อใช้ percentageOfCart หรือ pricePerMeter

เช่น 10.0
eligibleRegion List<String>

@id ของ ServiceArea สำหรับภูมิภาคทางภูมิศาสตร์และการเมืองที่มีค่าธรรมเนียม ใช้พร็อพเพอร์ตี้นี้เมื่อค่าธรรมเนียมการนำส่งแตกต่างกันไปตามภูมิภาคเท่านั้น

เช่น [ "service_area_1" ]
eligibleTransactionVolumeMin Number

ปริมาณธุรกรรมขั้นต่ำในหน่วยเงินซึ่งข้อกำหนดค่าธรรมเนียมนี้ถูกต้อง

เช่น 50
eligibleTransactionVolumeMax Number

ปริมาณธุรกรรมสูงสุดเป็นหน่วยเงินซึ่งระบุถึงข้อกำหนดค่าธรรมเนียมนี้ เช่น ระบบจะไม่เรียกเก็บค่าธรรมเนียมหากมียอดคำสั่งซื้อมากกว่าที่กำหนด

เช่น 10
validFrom การประทับเวลา ISO

การประทับเวลา ISO ที่ระบุเวลาเริ่มต้นเมื่อค่าธรรมเนียมมีผล

เช่น 2017-01-01T00:00:00-07:00
validThrough การประทับเวลา ISO

การประทับเวลา ISO ระบุเวลาสิ้นสุดที่ค่าธรรมเนียมไม่ถูกต้อง

เช่น 2017-01-02T00:00:00-07:00
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีค่าธรรมเนียมในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00
priority Number

ค่าบวกที่ไม่ใช่ 0 เมื่อมีค่าธรรมเนียมมากกว่า 1 รายการในรถเข็นของผู้ใช้ ค่าธรรมเนียมที่มีลำดับความสำคัญสูงสุดจะมีความสำคัญมากกว่าค่าธรรมเนียมที่ต่ำกว่า หากมีช่องนี้ ลำดับความสำคัญจะมีลำดับความสำคัญเหนือกว่าลำดับความสำคัญที่คำนวณแล้วเสมอ

เช่น 3
ต้องมีกลุ่มพร็อพเพอร์ตี้กลุ่มใดกลุ่มหนึ่งต่อไปนี้
price กลุ่ม 1 Number

ราคาค่าธรรมเนียม หากราคาไม่คงที่ สามารถระบุ minPrice และ maxPrice แทนราคาได้

เช่น 1.5
percentageOfCart กลุ่ม 2 Number

ค่าธรรมเนียมเป็นเปอร์เซ็นต์ของมูลค่าในรถเข็น ค่าที่ยอมรับได้คือค่าทศนิยมที่อยู่ระหว่าง 0 ถึง 100

เช่น 9.00
pricePerMeter กลุ่ม 3 Number

ค่าธรรมเนียมต่อเมตรสำหรับระยะทางรัศมีจากผู้ใช้ เช่น หากระยะทางไปถึงผู้ใช้คือ 5 กม. และราคาเท่ากับ $0.001 ค่าบริการของผู้ใช้จะเท่ากับ $5

เช่น 0.001

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Fee

ตัวอย่างที่ 1

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "price": 5
}

ตัวอย่างที่ 2

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4
}

ตัวอย่าง 3

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

ตัวอย่าง 4

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4
}

ตัวอย่างที่ 5

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

เอนทิตีที่จำเป็นเพื่อติดตั้งใช้งาน อธิบายเมนู

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Menu

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Menu
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของเมนู

เช่น menu_1
name String

ข้อความที่สามารถระบุเมนูได้เมื่อผู้ใช้เรียกดูเมนู

เช่น Foo
disclaimer String

ข้อจำกัดความรับผิดสำหรับเมนู เช่น การเปิดเผยข้อมูลโภชนาการและการเปิดเผยข้อมูลเกี่ยวกับสารก่อภูมิแพ้

เช่น Items may contain peanuts.
disclaimerUrl URL

URL ที่ชี้ไปยังหน้าที่ให้รายละเอียดเพิ่มเติมเกี่ยวกับข้อจำกัดความรับผิด
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีเมนูในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Menu

{
  "@type": "Menu",
  "@id": "10824"
}

เอนทิตีที่ไม่บังคับที่จะนำมาใช้งาน อธิบายส่วนใดส่วนหนึ่งในเมนู

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท MenuSection

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: MenuSection
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของส่วนเมนู

เช่น menu_section_1
menuId รายการ<ReverseReference>

ค่า @id ของเอนทิตีเมนูที่สัมพันธ์กับเอนทิตี MenuSection นี้

เช่น [ { "@id": "menu_id", "displayOrder": 4 } ]
menuSectionId List<String>

รายการค่า @id ของเอนทิตี MenuSection ย่อยที่สอดคล้องกับเอนทิตี MenuSection นี้

สำคัญ: คุณต้องใช้การอ้างอิง menuSectionId หรือ parentMenuSectionId(in child) เท่านั้น

เช่น [ "child_menu_section_1", "child_menu_section_2" ]
parentMenuSectionId รายการ<ReverseReference>

ค่า @id ของเอนทิตี MenuSection หลักที่สัมพันธ์กับเอนทิตี MenuSection นี้

สำคัญ: คุณต้องใช้การอ้างอิง parentMenuSectionId หรือ menuSectionId(in parent) เท่านั้น

เช่น [ { "@id": "parent_menu_section_id", "displayOrder": 4 } ]
name String

ต้องระบุ

ข้อความที่ระบุ MenuSection เมื่อผู้ใช้เรียกดูเมนู

เช่น Foo
description String

คำอธิบายของส่วนเมนู

เช่น Example menu section description that helps users.
image URL

URL รูปภาพของส่วนเมนู

เช่น https://provider.com/someimage
menuItemId List<String>

รายการค่า @id ของเอนทิตี MenuItem ที่สอดคล้องกับเอนทิตี MenuSection นี้

สำคัญ: คุณต้องใช้การอ้างอิง menuItemId หรือ MenuItem.parentMenuSectionId เท่านั้น

เช่น [ "menu_item1", "menu_item2" ]
parentMenuItemId รายการ<ReverseReference>

รายการค่า @id ของเอนทิตี MenuItem หลักที่สอดคล้องกับเอนทิตี MenuSection นี้

สำคัญ: คุณต้องใช้การอ้างอิง parentMenuItemId หรือ MenuItem.menuAddOnId เท่านั้น

เช่น [ { "@id": "parent_menu_item_id", "displayOrder": 4 } ]
parentMenuItemOptionId รายการ<ReverseReference>

รายการค่า @id ของเอนทิตี MenuItemOption หลักที่สอดคล้องกับเอนทิตี MenuSection นี้

สำคัญ: คุณต้องใช้การอ้างอิง parentMenuItemOptionId หรือ MenuItemOption.menuAddOnId เท่านั้น

เช่น [ { "@id": "parent_menu_item_option_id", "displayOrder": 4 } ]
eligibleQuantityMax จำนวนเต็ม

จำนวนส่วนเสริมสูงสุดที่เลือกได้ในส่วนส่วนเสริม

เช่น 5
eligibleQuantityMin จำนวนเต็ม

จำนวนส่วนเสริมขั้นต่ำที่ควรเลือกในส่วนส่วนเสริม

เช่น 1
defaultItemId List<String>

รายการ @id ที่อ้างอิงถึงเอนทิตี MenuItem รายการ ซึ่งจะเลือกไว้ล่วงหน้าโดยค่าเริ่มต้นสำหรับผู้ใช้ในส่วนเสริม MenuSection ผู้ใช้เปลี่ยนแปลงการเลือกสุดท้ายได้ หากไม่ได้ระบุ defaultItemId จะไม่มีการเลือก MenuItem ไว้ล่วงหน้า

เช่น [ "item1", "item2" ]
availabilityId List<String>

ค่า @id ของเอนทิตีความพร้อมจำหน่ายสินค้า ซึ่งจะให้รายละเอียดเกี่ยวกับช่วงเวลาที่ส่วนเมนูจะพร้อมใช้งาน

เช่น [ "menu_availability_1" ]
numberOfFreeAddOns จำนวนเต็ม

ระบุจำนวนส่วนเสริมที่ผู้ใช้เลือกได้โดยไม่มีค่าใช้จ่าย ใช้ได้กับส่วนเมนูส่วนเสริมเท่านั้น

เช่น 3
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี MenuSection ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00
applicableServiceType รายการ<ServiceType>

บริการที่ MenuSection นี้ใช้ได้ ค่าเริ่มต้นคือ MenuSection ที่ใช้ได้กับทั้งหมด
offeredById List<String>

ค่า @id ของเอนทิตี Restaurant รายการซึ่งมี MenuSection นี้ ค่าเริ่มต้นจะถือว่า MenuSection พร้อมจำหน่ายในทุกสถานที่

เช่น [ "restaurant_id_1", "restaurant_id_55" ]

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ MenuSection

{
  "@type": "MenuSection",
  "@id": "853705",
  "menuId": [
    {
      "@id": "10824",
      "displayOrder": 853705
    }
  ],
  "menuSectionId": [
    12345,
    43645
  ],
  "name": "Pasta",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "offeredById": [
    "italian_restaurant_location_1"
  ]
}
{
  "@type": "MenuSection",
  "@id": "427484",
  "menuId": [
    {
      "@id": "4287",
      "displayOrder": 964376
    }
  ],
  "menuItemId": [
    46784,
    42728
  ],
  "name": "Burger",
  "applicableServiceType": [
    "TAKEOUT",
    "DELIVERY"
  ]
}
{
  "@type": "MenuSection",
  "@id": "3138486",
  "name": "Choose a side:",
  "parentMenuItemId": [
    {
      "@id": "6680295",
      "displayOrder": 3138486
    }
  ],
  "eligibleQuantityMax": "5",
  "numberOfFreeAddOns": "2"
}
{
  "@type": "MenuSection",
  "@id": "3138482",
  "name": "Additional Pizza Toppings",
  "parentMenuItemId": [
    {
      "@id": "6680246",
      "displayOrder": 3138482
    }
  ],
  "eligibleQuantityMax": "3"
}

ความพร้อมใช้งาน

เอนทิตีที่ไม่บังคับที่จะนำมาใช้งาน อธิบายระยะเวลาที่ระบบแสดงเอนทิตี MenuSection

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Availability

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: Availability
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำของเอนทิตีที่อธิบายความพร้อมใช้งานของส่วนเมนู

เช่น menu_section_avail_1
availabilityStarts เวลา ISO (ท้องถิ่น)

การประทับเวลา ISO ที่ระบุเวลาเริ่มต้นที่ความพร้อมให้บริการของส่วนเมนูถูกต้อง

เช่น T00:00
availabilityEnds เวลา ISO (ท้องถิ่น)

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

เช่น T16:00
availableDay รายการ<DayOfWeek>

รายการวันของสัปดาห์ที่ใช้งานได้ในส่วนเมนู

เช่น [ "MONDAY", "TUESDAY" ]
validFrom การประทับเวลา ISO

การประทับเวลา ISO ซึ่งระบุเวลาเริ่มต้นที่ความพร้อมให้บริการของส่วนเมนูถูกต้อง

เช่น 2017-01-01T00:00:00-07:00
validThrough การประทับเวลา ISO

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

เช่น 2017-01-02T00:00:00-07:00
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตีความพร้อมจำหน่ายสินค้าในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Availability

ตัวอย่าง

{
  "@type": "Availability",
  "@id": "85343705",
  "availabilityStarts": "06:00",
  "availabilityEnds": "22:30",
  "availableDay": [
    "SATURDAY",
    "SUNDAY"
  ]
}

เอนทิตีที่จำเป็นเพื่อติดตั้งใช้งาน อธิบายรายการในเอนทิตี Menu

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท MenuItem

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: MenuItem
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของรายการในเมนู

เช่น menu_item_1
name String

ต้องระบุ

ข้อความที่ระบุ MenuItem เมื่อผู้ใช้เรียกดูเมนู

เช่น Foo
description String

คำอธิบายของรายการในเมนู

เช่น Foo
image URL

URL ของรูปภาพของรายการในเมนู

เช่น http://someprovider.com/someimage
parentMenuSectionId รายการ<ReverseReference>

รายการค่า @id ของเอนทิตี MenuSection หลักที่สอดคล้องกับเอนทิตี MenuItem นี้

สำคัญ: คุณต้องใช้การอ้างอิง parentMenuSectionId หรือ MenuSection.menuItemId เท่านั้น

เช่น { "@id": "menu_section_parent_id", "displayOrder": 4 }
menuAddOnId List<String>

รายการค่า @id ของเอนทิตี MenuSection ที่มาจากส่วน Add on ซึ่งสอดคล้องกับเอนทิตี MenuItem นี้

สำคัญ: คุณต้องใช้การอ้างอิง menuAddOnId หรือ MenuSection.parentMenuItemId เท่านั้น

เช่น menu_addon_1
nutrition NutritionInformation

ข้อมูลโภชนาการของอาหารจานนี้ ที่สำคัญคือแคลอรี่

เช่น { "calories": "120-150 Cal" }
allergen รายการ<Allergen>

สารก่อภูมิแพ้ของ MenuItem นี้

เช่น [ { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" } ]
additive รายการ<Additive>

สารเติมแต่งของ MenuItem นี้

เช่น [ { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" } ]
suitableDiet รายการ<RestrictedDiet>

อาหารเป็นไปตามข้อจำกัดด้านอาหารที่อธิบายไว้

เช่น [ "DIABETIC", "GLUTEN_FREE" ]
depositInfo DepositInfo

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

เช่น { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }
numberOfServings จำนวนเต็ม

จำนวนหน่วยบริโภคที่มีในรายการเมนูที่ระบุ

เช่น 2
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี MenuItem ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ MenuItem

{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Sauteed Baby Spinach",
  "parentMenuSectionId": [
    {
      "@id": "3138479",
      "displayOrder": 18931508
    }
  ]
}
{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Hamburger",
  "parentMenuSectionId": [
    {
      "@id": "4645747",
      "displayOrder": 12345
    }
  ],
  "nutrition": {
    "calories": "400 cal"
  },
  "allergen": [
    {
      "allergenType": "GLUTEN",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "additive": [
    {
      "additiveName": "Sodium nitrite",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "suitableDiet": [
    "DIABETIC",
    "LOW_FAT"
  ]
}

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

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท MenuItemOption

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ค่า: MenuItemOption
@id String

ต้องระบุ

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

เช่น menu_item_1_option
menuItemId ReverseReference

ต้องระบุ

ค่า @id ของเอนทิตี MenuItem ที่สัมพันธ์กับเอนทิตี MenuItemOption นี้

เช่น { "@id": "menu_item_1", "displayOrder": 4 }
optionType OptionType

สตริงที่ระบุว่าตัวเลือกรายการในเมนูได้รับการจัดหมวดหมู่ตามขนาด ตัวเลือก หรือด้านพิซซ่า ค่าที่ยอมรับได้คือ "SIZE", "OPTION" และ "PIZZA_SIDE" "SIZE": ขนาดของ MenuItemOption เช่น เล็ก กลาง หรือใหญ่ "ตัวเลือก": รูปแบบอื่นๆ นอกเหนือจากขนาด (เช่น อาหารที่มาเป็นสลัดหรือแซนด์วิช) ถ้าคุณไม่สามารถแยกความแตกต่างระหว่าง "SIZE" และ "OPTION" ให้ใช้ "OPTION" "PIZZA_SIDE": ใช้ได้กับพิซซ่า เช่น พิซซ่า MenuItemOption นี้ใช้ได้กับพิซซ่า 1 ชิ้น/ทั้งถาด (เช่น ใส่ท็อปปิ้งด้านซ้าย ด้านขวา หรือพิซซ่าทั้งชิ้น)

เช่น SIZE
value สตริงหรือ PizzaSide

ต้องระบุเมื่อ optionType is defined

ค่าสตริงหรือค่า enum ค่า enum จะใช้กับประเภทตัวเลือก PIZZA_SIDE โดยเฉพาะ
applicableParentOptionValue String

สตริงที่มีค่าตัวเลือกของรายการระดับบนที่ตัวเลือกนี้พร้อมใช้งาน

เช่น Small
menuAddOnId List<String>

รายการค่า @id ของเอนทิตี MenuSection ที่มาจากส่วน Add on ซึ่งสอดคล้องกับเอนทิตี MenuItemOption นี้

สำคัญ: คุณต้องใช้การอ้างอิง menuAddOnId หรือ MenuSection.parentMenuItemId เท่านั้น

เช่น menuAddOnId
nutrition NutritionInformation

ข้อมูลโภชนาการของอาหารจานนี้ ที่สำคัญคือแคลอรี่

เช่น { "calories": "120-150 Cal" }
allergen รายการ<Allergen>

สารก่อภูมิแพ้ของ MenuItem นี้

เช่น { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" }
additive รายการ<Additive>

สารเติมแต่งของ MenuItem นี้

เช่น { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" }
depositInfo DepositInfo

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

เช่น { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }
numberOfServings จำนวนเต็ม

จำนวนเสิร์ฟที่มีในตัวเลือกรายการในเมนูที่ระบุ

เช่น 2
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของ ฟีดเอนทิตี MenuItemOption ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ MenuItemOption

{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "optionType": "PIZZA_SIDE",
  "value": "PIZZA_SIDE_LEFT"
}
{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "applicableParentOptionValue": "Small Pizza"
}

เอนทิตีที่จำเป็นเพื่อติดตั้งใช้งาน อธิบายข้อเสนอสำหรับเอนทิตี MenuItem หรือ MenuItemOption

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท MenuItemOffer

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@type ข้อต่อ

ต้องระบุ

ค่า: MenuItemOffer
@id String

ต้องระบุ

ตัวระบุที่ไม่ซ้ำกันของข้อเสนอรายการในเมนู

เช่น menu_item_offer
sku String

ต้องระบุ

ตัวระบุของข้อเสนอรายการในเมนู ค่า SKU อาจแตกต่างกันหรือเหมือนกันในเอนทิตีข้อเสนอรายการในเมนูหลายรายการ ค่า SKU จะถูกตั้งค่าตามลำดับเมื่อเราเรียก API ถึงคุณ

เช่น Menu_item_offer_sku
price Number

ต้องระบุ

ราคาของข้อเสนอรายการในเมนู

เช่น 2.5
priceCurrency String

ต้องระบุ

รหัสสกุลเงินแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว

เช่น USD
availabilityId List<String>

ค่า @id ของเอนทิตีความพร้อมจำหน่ายสินค้า ซึ่งจะให้รายละเอียดเกี่ยวกับเวลาที่ข้อเสนอรายการในเมนูพร้อมใช้งาน

เช่น [ "menu_availability_1" ]
eligibleQuantityMin Number

จำนวนการสั่งซื้อขั้นต่ำที่ MenuItemOffer ใช้ได้

เช่น 1
eligibleQuantityMax Number

จำนวนการสั่งซื้อสูงสุดที่ MenuItemOffer ใช้ได้

เช่น 25
inventoryLevel Number

ระดับสินค้าคงคลังโดยประมาณในปัจจุบันสำหรับสินค้าบางรายการที่เกี่ยวข้องกับ MenuItemOffer นี้

เช่น 10
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขล่าสุดของฟีดเอนทิตี MenuItemOffer ในรูปแบบการประทับเวลา ISO แต่เป็นประเภทสตริง

เช่น 2017-01-02T00:00:00-07:00
applicableServiceType รายการ<ServiceType>

บริการที่ MenuItemOffer นี้ใช้ได้ ค่าเริ่มต้นคือ MenuItemOffer ที่ใช้ได้กับทั้งหมด
offeredById List<String>

ค่า @id ของเอนทิตี Restaurant รายการซึ่งมี MenuItemOffer นี้ ค่าเริ่มต้นจะถือว่า MenuItemOffer พร้อมจำหน่ายในทุกสถานที่

เช่น [ "restaurant_id_5", "restaurant_id_26" ]
ต้องมีกลุ่มพร็อพเพอร์ตี้กลุ่มใดกลุ่มหนึ่งต่อไปนี้
menuItemId กลุ่ม 1 String

ค่า @id ของเอนทิตี MenuItem ที่สัมพันธ์กับเอนทิตี MenuItemOffer นี้

เช่น menu_item_1
menuItemOptionId กลุ่ม 2 String

ค่า @id ของเอนทิตี MenuItemOption ที่สัมพันธ์กับเอนทิตี MenuItemOffer นี้

เช่น menu_item_option_1

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ MenuItemOffer

{
  "@type": "MenuItemOffer",
  "@id": "6680262",
  "sku": "offer-mediterranean-bagel",
  "menuItemId": "896532",
  "price": 15.5,
  "priceCurrency": "USD",
  "applicableServiceType": [
    "DELIVERY"
  ],
  "offeredById": [
    "bagel_shop_location_5"
  ]
}

ทั่วไป

ReverseReference

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท ReverseReference

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
@id String

ต้องระบุ

@id ของเอนทิตีหลัก
displayOrder จำนวนเต็ม

ต้องระบุ

แสดงลำดับของรายการภายในระดับบนสุด

NutritionInformation

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท NutritionInformation

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
description String

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

จำนวนแคลอรี่เป็นแคลอรี่ กิโลแคลอรี หรือกิโลจูล โดยใช้รูปแบบค่า แคลอรี่ แคลอรี่ขั้นต่ำ กิโลจูล

เช่น 120.34 Cal
sodiumContent String

จำนวนของโซเดียมหรือมก. ในรูปแบบต่อไปนี้ ค่า g หรือค่าต่ำสุด-สูงสุด g

เช่น 1200 mg

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ NutritionInformation

ตัวอย่าง

{
  "calories": "120-150 Cal",
  "sodiumContent": "100 mg"
}

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

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Allergen

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
allergenType AllergenType

ต้องระบุ

ประเภทของสารก่อภูมิแพ้
levelOfContainment ContainmentLevel

ระดับสารก่อภูมิแพ้ที่ระบุในรายการเมนู

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Allergen

ตัวอย่าง

{
  "allergenType": "PEANUTS",
  "levelOfContainment": "MAY_CONTAIN"
}

สารเติมแต่ง

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท Additive

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
additiveName String

ต้องระบุ

ชื่อของส่วนเสริม
levelOfContainment ContainmentLevel

ระดับของส่วนเสริมที่กำหนดในรายการเมนู

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ Additive

ตัวอย่าง

{
  "additiveName": "Sodium nitrite",
  "levelOfContainment": "CONTAINS"
}

DepositInfo

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท DepositInfo

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
depositCode DepositCode

รหัสเงินฝาก
depositValue Number

ค่าตัวเลขของมัดจำของสินค้า เช่น เมื่อนำกลับมาใช้ใหม่
depositValueCurrency String

สกุลเงินของมูลค่าเงินฝาก

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ DepositInfo

ตัวอย่าง

{
  "depositCode": "RECYCLABLE",
  "depositValue": 0.05,
  "depositValueCurrency": "USD"
}

ServingConfig

การกำหนดค่าการแสดงผลสำหรับบริการที่ใช้ควบคุมฟีเจอร์ต่างๆ เช่น การปิดใช้วิดเจ็ตโปรโมชัน ฯลฯ

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้สำหรับประเภท ServingConfig

พร็อพเพอร์ตี้ ประเภท คำอธิบาย
disableOrderInstructions บูลีน

ซ่อนความสามารถในการระบุวิธีการสั่งซื้อ
disableMenuItemSpecialInstructions บูลีน

ซ่อนความสามารถในการระบุคำสั่งพิเศษในรายการเมนู
disableTipWidget บูลีน

ซ่อนวิดเจ็ตเคล็ดลับในหน้า "สั่งซื้อ" ของขั้นตอนการสั่งซื้อ
disablePromoWidget บูลีน

ซ่อนวิดเจ็ตโปรโมชันในหน้า "สั่งซื้อ" ของขั้นตอนการสั่งซื้อ
menuItemSpecialInstructionsMaxLength Number

ระบุจำนวนอักขระสูงสุดที่คำสั่งพิเศษของรายการในเมนูจะมีได้
orderInstructionsMaxLength Number

ระบุจำนวนอักขระสูงสุดสำหรับคำสั่งคำสั่งซื้อ

ตัวอย่างต่อไปนี้แสดงองค์ประกอบ ServingConfig

ตัวอย่างที่ 1

{
  "disableMenuItemSpecialInstructions": true
}

ตัวอย่างที่ 2

{
  "disableTipWidget": true,
  "disablePromoWidget": true
}

ตัวอย่าง 3

{
  "menuItemSpecialInstructionsMaxLength": 250,
  "orderInstructionsMaxLength": 1000
}

Enum

DayOfWeek

ประเภท DayOfWeek มีค่าที่เป็นไปได้ต่อไปนี้

  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
  • SUNDAY

ServiceType

ประเภท ServiceType มีค่าที่เป็นไปได้ต่อไปนี้

  • DELIVERY
  • TAKEOUT

OrderType

ประเภท OrderType มีค่าที่เป็นไปได้ต่อไปนี้

  • ASAP
  • ADVANCE

FeeType

ประเภท FeeType มีค่าที่เป็นไปได้ต่อไปนี้

  • DELIVERY
  • SERVICE

OptionType

ประเภท OptionType มีค่าที่เป็นไปได้ต่อไปนี้

  • SIZE
  • OPTION
  • PIZZA_SIDE

PizzaSide

ประเภท PizzaSide มีค่าที่เป็นไปได้ต่อไปนี้

  • PIZZA_SIDE_LEFT
  • PIZZA_SIDE_RIGHT
  • PIZZA_SIDE_WHOLE

AllergenType

ประเภทของสารก่อภูมิแพ้ตาม gs1:AllergenTypeCode

ประเภท AllergenType มีค่าที่เป็นไปได้ต่อไปนี้

  • ALMONDS
  • ALPHA_ISOMETHYL_IONONE
  • ALCOHOL
  • AMYL_CINNAMAL
  • ANISE_ALCOHOL
  • BARLEY
  • BENZYL_ALCOHOL
  • BENZYL_BENZOATE
  • BENZYL_CINNAMATE
  • BENZYL_SALICYLATE
  • BRAZIL_NUTS
  • BUTYLPHENYL_METHYLPROPIONATE
  • CARROTS
  • CASHEW_NUTS
  • CELERY
  • CEREALS_CONTAINING_GLUTEN
  • CINNAMAL
  • CINNAMYL_ALCOHOL
  • CITRAL
  • CITRONELLOL
  • COCOA
  • CORIANDER
  • CORN
  • COUMARIN
  • CRUSTACEANS
  • EGGS
  • EUGENOL
  • EVERNIA_FURFURACEA
  • EVERNIA_PRUNASTRI
  • FARNESOL
  • FISH
  • GERANIOL
  • GLUTEN
  • HAZELNUTS
  • HEXYL_CINNAMAL
  • HYDROXYCITRONELLAL
  • HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
  • KAMUT
  • LACTOSE
  • LUPINE
  • MACADAMIA_NUTS
  • METHYL_2_OCTYNOATE
  • MILK
  • MOLLUSCS
  • MUSTARD
  • NO_DECLARED_ALLERGENS
  • OAT
  • PEANUTS
  • PEAS
  • PECAN_NUTS
  • PISTACHIOS
  • POD_FRUITS
  • QUEENSLAND_NUTS
  • RYE
  • SESAME_SEEDS
  • SOYBEANS
  • SPELT
  • SULPHUR_DIOXIDE
  • TREE_NUTS
  • TREE_NUT_TRACES
  • WALNUTS
  • WHEAT

ContainmentLevel

ประเภท ContainmentLevel มีค่าที่เป็นไปได้ต่อไปนี้

  • CONTAINS
  • FREE_FROM
  • MAY_CONTAIN

DepositCode

ประเภท DepositCode มีค่าที่เป็นไปได้ต่อไปนี้

  • REUSABLE
  • RECYCLABLE

DealType

หมวดหมู่ของดีลที่จะใช้ส่วนลด โดยหมวดหมู่อาจเป็นราคารวมทั้งหมดในรถเข็นหรือค่าธรรมเนียมการนำส่ง

ประเภท DealType มีค่าที่เป็นไปได้ต่อไปนี้

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

ประเภทอาหารที่ถูกจำกัดตาม schema.org:RestrictedDiet

ประเภท RestrictedDiet มีค่าที่เป็นไปได้ต่อไปนี้

  • DIABETIC
  • GLUTEN_FREE
  • HALAL
  • HINDU
  • KOSHER
  • LOW_CALORIE
  • LOW_FAT
  • LOW_LACTOSE
  • LOW_SALT
  • VEGAN
  • VEGETARIAN