إضافة أقسام المقاعد لتناول الطعام

من الشائع أن تتضمّن المطاعم مساحات جلوس مختلفة، مثل بار أو فناء، وأن تقدّم تجارب مختلفة، مثل قائمة طعام من خمسة أطباق أو تذوّق النبيذ. يتيح "مركز الإجراءات" هذا التمييز ويسمح للمستخدم بتحديد المنطقة التي يريد حجز طاولة فيها.

فترات التوفّر مع أسماء الغرف

الشكل 1: مثال على اختيار أماكن جلوس في مطعم

يمكن استخدام عملية الفصل هذه من خلال ضبط الحقول room_id وroom_name وresources في رسالة Availability الخاصة بفتحة الإعلان. لتضمين أوصاف الغرف، استخدِم الحقل room_description داخل رسالة Resources.

// 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 لتقديم تجارب تناول طعام مدفوعة مسبقًا. توضّح لقطة الشاشة التالية كيفية عرض التجربة على الويب.

الشكل 1: مثال على اختيار خانة في مطعم يتضمّن أقسامًا للجلوس مع أوصاف الغرف

عيّنة الغرفة

{
  "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": "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,
      }
    }]
}

التأكّد من أنّ حجم خلاصتك يظل صغيرًا

إذا كان لديك عدد كبير من أقسام المقاعد التي يتضمّن كل منها أوصافًا للغرف، يمكنك تقليل حجم خلاصتك من خلال تضمين أوصاف الغرف في أحد الفترات الزمنية فقط. نستخدم room_name وroom_id في جميع الخانات ونضيف room_description من إحدى الخانات.

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

نموذج لوصف الغرفة

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