레스토랑에는 바 또는 파티오와 같은 고유한 좌석 공간과 5코스 시식 메뉴 또는 와인 시음과 같은 다양한 경험이 있는 경우가 많습니다. 작업 센터는 이 구분을 지원하며 사용자가 테이블을 예약할 지역을 지정할 수 있도록 합니다.
객실 이름이 있는 예약 가능 여부 슬롯
이러한 인벤토리 분리는 이용 가능 여부 슬롯의 resources
메시지에서 room_id
, room_name
, 필드를 설정하여 사용할 수 있습니다. 방 설명을 포함하려면 리소스 메시지 내에서 room_description
필드를 사용하세요.
// 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;
}
이 정보는 시간대 정의의 핵심 부분이며 피드뿐만 아니라
모든 예약 및 실시간 업데이트 작업에도 포함되어야 합니다.
room_id
및 room_name
가 지정된 예는 식당, 카테고리별 피드 예에서 확인할 수 있습니다.
환경설정의 방 이름을 사용한 이용 가능 시간 슬롯
예약 결제 리디렉션을 구현했거나 구현 중인 경우 room_name
및 room_descriptions
를 사용하여 선불 식사 환경을 지원할 수 있습니다. 다음 스크린샷은 환경이 웹에 표시되는 방식을 자세히 보여줍니다.
Room 샘플
{ "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, } } }] }
환경 샘플
{ "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": "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, } } }] }