كيان الخدمة

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

الرسم البياني للعلاقة بين كيان الخدمة
الشكل 1: كيان خدمة يعرض علاقته مع كيانات "ServiceArea" و"ساعات الخدمة" و"ساعات التشغيل" و"الرسوم"

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

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

يحدّد المثال التالي كيان 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.

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