Thay thế Availability
của một Service
hiện có của một người bán do đơn vị tập hợp được chỉ định quản lý và trả lại.
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
Các tham số | |
---|---|
serviceAvailability.name |
Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo đị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 ( |
Các trường | |
---|---|
serviceAvailability.startTimeRestrict |
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:
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:
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:
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ụ: |
serviceAvailability.endTimeRestrict |
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ụ: |
serviceAvailability.durationRestrict |
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 ' |
serviceAvailability.resourcesRestrict |
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. |
serviceAvailability.availability[] |
Danh sách tình trạng rảnh/bận mới. |
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 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 |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Các trường | |
---|---|
name |
Tên tài nguyên của dịch vụ để áp dụng giá trị này. Theo định dạng |
startTimeRestrict |
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:
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:
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:
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ụ: |
endTimeRestrict |
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ụ: |
durationRestrict |
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 ' |
resourcesRestrict |
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[] |
Danh sách tình trạng rảnh/bận mới. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking