Method: inventory.partners.availability.replace

Thay thế Availability của Services hiện có. Lệnh gọi lô này không đảm bảo tính nguyên thức. Chỉ những khung giờ được cập nhật thành công mới được trả về.

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

Các tham số
parent

string

Định dạng 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)
    }
  ]
}
Các trường
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Khả năng cung cấp dịch vụ mở rộng dùng để thay thế các khung giờ hiện có.

Nội dung phản hồi

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:

Phản hồi hàng loạt để thay thế nhiều vị trí phát sóng của Service. Chỉ những khung giờ đã cập nhật thành công mới được đính kèm trong thông báo này

Biểu diễn dưới dạng JSON 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Các trường
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Các thông báo về khả năng sử dụng dịch vụ mở rộng được cập nhật thành công dùng để thay thế các khung thời gian hỗ trợ 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 tình trạng rảnh/bận và người/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)
    }
  ]
}
Các trường
merchantId

string

Đây là trường bắt buộc để chỉ định người bán nào nhận được 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ụ của thông báo về tình trạng rảnh/bận bên dưới.
startTimeRestrict

string (Timestamp format)

Nếu được cung cấp, chúng tôi sẽ coi các thực thể về Khả năng đáp ứng được cung cấp là bản tổng quan nhanh hoàn chỉnh từ [startTimeRestrict, endTimeRestrict). Điều này có nghĩa là mọi tình trạng còn hàng hiện có sẽ bị xoá nếu bạn đá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 sẽ bị hạn chế hơn nữa:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo Hạn chế tài nguyên, đ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 dùng để cập nhật toàn bộ tình trạng rảnh/bận trong một khoảng thời gian nhất định.

Việc đặt startTimeRestrict trong khi không đặt endTimeRestrict có nghĩa là mọi lúc bắt đầu từ startTimeRestrict.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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 trong khi không đặt startTimeRestrict được hiểu là luôn có nghĩa là thời gian giới hạn thời gian kết thúc.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. 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ế hơn nữa phạm vi cập nhật chỉ ở phạm vi cung cấp có thời lượng phù hợp.

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

object (Resources)

Việc đặt tài nguyên Hạn chế sẽ hạn chế hơn nữa phạm vi cập nhật chỉ cho 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 tình trạng rảnh/bận mới.