Rechtssubjekt

Die Entität Service definiert die Essensbestellungsdienste, die in einem Restaurant verfügbar sind, z. B. zum Mitnehmen oder zur Lieferung. Verwenden Sie beim Definieren einer Service-Entität den Typ Dienst. Jedes Restaurant muss mit mindestens einer Serviceentität vom Typ „Imbiss“ oder „Lieferung“ und maximal zwei Serviceentitäten verbunden sein, eine vom Typ „Imbiss“ und eine vom Typ „Lieferung“.

Diagramm der Dienstentitätsbeziehung
Abbildung 1:Dienstentität mit Beziehung zu den Entitäten „ServiceArea“, „ServiceHours“, „OperationHours“ und „Fee“.

Eine Dienstentität definiert Eigenschaften wie den Diensttyp, die verfügbaren Öffnungszeiten und das Einzugsgebiet. Die Dienstentität ändert sich voraussichtlich und wird bei jedem Datenfeed-Upload aktualisiert.

Beispiel für eine Dienstentität

Im folgenden Beispiel wird eine einfache Service-Entität definiert, die täglich Bestellungen akzeptiert.

{
  "@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
}

So schnell wie möglich und Stunden im Voraus

Nutzer können Bestellungen mit Lieferung so bald wie möglich während der ServiceHours für Lieferungen so bald wie möglich aufgeben oder sie können Bestellungen innerhalb der OperationHours des Restaurants im Voraus aufgeben, um sie während der ServiceHours für Lieferungen im Voraus zu erhalten. Wenn Sie die Öffnungszeiten für die Vorabbuchung definieren möchten, erstellen Sie eine ServiceHours-Entität mit der Property orderType auf ADVANCE festgelegt. Weitere Informationen und Beispiele finden Sie unter Liefer- und Abholzeiten.

Service-Entität vorübergehend deaktivieren

Sie können ServiceHours für einen bestimmten Zeitraum, der im Voraus bekannt ist, vorübergehend pausieren oder überschreiben, indem Sie Feiertags- und Sonderöffnungszeiten festlegen. Wenn Sie eine Dienst-Entität aus unvorhergesehenen Gründen deaktivieren möchten, senden Sie eine Echtzeitaktualisierungsanfrage, bei der die Eigenschaft isDisabled der Dienst-Entität auf true festgelegt ist.

Weitere Informationen und Beispiele finden Sie unter Entitäten löschen und deaktivieren.