สคีมาพื้นที่โฆษณาเชิงสัมพันธ์

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

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

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

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

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

คุณจะนําเอนทิตีย่อยไปใช้ซ้ำในร้านอาหารหลายแห่งได้

หลักเกณฑ์เกี่ยวกับค่า JSON

การบังคับให้ใช้ประเภท

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

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

ค่า DateTime และ Time

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 Const

ต้องระบุ

ค่า: 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

ต้องระบุ

รหัสประเทศแบบ ISO 3166-1 alpha-2 ที่เป็นอักษร 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 Const

ต้องระบุ

ค่า: Deal
@id String

ต้องระบุ

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

ตัวอย่าง: FREEDELIVERY
dealCode String

ต้องระบุ

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

ตัวอย่าง: ADETRE23
applicableServiceType List<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
คุณต้องระบุกลุ่มพร็อพเพอร์ตี้ต่อไปนี้เพียง 1 กลุ่ม
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 Const

ต้องระบุ

ค่า: 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 Const

ต้องระบุ

ค่า: 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 บูลีน

ยกเว้นพื้นที่ให้บริการนี้จากภูมิภาคการนำส่งทั้งหมด เช่น คุณยกเว้นรหัสไปรษณีย์ออกจากพื้นที่รูปหลายเหลี่ยมขนาดใหญ่ได้
คุณต้องระบุกลุ่มพร็อพเพอร์ตี้ต่อไปนี้เพียง 1 กลุ่ม
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

ระบุรหัสประเทศ ISO 3166-1 alpha-2 แบบ 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 และค่าเริ่มต้นจะแสดงเวลาทําการทุกชั่วโมงทุกวัน

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

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

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

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

ต้องระบุ

ค่า: OperationHours
@id String

ต้องระบุ

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

ตัวอย่าง: operation_hour_1
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่เชื่อมโยงกับเอนทิตี OperationHours นี้

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

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

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

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

ตัวอย่าง: T16:00
dayOfWeek List<DayOfWeek>

รายการวันของสัปดาห์ที่เวลาทําการเหล่านี้มีผล ค่าที่ยอมรับคือ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" และ "SUNDAY"

ตัวอย่าง: [ "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 บูลีน

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

ตัวอย่าง: False
dateModified การประทับเวลา ISO

วันที่และเวลาที่แก้ไขฟีดเอนทิตี OperationHours ครั้งล่าสุดในรูปแบบการประทับเวลา 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 (ต้องระบุ)

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

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

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

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

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

ต้องระบุ

ค่า: ServiceHours
@id String

ต้องระบุ

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

ตัวอย่าง: service_hour_1
orderType OrderType

ต้องระบุ

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

ตัวอย่าง: ASAP
serviceId List<String>

ต้องระบุ

ค่า @id ของเอนทิตีบริการที่เชื่อมโยงกับเอนทิตี ServiceHours นี้

ตัวอย่าง: [ "service_1" ]
operationHoursId List<String>

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

ค่า @id ของเอนทิตี OperationHours ที่เชื่อมโยงกับเอนทิตี ServiceHours นี้

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

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

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

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

ตัวอย่าง: T16:00
dayOfWeek List<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 บูลีน

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

ตัวอย่าง: False
leadTimeMin จำนวนเต็ม

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

ตัวอย่าง: 60
leadTimeMax จำนวนเต็ม

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

ตัวอย่าง: 70
advanceBookingRequirementMin จำนวนเต็ม

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

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

ตัวอย่าง: 15
advanceBookingRequirementMax จำนวนเต็ม

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

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

ตัวอย่าง: 10080
advanceBookingSlotInterval String

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

ช่วงเวลาระหว่างช่วงเวลาที่จองล่วงหน้า 2 ช่วงเวลาติดต่อกัน ตัวอย่างเช่น หากเวลาเปิดและปิดคือ 08:00 น. และ 20:00 น. และ advanceBookingSlotInterval คือ 15 นาที ผู้ใช้จะเลือกเวลาดำเนินการได้ตั้งแต่ 08:00 น., 08:15 น., 08:30 น., 08:45 น. และอื่นๆ จนถึง 20:00 น. ระยะเวลาต้องระบุเป็นระยะเวลาของ ISO Period เช่น "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 Const

ต้องระบุ

ค่า: 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
คุณต้องระบุกลุ่มพร็อพเพอร์ตี้ต่อไปนี้เพียง 1 กลุ่ม
price กลุ่ม 1 Number

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

ตัวอย่าง: 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 Const

ต้องระบุ

ค่า: 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 Const

ต้องระบุ

ค่า: MenuSection
@id String

ต้องระบุ

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

ตัวอย่าง: menu_section_1
menuId List<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 List<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 List<ReverseReference>

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

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

ตัวอย่าง: [ { "@id": "parent_menu_item_id", "displayOrder": 4 } ]
parentMenuItemOptionId List<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 List<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 Const

ต้องระบุ

ค่า: Availability
@id String

ต้องระบุ

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

ตัวอย่าง: menu_section_avail_1
availabilityStarts เวลา ISO (ท้องถิ่น)

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

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

การประทับเวลา ISO ที่ระบุเวลาสิ้นสุดที่ส่วนเมนูจะใช้งานไม่ได้

ตัวอย่าง: T16:00
availableDay List<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 Const

ต้องระบุ

ค่า: MenuItem
@id String

ต้องระบุ

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

ตัวอย่าง: menu_item_1
name String

ต้องระบุ

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

ตัวอย่าง: Foo
description String

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

ตัวอย่าง: Foo
image URL

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

ตัวอย่าง: http://someprovider.com/someimage
parentMenuSectionId List<ReverseReference>

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

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

ตัวอย่าง: { "@id": "menu_section_parent_id", "displayOrder": 4 }
menuAddOnId List<String>

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

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

ตัวอย่าง: menu_addon_1
nutrition NutritionInformation

ข้อมูลโภชนาการของอาหาร โดยเฉพาะอย่างยิ่งแคลอรี่

ตัวอย่าง: { "calories": "120-150 Cal" }
allergen List<Allergen>

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

ตัวอย่าง: [ { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" } ]
additive List<Additive>

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

ตัวอย่าง: [ { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" } ]
suitableDiet List<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 Const

ค่า: 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 นี้ใช้ได้กับพิซซ่าทั้งถาด/บางส่วนเท่านั้น (เช่น ใส่เห็ดไว้ด้านซ้าย ด้านขวา หรือทั้งถาด)

ตัวอย่าง: SIZE
value สตริงหรือ PizzaSide

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

ค่าสตริงหรือค่า enum ค่า Enum เจาะจงสำหรับประเภทตัวเลือก PIZZA_SIDE
applicableParentOptionValue String

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

ตัวอย่าง: Small
menuAddOnId List<String>

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

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

ตัวอย่าง: menuAddOnId
nutrition NutritionInformation

ข้อมูลโภชนาการของอาหาร โดยเฉพาะอย่างยิ่งแคลอรี่

ตัวอย่าง: { "calories": "120-150 Cal" }
allergen List<Allergen>

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

ตัวอย่าง: { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" }
additive List<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 Const

ต้องระบุ

ค่า: 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 List<ServiceType>

บริการที่ MenuItemOffer นี้มีผล ค่าเริ่มต้นจะถือว่า MenuItemOffer มีผลกับทุกคน
offeredById List<String>

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

ตัวอย่าง: [ "restaurant_id_5", "restaurant_id_26" ]
คุณต้องระบุกลุ่มพร็อพเพอร์ตี้ต่อไปนี้เพียง 1 กลุ่ม
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

จำนวนแคลอรี่ในหน่วย Cal, kcal หรือ kJ โดยใช้รูปแบบค่า Cal หรือ Cal ขั้นต่ำ-สูงสุด

ตัวอย่าง: 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 มีค่าที่เป็นไปได้ดังนี้

  • 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