Method: accounts.hotels.setLiveOnGoogle
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產品素材資源集合層級的自訂方法,用於更新多項資源的「在 Google 上刊登」狀態。每次通話都能開啟或關閉多間飯店。如要開啟部分飯店並關閉部分飯店,就必須多次呼叫。
HTTP 要求
POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
account |
string
必要,帳戶的資源名稱。格式為 accounts/{account_id}。
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"liveOnGoogle": boolean,
"partnerHotelIds": [
string
]
} |
欄位 |
liveOnGoogle |
boolean
必要,是否要在 Google 上顯示資源。如果為 true,Google 會顯示整合作業已完成且可供使用的資源。如果設為 False,Google 一律不會顯示屬性。
|
partnerHotelIds[] |
string
必要,透過 LiveOnGoogle 設定來識別要更新的屬性。
|
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
{
"updatedHotelIds": [
string
],
"failedHotelIds": [
string
]
} |
欄位 |
updatedHotelIds[] |
string
用於識別更新後的屬性。
|
failedHotelIds[] |
string
指出 Google 無法更新的資源。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/travelpartner
詳情請參閱 OAuth 2.0 總覽。
保留所有權利。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2022-08-23 (世界標準時間)。
[null,null,["上次更新時間:2022-08-23 (世界標準時間)。"],[[["\u003cp\u003eThis method allows you to update the "Live on Google" status for multiple hotel properties, enabling or disabling their visibility on Google.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify whether to show or hide properties on Google using the \u003ccode\u003eliveOnGoogle\u003c/code\u003e boolean field in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe request body also requires a list of \u003ccode\u003epartnerHotelIds\u003c/code\u003e to identify the specific properties to update.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes lists of successfully updated (\u003ccode\u003eupdatedHotelIds\u003c/code\u003e) and failed (\u003ccode\u003efailedHotelIds\u003c/code\u003e) hotel properties.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/travelpartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.hotels.setLiveOnGoogle\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SetLiveOnGoogleResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nCollection-level custom method to update the Live on Google status for multiple properties. Each call can turn on or off multiple hotels. To turn some hotels on and turn some hotels off, you will have to make multiple calls.\n\n### HTTP request\n\n`POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------|\n| `account` | `string` Required. The resource name of the account. The format is accounts/{account_id}. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"liveOnGoogle\": boolean, \"partnerHotelIds\": [ string ], \"liveOnGoogleStatus\": enum (/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#LiveOnGoogleStatus) } ``` |\n\n| Fields ||\n|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `liveOnGoogle` **(deprecated)** | `boolean` Optional. DEPRECATED. Whether the property will show on Google. When true, Google will show the properties if their integration is complete and the property is available. When false, Google will never show the properties. Superseded by `liveOnGoogleStatus`. Only one of `liveOnGoogle` or `liveOnGoogleStatus` should be set; if both are set, `liveOnGoogleStatus` will be used. |\n| `partnerHotelIds[]` | `string` Required. Identifies the properties to update with the liveOnGoogle setting. |\n| `liveOnGoogleStatus` | `enum (`[LiveOnGoogleStatus](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#LiveOnGoogleStatus)`)` Optional. Whether the property will show on Google, with more granular controls than the original `liveOnGoogle` boolean field. Only one of `liveOnGoogle` or `liveOnGoogleStatus` should be set; if both are set, `liveOnGoogleStatus` will be used. **Note:** This field should be enclosed in quotes. For example, `\"LIVE_ON_GOOGLE_STATUS_INACTIVE\"`. |\n\n### Response body\n\nResponse message for [HotelService.SetLiveOnGoogle](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotels/setLiveOnGoogle#google.travel.travelpartner.v3.HotelService.SetLiveOnGoogle).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------|\n| ``` { \"updatedHotelIds\": [ string ], \"failedHotelIds\": [ string ] } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------|\n| `updatedHotelIds[]` | `string` Identifies the updated properties. |\n| `failedHotelIds[]` | `string` Identifies properties that Google could not update. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/travelpartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]