取代並傳回由指定集結網站管理的商家現有 Service
的 Availability
。
HTTP 要求
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
service |
要套用這個項目的服務的資源名稱。格式: |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "serviceAvailability": { "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer, "roomDescription": { object ( |
欄位 | |
---|---|
service |
如有提供,我們會將實體提供的供應情形視為於 [startTimeRestrict, endTimeRestrict] 擷取的完整快照。也就是說,如果以下條件皆成立,則所有現有的供應情形資料都將會刪除:
如果設定了 duration 訊息,則條件會進一步受到限制:
如果設定了 resourcesRestrict 訊息,則條件會進一步受到限制:
這些欄位通常用來提供指定時間範圍內的供應情形完整更新。 如果設定 startTimeRestrict 而不設定 endTimeRestrict,系統會解讀為一律從 startTimeRestrict 開始。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
service |
如果設定 endTimeRestrict 而不設定 startTimeRestrict,系統會解讀為一律到 endTimeRestrict 為止。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
service |
設定 duration 會進一步將更新範圍限制在相符期間內的供應情形。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
service |
設定 resourcesRestrict 會進一步將更新範圍限制在這一組資源。資源的所有 ID 欄位都必須完全相符。 |
service |
新的供應情形清單。 |
回應主體
供應情形和適用對象/時機清單。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
欄位 | |
---|---|
name |
要套用這個項目的服務的資源名稱。格式: |
start |
如有提供,我們會將實體提供的供應情形視為於 [startTimeRestrict, endTimeRestrict] 擷取的完整快照。也就是說,如果以下條件皆成立,則所有現有的供應情形資料都將會刪除:
如果設定了 duration 訊息,則條件會進一步受到限制:
如果設定了 resourcesRestrict 訊息,則條件會進一步受到限制:
這些欄位通常用來提供指定時間範圍內的供應情形完整更新。 如果設定 startTimeRestrict 而不設定 endTimeRestrict,系統會解讀為一律從 startTimeRestrict 開始。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
end |
如果設定 endTimeRestrict 而不設定 startTimeRestrict,系統會解讀為一律到 endTimeRestrict 為止。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
duration |
設定 duration 會進一步將更新範圍限制在相符期間內的供應情形。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
resources |
設定 resourcesRestrict 會進一步將更新範圍限制在這一組資源。資源的所有 ID 欄位都必須完全相符。 |
availability[] |
新的供應情形清單。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/mapsbooking