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