Dodawanie miejsc do siedzenia w jadalni

Restauracje często mają wydzielone strefy, takie jak bar czy patio, i oferują różne atrakcje, np. pięciodaniowe menu degustacyjne lub degustację wina. Centrum działań obsługuje to rozróżnienie i umożliwia użytkownikowi określenie obszaru, w którym chce zarezerwować stolik.

Dostępne miejsca z nazwami pomieszczeń

Ilustracja 1. Przykładowy wybór przedziału czasowego w przypadku restauracji z sekcjami miejsc siedzących

To rozdzielenie zasobów reklamowych można zastosować, ustawiając pola room_id, room_nameresources w wiadomości Dostępność gniazda. Aby uwzględnić opisy pokoi, użyj pola room_description w wiadomości Zasoby.

// A resource is used to disambiguate availability slots from one another when
// different staff, room or party_size values are part of the service.
// Multiple slots for the same service and time interval can co-exist when they
// have different resources.
message Resources {
  // One of staff_id, room_id, or party_size must be set.

  // Optional ID for a staff member providing the service. This field identifies
  // the staff member across all merchants, services, and availability records.
  // It also needs to be stable over time to allow correlation with past
  // bookings. (optional but required if staff_name is present)
  string staff_id = 1;

  // Optional name of a staff member providing the service. This field will be
  // displayed to users making a booking, and should be human-readable, as
  // opposed to an opaque identifier. (optional but required if staff_id is
  // present)
  string staff_name = 2;

  // An optional ID for the room the service is located in. This field
  // identifies the room across all merchants, services, and availability
  // records. It also needs to be stable over time to allow correlation with
  // past bookings. (optional but required if room_name is present)
  string room_id = 3;

  // An optional name for the room the service is located in or experience of
  // of the service. This field will be displayed to users making a booking,
  // and should be human readable, as opposed to an opaque identifier.
  // A room name should only be used for seating areas or prepaid experiences.
  // Examples of room names include "Bar", "Patio", "Dining Room". Examples of
  // dining experiences using room names include "Five-Course Tasting Menu",
  // "Chef Omakase". It is strongly recommended that the default seating area
  // does not have a room associated with it.
  string room_name = 4;

  // Applicable only for Dining: The party size that can be accommodated
  // during this time slot. A restaurant can be associated with multiple Slots
  // for the same time, each specifying a different party_size, if for instance
  // 2, 3, or 4 people can be seated with a reservation. (optional)
  int32 party_size = 5;

  // Localized room description with a limit of 500 characters. If set,
  // a default value must be provided, it is preferred to use the common
  // languages for the merchant's locale.
  Text room_description = 7;
}

Te informacje są integralną częścią definicji przedziałów czasowych i muszą być uwzględnione w plikach danych, a także we wszystkich operacjach rezerwacji i aktualizacji w czasie rzeczywistym. Przykłady określania wartości room_id i room_name znajdziesz w przykładzie pliku danych dotyczącego restauracji w formacie pionowym.

Dostępne miejsca z nazwami pokoi w przypadku atrakcji

Jeśli masz wdrożoną lub wdrażasz przekierowanie płatności za rezerwacje, możesz używać parametrów room_nameroom_descriptions do obsługi przedpłaconych rezerwacji w restauracjach. Na zrzucie ekranu poniżej widać, jak ta funkcja jest wyświetlana w internecie.

Ilustracja 1. Przykładowy wybór miejsc w restauracji z sekcjami miejsc do siedzenia, w tym opisami pomieszczeń

Próbka pomieszczenia

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
      "room_id": "A-dining-room",
      "room_name": "Bar",
      "party_size": 2,
      }
  }]
}

Przykładowe atrakcje

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
      "room_id": "experience-1",
      "room_name": "Wine Tasting Menu Pair",
      "description": "This Wine Tasting Menu Pair showcases American cuisine rooted in the nostalgic flavors of the 20th century American experience. Each experience is hand-crafted, with a progression from small bites to more substantial plates.",
      "party_size": 2,
      }
    }]
}

Zadbaj o to, aby rozmiar pliku danych był mały

Jeśli masz dużą liczbę sekcji miejsc siedzących, z których każda ma opis pokoju, możesz zmniejszyć rozmiar pliku danych, uwzględniając opisy pokoju tylko w jednym z miejsc. We wszystkich slotach używamy symboli room_nameroom_id, a z jednego ze slotów dodajemy symbol room_description.

Podczas zarządzania rozmiarem pliku danych warto stosować sprawdzone metody opisane w artykułach Kompresowanie plików danych i Dzielenie plików danych.

Przykładowy opis pokoju

{
  "availability": [
    {
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
      "room_id": "experience-1",
      "room_name": "Wine Tasting Menu Pair",
      "description": "This Wine Tasting Menu Pair showcases American cuisine rooted in the nostalgic flavors of the 20th century American experience. Each experience is hand-crafted, with a progression from small bites to more substantial plates.",
      "party_size": 2
      }
  },
  {
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535854600,
    "duration_sec": 2700,
    "spots_total": 4,
    "spots_open": 4,
    "resources": {
      "room_id": "experience-1",
      "room_name": "Wine Tasting Menu Pair",
      "party_size": 6
      }
  }]
}