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)
    }
  ]
}
زمینه های
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

اگر یک پیام 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" .

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 )

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

availability[]

object ( Availability )

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