Method: inventory.partners.merchants.services.availability.replace

« Availability Service موجود یک فروشنده که توسط تجمیع‌کننده مشخص شده مدیریت می‌شود» را جایگزین کرده و آن را برمی‌گرداند.

درخواست HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
serviceAvailability.name

string

نام منبع سرویسی که این مورد روی آن اعمال می‌شود. در قالب partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer,
      "roomDescription": {
        object (Text)
      }
    },
    "availability": [
      {
        "startTime": string,
        "duration": string,
        "spotsTotal": string,
        "spotsOpen": string,
        "availabilityTag": string,
        "resources": {
          object (Resources)
        },
        "paymentOptionId": [
          string
        ],
        "recurrence": {
          object (Recurrence)
        },
        "scheduleException": [
          {
            object (ScheduleException)
          }
        ],
        "deposit": {
          object (Deposit)
        },
        "noShowFee": {
          object (NoShowFee)
        },
        "prepayment": {
          object (Prepayment)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode),
        "linkoutRequiredReason": enum (LinkoutRequiredReason)
      }
    ]
  }
}
فیلدها
serviceAvailability.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" .

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

serviceAvailability.durationRestrict

string ( Duration format)

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

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

serviceAvailability.resourcesRestrict

object ( Resources )

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

serviceAvailability.availability[]

object ( Availability )

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

بدنه پاسخ

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

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

نمایش JSON 
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
فیلدها
name

string

نام منبع سرویسی که این مورد روی آن اعمال می‌شود. در قالب partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

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 )

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

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking