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

Thay thế Availability của Service hiện có của người bán do trình tổng hợp được chỉ định quản lý và trả về Availability đó.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
serviceAvailability.name

string

Tên tài nguyên của dịch vụ cần áp dụng. Ở định dạng partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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)
      }
    ]
  }
}
Trường
serviceAvailability.startTimeRestrict

string (Timestamp format)

Nếu bạn cung cấp, chúng tôi sẽ coi các thực thể về tình trạng còn hàng là một bản tổng quan đầy đủ từ [startTimeRestrict, endTimeRestrict). Tức là tất cả tình trạng còn phòng hiện có sẽ bị xoá nếu điều kiện sau đây là đúng:

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

Nếu bạn đặt thông báo về thời lượng, điều kiện này sẽ bị hạn chế thêm:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo resourcesRestrict, thì điều kiện sẽ bị hạn chế thêm:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Các trường này thường được dùng để cung cấp thông tin cập nhật đầy đủ về tình trạng còn chỗ trong một phạm vi thời gian nhất định.

Việc đặt startTimeRestrict trong khi không đặt endTimeRestrict được hiểu là tất cả thời gian bắt đầu từ startTimeRestrict.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

serviceAvailability.endTimeRestrict

string (Timestamp format)

Việc đặt endTimeRestrict trong khi không đặt startTimeRestrict được hiểu là tất cả thời gian cho đến endTimeRestrict.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

serviceAvailability.durationRestrict

string (Duration format)

Việc đặt thời lượng sẽ hạn chế phạm vi của nội dung cập nhật chỉ còn thời gian rảnh có thời lượng khớp.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

serviceAvailability.resourcesRestrict

object (Resources)

Chế độ cài đặt resourcesRestrict (Hạn chế tài nguyên) sẽ hạn chế thêm phạm vi của bản cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.

serviceAvailability.availability[]

object (Availability)

Danh sách lịch phát sóng mới.

Nội dung phản hồi

Danh sách các ngày nghỉ và đối tượng/thời điểm áp dụng các ngày nghỉ đó.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "name": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Trường
name

string

Tên tài nguyên của dịch vụ cần áp dụng. Ở định dạng partners/{partner_id}/merchants/{merchantId}/services/{serviceId}

startTimeRestrict

string (Timestamp format)

Nếu bạn cung cấp, chúng tôi sẽ coi các thực thể về tình trạng còn hàng là một bản tổng quan đầy đủ từ [startTimeRestrict, endTimeRestrict). Tức là tất cả lịch phát sóng hiện có sẽ bị xoá nếu điều kiện sau đây là đúng:

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

Nếu bạn đặt thông báo về thời lượng, điều kiện này sẽ bị hạn chế thêm:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo resourcesRestrict, thì điều kiện sẽ bị hạn chế thêm:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Các trường này thường được dùng để cung cấp thông tin cập nhật đầy đủ về tình trạng còn chỗ trong một phạm vi thời gian nhất định.

Việc đặt startTimeRestrict trong khi không đặt endTimeRestrict được hiểu là tất cả thời gian bắt đầu từ startTimeRestrict.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

endTimeRestrict

string (Timestamp format)

Việc đặt endTimeRestrict trong khi không đặt startTimeRestrict được hiểu là tất cả thời gian cho đến endTimeRestrict.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

durationRestrict

string (Duration format)

Việc đặt thời lượng sẽ hạn chế phạm vi của nội dung cập nhật chỉ còn thời gian rảnh có thời lượng khớp.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

resourcesRestrict

object (Resources)

Chế độ cài đặt resourcesRestrict (Hạn chế tài nguyên) sẽ hạn chế thêm phạm vi của bản cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường mã nhận dạng của tài nguyên phải khớp chính xác.

availability[]

object (Availability)

Danh sách lịch phát sóng mới.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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