الجهة المقدِّمة للخدمة

يحدّد عنصر Service خدمات طلب الطعام المتاحة في مطعم، مثل خدمة تناول الطعام خارج المطعم أو خدمة التوصيل. عند تحديد عنصر Service، استخدِم نوع الخدمة. يجب ربط كل مطعم بكيان خدمة واحد على الأقل من نوع الوجبات الجاهزة أو التسليم واثنين كحد أقصى من كيانات الخدمة، أحدهما من نوع الوجبات الجاهزة والآخر من نوع التسليم.

الشكل 1: عنصر الخدمة الذي يعرض علاقته بعناصر ServiceArea وServiceHours وOperationHours وFee

يحدِّد عنصر الخدمة سمات مثل نوع الخدمة وساعات العمل المتاحة والمنطقة التي تُقدَّم فيها الخدمة. من المتوقّع أن يتغيّر عنصر الخدمة وأن تتم إعادة تحميله مع كل عملية تحميل خلاصة بيانات.

مثال على الجهة المقدِّمة للخدمة

يحدِّد المثال التالي عنصرًا أساسيًا من النوع Service يقبل الطلبات كل يوم.

تحذير: يجب تحديد كلّ كيان في سطر واحد في خلاصة البيانات. تم تنسيق المثال التالي لتسهيل فهمه، ولكنّه لا يمثّل طريقة صالحة لتنظيم بياناتك.

{
  "@type":"Service",
  "@id":"takeout_1",
  "serviceType":"TAKEOUT",
  "menuId":"menu_1",
  "restaurantId":"restaraunt_1"
}
{
  "@type":"OperationHours",
  "@id":"takeout_1_op_hours",
  "serviceId":"takeout_1",
  "opens":"00:00",
  "closes":"23:59"
}
{
  "@type":"ServiceHours",
  "@id":"takeout_1_service_hours",
  "orderType":"ASAP",
  "serviceId":"takeout_1",
  "operationHoursId":"takeout_1_op_hours",
  "opens":"11:00",
  "closes":"21:00",
  "dayOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY", "FRIDAY", "SATURDAY"],
  "leadTimeMin":"20",
  "leadTimeMax":"20",
  "isSpecialHour":false
}
{
  "@type":"ServiceHours",
  "@id":"takeout_1_service_hours_sun",
  "orderType":"ASAP",
  "serviceId":"takeout_1",
  "operationHoursId":"takeout_1_op_hours",
  "opens":"16:00",
  "closes":"21:00",
  "dayOfWeek":["SUNDAY"],
  "leadTimeMin":"20",
  "leadTimeMax":"20",
  "isSpecialHour":false
}
{
  "@type":"Service",
  "@id":"delivery_1",
  "serviceType":"DELIVERY",
  "menuId":"10824",
  "restaurantId":"10824"
}
{
  "@type":"OperationHours",
  "@id":"delivery_1_op_hours",
  "serviceId":"delivery_1",
  "opens":"00:00",
  "closes":"23:59"
}
{
  "@type":"ServiceHours",
  "@id":"delivery_1_service_hours",
  "orderType":"ASAP",
  "serviceId":"delivery_1",
  "operationHoursId":"delivery_1_op_hours",
  "opens":"11:00",
  "closes":"21:00",
  "dayOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY", "FRIDAY", "SATURDAY",
  "SUNDAY"],
  "leadTimeMin":"50",
  "leadTimeMax":"50",
  "isSpecialHour":false
}
{
  "@type":"ServiceArea",
  "@id":"delivery_1_service_area",
  "serviceId":"delivery_1",
  "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"]
}
{
  "@type":"Fee",
  "@id":"delivery_1_fee",
  "serviceId":"delivery_1",
  "feeType":"DELIVERY",
  "priceCurrency":"USD",
  "eligibleRegion":"delivery_1_service_area",
  "eligibleTransactionVolumeMin":20,
  "percentageOfCart": 7
}

ساعات العمل في أقرب وقت ممكن وساعات العمل المتقدّمة

يمكن للمستخدمين تقديم طلبات في أقرب وقت ممكن خلال ServiceHours في أقرب وقت ممكن للمطعم، أو يمكنهم تقديم الطلبات مسبقًا خلال OperationHours للمطعم لكي يتم تنفيذها خلال ServiceHours المُسبَقة. لتحديد ساعات الخدمة المتقدّمة، أنشئ عنصر ServiceHours مع ضبط السمة orderType على ADVANCE. اطّلِع على ساعات التوصيل والاستلام للاطّلاع على مزيد من التفاصيل والأمثلة.

إيقاف عنصر Service مؤقتًا

يمكنك تعليق ServiceHours مؤقتًا أو استبدالها لفترة زمنية محدّدة معروفة مسبقًا من خلال ضبط ساعات العمل الخاصة والأعياد. لإيقاف عنصر خدمة لسبب غير متوقّع، أرسِل طلب تعديل في الوقت الفعلي مع ضبط سمة isDisabled لعنصر الخدمة على true.

اطّلِع على حذف الكيانات وإيقافها للحصول على مزيد من التفاصيل والأمثلة.