كيان الخدمة

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

الشكل 1: كيان الخدمة الذي يوضّح علاقته بالكيانات التي تشمل منطقة الخدمة وساعات العمل وساعات العمل والرسوم.

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

مثال على كيان الخدمة

يحدّد المثال التالي كيان 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 للمطعم في أقرب وقت ممكن أو يمكنهم تقديم الطلبات في وقت مبكر ضمن ساعات العمل للمطعم ليتمّ تقديمها خلال ServiceHours للمطعم. لتحديد ساعات الخدمة المسبقة، أنشئ كيان ServiceHours مع تعيين الخاصية orderType على ADVANCE. يمكنك الاطّلاع على ساعات التسليم والاستلام لمزيد من التفاصيل والأمثلة.

إيقاف كيان Service مؤقتًا

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

راجع حذف الكيانات وتعطيلها لمزيد من التفاصيل والأمثلة.