Method: inventory.partners.availability.replace

Availability Services موجود را جایگزین می کند. این فراخوان دسته ای اتمی بودن را تضمین نمی کند. فقط اسلات های در دسترس که با موفقیت به روز شده اند بازگردانده می شوند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

قالب partners/{partner_id} .

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
فیلدها
extended Service Availability[]

object ( ExtendedServiceAvailability )

در دسترس بودن سرویس گسترده که برای جایگزینی اسلات های موجود استفاده می شود.

بدن پاسخگو

پاسخ دسته ای برای جایگزینی اسلات های دسترسی چند Service . فقط اسلات هایی که با موفقیت به روز شده اند در این پیام گنجانده می شوند

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
فیلدها
extended Service Availability[]

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)
    }
  ]
}
فیلدها
merchant Id

string

این یک فیلد اجباری است که برای تعیین اینکه پیام‌های در دسترس بودن زیر متعلق به کدام تاجر است، لازم است.

service Id

string

این یک فیلد اجباری است که برای مشخص کردن این که پیام‌های در دسترس بودن زیر به کدام سرویس تعلق دارند، لازم است.

start Time Restrict

string ( Timestamp format)

در صورت ارائه، موجودیت های در دسترس بودن ارائه شده را به عنوان یک عکس فوری کامل از [startTimeRestrict، endTimeRestrict در نظر می گیریم. به این معنا که اگر شرط زیر درست باشد، تمام موجودی‌های موجود حذف خواهند شد:

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

اگر پیام مدت زمان تنظیم شده باشد، این شرط بیشتر محدود می شود:

  availability.duration == durationRestrict

اگر یک پیام SourceRestrict تنظیم شده باشد، این شرط بیشتر محدود می شود:

   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" .

end Time Restrict

string ( Timestamp format)

تنظیم endTimeRestrict در حالی که startTimeRestrict تنظیم نشده است به معنای تمام زمان تا endTimeRestrict تفسیر می شود.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

duration Restrict

string ( Duration format)

تنظیم مدت زمان، دامنه به‌روزرسانی را فقط به در دسترس بودن با مدت زمان منطبق محدود می‌کند.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

resources Restrict

object ( Resources )

تنظیم منابعRestrict بیشتر دامنه به‌روزرسانی را فقط به این مجموعه از منابع محدود می‌کند. تمام فیلدهای شناسه منابع باید دقیقاً مطابقت داشته باشند.

availability[]

object ( Availability )

لیست جدید در دسترس بودن