REST Resource: accounts.accountLinks

• 資源：AccountLink
  • JSON 表示法
• AccountLinkStatus
• AccountLinkTarget
  • JSON 表示法
• HotelList
  • JSON 表示法
• 方法

資源：AccountLink

帳戶連結。代表 Google Ads 客戶與飯店廣告 (Hotel Center) 帳戶之間的連結。帳戶連結會定義 Hotel Center 帳戶所連結的 Google Ads 客戶飯店組合。

JSON 表示法
{ "name": string, "googleAdsCustomerName": string, "status": enum (AccountLinkStatus), "accountLinkTarget": { object (AccountLinkTarget) } }

欄位
name	string 帳戶連結的資源名稱，格式為 accounts/{account_id}/accountLinks/{account_link_id}。
googleAdsCustomerName	string 建立要求時必須提供。代表 Google Ads 客戶 ID 的值，格式為 customers/{google_ads_customer_id}。例如：customers/0123456789。 請注意，回應 GET 要求時不會傳回 googleAdsCustomerName 欄位。
status	enum (AccountLinkStatus) 帳戶連結的目前狀態。
accountLinkTarget	object (AccountLinkTarget) 建立要求時必須提供。使用已連結 Google Ads 帳戶管理 Hotel Center 帳戶的資源。

帳戶連結狀態

帳戶連結的目前狀態。我們日後可能會增加新的值。

列舉
ACCOUNT_LINK_STATUS_UNSPECIFIED	預設值。
ACCOUNT_LINK_STATUS_UNKNOWN	這個 API 版本無法辨識帳戶連結狀態。
REQUESTED_FROM_HOTEL_CENTER	帳戶連結是透過 Hotel Center 啟動，但尚未在 Google Ads 中獲得核准。
REQUESTED_FROM_GOOGLE_ADS	這個帳戶是透過 Google Ads 發起，但尚未在 Hotel Center 中核准。
APPROVED	帳戶連結已獲得核准。

帳戶連結目標

定義 Hotel Center 帳戶中的所有資源或部分資源是否能透過已連結的 Google Ads 帳戶管理。如果已有子集，則會指定特定屬性。

JSON 表示法
{ // Union field targets_oneof can be only one of the following: "allHotels": boolean, "hotelList": { object (HotelList) } // End of list of possible types for union field targets_oneof. }

欄位
聯集欄位 targets_oneof。Hotel Center 帳戶下可供帳戶連結使用的所有資源或清單清單。targets_oneof 只能是下列其中一項：
allHotels	boolean 如果在帳戶連結時，則可使用 Hotel Center 帳戶中的所有資源。預設為 false。
hotelList	object (HotelList) 可供帳戶連結的房源清單。

飯店清單

使用 Google Ads 帳戶管理的飯店 Hotel Center 帳戶房源。

JSON 表示法
{ "partnerHotelIds": [ string ] }

欄位
partnerHotelIds[]	string 飯店 ID。

方法
create	在 Hotel Center 帳戶和 Google Ads 帳戶之間建立新的帳戶連結。
delete	刪除帳戶連結。
get	傳回與要求網址中指定的帳戶連結資源名稱相關聯的 AccountLink 執行個體。
list	傳回 Hotel Center 帳戶的帳戶連結。
patch	更新帳戶連結的帳戶連結目標。