Thay thế Availability
của Service
hiện có của người bán do đơn vị tập hợp đã chỉ định quản lý và trả lại hàng đó.
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 |
Tên tài nguyên của dịch vụ để áp dụng thuộc tính này. Ở định dạng |
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 }, "availability": [ { "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
Trường | |
---|---|
serviceAvailability.startTimeRestrict |
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:
Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế thêm:
Nếu bạn đặt thông báo resourceRestrict, điều kiện sẽ bị hạn chế hơn nữa:
Các trường này thường dùng để cung cấp thông tin cập nhật hoàn chỉnh về tình trạng còn hàng trong một khoảng thời gian nhất định. Việc đặt startTimeRestrict 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ụ: |
serviceAvailability.endTimeRestrict |
Việc đặt endTimeRestrict trong 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 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ụ: |
serviceAvailability.durationRestrict |
Việc đặt thời hạn sẽ hạn chế hơn nữa phạm vi cập nhật thành chỉ cung cấp nội dung có thời lượng phù hợp. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
serviceAvailability.resourcesRestrict |
Việc đặt tài nguyên Hạn chế hơn nữa sẽ giới hạn phạm vi cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác. |
serviceAvailability.availability[] |
Danh sách mới về tình trạng còn hàng. |
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:
Danh sách phạm vi cung cấp và đối tượng/thời điểm áp dụng ưu đãi.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Trường | |
---|---|
name |
Tên tài nguyên của dịch vụ để áp dụng thuộc tính này. Ở định dạng |
startTimeRestrict |
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:
Nếu bạn đặt thông báo về thời lượng, điều kiện sẽ bị hạn chế thêm:
Nếu bạn đặt thông báo resourceRestrict, điều kiện sẽ bị hạn chế hơn nữa:
Các trường này thường dùng để cung cấp thông tin cập nhật hoàn chỉnh về tình trạng còn hàng trong một khoảng thời gian nhất định. Việc đặt startTimeRestrict 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ụ: |
endTimeRestrict |
Việc đặt endTimeRestrict trong 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 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ụ: |
durationRestrict |
Việc đặt thời hạn sẽ hạn chế hơn nữa phạm vi cập nhật thành chỉ cung cấp nội dung có thời lượng phù hợp. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
resourcesRestrict |
Việc đặt tài nguyên Hạn chế hơn nữa sẽ giới hạn phạm vi cập nhật chỉ ở nhóm tài nguyên này. Tất cả các trường id của các tài nguyên phải khớp chính xác. |
availability[] |
Danh sách mới về tình trạng còn hàng. |
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking