Method: inventory.partners.availability.replace

يحل محل Availability من Services الحالية. لا يضمن هذا الطلب المجمّع الاتزان. لن يتم عرض سوى خانات مدى التوفّر التي تم تعديلها بنجاح.

طلب HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

تنسيق partners/{partner_id}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
الحقول
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

تمثّل هذه السمة مدى توفّر الخدمة الممتد والذي يُستخدَم لاستبدال خانات مدى التوفّر الحالية.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الرد المجمّع لاستبدال خانات مدى التوفّر المتعددة في Service. لن تتضمّن هذه الرسالة سوى الخانات التي تم تعديلها بنجاح.

تمثيل JSON
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
الحقول
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

الرسائل التي تم تعديلها بنجاح والتي تم استخدامها بدلاً من خانات مدى التوفّر الحالية

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/mapsbooking

ExtendedServiceAvailability

قائمة بمدى التوفّر والأشخاص الذين يجب تقديم طلبهم ومتى يجب تطبيقها.

تمثيل JSON
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
الحقول
merchantId

string

هذا حقل إلزامي مطلوب لتحديد التاجر الذي تنتمي إليه رسائل التوفّر أدناه.

serviceId

string

هذا حقل إلزامي مطلوب لتحديد الخدمة التي تنتمي إليها رسائل التوفّر أدناه.

startTimeRestrict

string (Timestamp format)

وفي حال توفير هذه البيانات، سنعتبر كيانات "مدى التوفّر" المُقدَّمة نبذة كاملة من [startTimeRestrict, endTimeRestrict). ويعني ذلك أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية في حال استيفاء الشرط التالي:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

في حال ضبط رسالة مدة، يتم تقييد الشرط بشكل أكبر:

  availability.duration == durationRestrict

في حال ضبط رسالة resourcesRestrict، يتم فرض قيود إضافية على الشرط:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني محدّد.

يتم تفسير ضبط startTimeRestrict مع ترك endTimeRestrict على لجميع الأوقات بدءًا من startTimeRestrict.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

endTimeRestrict

string (Timestamp format)

يتم تفسير ضبط endTimeRestrict مع ترك startTimeRestrict على القيمة "جميع الأوقات" حتى endTimeRestrict.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

durationRestrict

string (Duration format)

يؤدي ضبط المدة إلى حصر نطاق التحديث فقط بمدى التوفّر بمدة مطابقة.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

resourcesRestrict

object (Resources)

يؤدي ضبط الموارد إلى حصر نطاق التحديث على هذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول أرقام التعريف للموارد تمامًا.

availability[]

object (Availability)

تمثّل هذه السمة القائمة الجديدة لمدى التوفّر.