Method: inventory.partners.availability.replace

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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

دسترسی‌پذیری گسترده به سرویس

فهرستی از موارد در دسترس و اینکه چه کسی/چه زمانی باید به آنها اعمال شود.

نمایش 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)

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

   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 شروع می‌شوند.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

endTimeRestrict

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

durationRestrict

string ( Duration format)

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

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

resourcesRestrict

object ( Resources )

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

availability[]

object ( Availability )

لیست جدید موجودی.