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 "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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)

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

object (Availability)

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