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

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

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

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

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

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

string (Timestamp format)

يتم تفسير ضبط endTimeRestrict أثناء ترك startTimeRestrict على أنه لا يتم توفير كل الوقت وصولاً إلى endTimeRestrict.

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

string (Duration format)

عند تحديد مدة، يتم حصر نطاق التحديث ليشمل فقط مدى التوفّر مع مدة المطابقة.

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".
resourcesRestrict

object (Resources)

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

object (Availability)

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