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
  ],
  "liveOnGoogleStatus": enum (LiveOnGoogleStatus)
}
欄位
liveOnGoogle
(deprecated)

boolean

(選用步驟) 已淘汰。房源是否會顯示在 Google 上。如果為 true，Google 會在整合完成且屬性可用時顯示屬性。如果設為 false，Google 絕不會顯示這些屬性。

已由 liveOnGoogleStatus 取代。

只能設定為 liveOnGoogle 或 liveOnGoogleStatus 其中之一。如果兩者都設定，系統會使用 liveOnGoogleStatus。
partnerHotelIds[]

string

必填。識別要使用 liveOnGoogle 設定更新的屬性。
liveOnGoogleStatus

enum (LiveOnGoogleStatus)

(選用步驟) 屬性是否會顯示在 Google 上，且控制項比原始 liveOnGoogle 布林值欄位更精細。

只能設定為 liveOnGoogle 或 liveOnGoogleStatus 其中之一。如果兩者都設定，系統會使用 liveOnGoogleStatus。

注意：這個欄位應以引號括住。例如："LIVE_ON_GOOGLE_STATUS_INACTIVE"。

回應主體

HotelService.SetLiveOnGoogle 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "updatedHotelIds": [
    string
  ],
  "failedHotelIds": [
    string
  ]
}
欄位
updatedHotelIds[]

string

識別更新的屬性。
failedHotelIds[]

string

指出 Google 無法更新的屬性。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/travelpartner

詳情請參閱OAuth 2.0 Overview。