كيان الخدمة

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

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

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

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