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 از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
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
    },
    "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)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode)
      }
    ]
  }
}
زمینه های
serviceAvailability.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" .

serviceAvailability.endTimeRestrict

string ( Timestamp format)

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

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

serviceAvailability.durationRestrict

string ( Duration format)

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

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

serviceAvailability.resourcesRestrict

object ( Resources )

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

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)

در صورت ارائه، موجودیت های در دسترس بودن ارائه شده را به عنوان یک عکس فوری کامل از [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 )

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

محدوده مجوز

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

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