Method: inventory.partners.availability.replace

Thay thế Availability của Services hiện có. Lệnh gọi hàng loạt này không đảm bảo tính nguyên tử. Hệ thống chỉ trả về những khung giờ trống đã cập nhật thành công.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
parent

string

Định dạng của partners/{partner_id}.

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 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Trường
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Thời gian cung cấp dịch vụ mở rộng được dùng để thay thế các khung giờ cung cấp dịch vụ hiện có.

Nội dung phản hồi

Phản hồi hàng loạt để thay thế nhiều khung giờ trống của Service. Chỉ các ô được cập nhật thành công mới được đưa vào thư này

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 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Trường
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Các thông báo về tình trạng cung cấp dịch vụ mở rộng đã được cập nhật thành công được dùng để thay thế các khung giờ trống hiện có.

Phạm vi uỷ quyền

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

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

ExtendedServiceAvailability

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

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

string

Đây là trường bắt buộc để chỉ định người bán sở hữu thông báo về tình trạng còn hàng ở bên dưới.
serviceId

string

Đây là trường bắt buộc để chỉ định dịch vụ mà thông báo về tình trạng còn phòng ở bên dưới thuộc về.
startTimeRestrict

string (Timestamp format)

Nếu được cung cấp, chúng tôi sẽ coi các thực thể Tình trạng rảnh/bận được cung cấp là thông tin tổng quan nhanh hoàn chỉnh từ [startTimeRestrict, endTimeRestrict). Tức là tất cả tình trạng còn hàng hiện có đều sẽ bị xoá nếu đáp ứng điều kiện sau:

   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 resourceRestrict, điều kiện sẽ bị hạn chế hơn nữa:

   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à toàn bộ thời gian bắt đầu từ startTimeRestrict.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

Việc đặt endTimeRestrict khi không đặt startTimeRestrict không được hiểu là có nghĩa là toàn bộ 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" và "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.