Thông thường, nhà hàng có các khu vực chỗ ngồi riêng biệt như quầy bar hoặc sân hiên và các trải nghiệm khác nhau, chẳng hạn như thực đơn nếm thử gồm 5 món hoặc nếm thử rượu vang. Trung tâm hành động hỗ trợ sự khác biệt này và cho phép người dùng chỉ định khu vực để đặt bàn.
Khung giờ còn phòng có tên phòng
Bạn có thể sử dụng tính năng phân tách quỹ phòng này bằng cách đặt room_id
, room_name
và các trường trong thông báo resources
của khung Availability (Khả năng cung cấp). Để thêm nội dung mô tả phòng, hãy sử dụng trường room_description
bên trong thông báo Tài nguyên.
// 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;
}
Thông tin này là một phần không thể thiếu trong định nghĩa về chỗ trống và cần được đưa vào nguồn cấp dữ liệu cũng như tất cả các hoạt động đặt phòng và cập nhật theo thời gian thực.
Bạn có thể xem ví dụ về room_id
và room_name
được chỉ định trong ví dụ về nguồn cấp dữ liệu dành riêng cho ngành dọc là Nhà hàng.
Khung giờ trống sử dụng tên phòng cho trải nghiệm
Nếu đã triển khai hoặc đang trong quá trình triển khai tính năng Chuyển hướng thanh toán đặt chỗ, bạn có thể sử dụng room_name
và room_descriptions
để cung cấp trải nghiệm ăn uống trả trước. Ảnh chụp màn hình sau đây cho biết chi tiết cách trải nghiệm hiển thị trên web.
Mẫu 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, } } }] }
Mẫu trải nghiệm
{ "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, } } }] }