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 sẽ chỉ trả về những khung giờ có thể đặt lịch hẹn đã được 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 với 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ỉ những khoảng thời gian đã cập nhật thành công mới được đưa vào thông báo 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ập nhật thành công thông báo về phạm vi cung cấp dịch vụ mở rộng để thay thế các khung giờ cung cấp 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 còn hàng 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 mà các thông báo về tình trạng còn hàng bên dưới thuộc về.
serviceId

string

Đây là trường bắt buộc mà bạn phải chỉ định để cho biết dịch vụ nào mà các thông báo về tình trạng còn hà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ể Lịch rảnh/bận được cung cấp là ảnh chụp nhanh đầ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 sẽ bị hạn chế hơn nữa:

  availability.duration == durationRestrict

Nếu bạn đặt thông báo resourcesRestrict, đ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 hàng 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
endTimeRestrict

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
durationRestrict

string (Duration format)

Việc đặt thời lượng sẽ hạn chế thêm phạm vi cập nhật chỉ đối với những khoảng thời gian rảnh/bận có thời lượng trù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)

Setting resourcesRestrict chỉ giới hạn thêm phạm vi cập nhật 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 hoàn toàn khớp.
availability[]

object (Availability)

Danh sách mới về tình trạng còn phòng.