REST Resource: accounts.accountLinks
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: AccountLink
Một mối liên kết tài khoản. Biểu thị mối liên kết giữa một khách hàng Google Ads và một tài khoản Quảng cáo khách sạn (Hotel Center). Mối liên kết tài khoản xác định nhóm khách sạn trong tài khoản Hotel Center được liên kết với khách hàng Google Ads.
| Trường |
name |
string
Tên tài nguyên cho mối liên kết tài khoản theo định dạng accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
Bắt buộc đối với các yêu cầu CREATE. Giá trị đại diện cho mã khách hàng Google Ads ở định dạng customers/{google_ads_customer_id}. Ví dụ: customers/0123456789. Xin lưu ý rằng trường googleAdsCustomerName không được trả về trong các phản hồi cho yêu cầu GET.
|
status |
enum (AccountLinkStatus)
Trạng thái hiện tại của mối liên kết tài khoản.
|
accountLinkTarget |
object (AccountLinkTarget)
Bắt buộc đối với các yêu cầu CREATE. Các cơ sở lưu trú trong tài khoản Hotel Center mà bạn có thể quản lý bằng tài khoản Google Ads được liên kết.
|
AccountLinkStatus
Các trạng thái hiện tại có thể có của mối liên kết tài khoản. Các giá trị mới có thể được thêm vào trong tương lai.
| Enum |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
Giá trị mặc định. |
ACCOUNT_LINK_STATUS_UNKNOWN |
Phiên bản API này không nhận dạng được trạng thái liên kết tài khoản. |
REQUESTED_FROM_HOTEL_CENTER |
Yêu cầu liên kết tài khoản được gửi qua Hotel Center và chưa được phê duyệt trong Google Ads. |
REQUESTED_FROM_GOOGLE_ADS |
Yêu cầu liên kết tài khoản được gửi qua Google Ads và chưa được phê duyệt trong Hotel Center. |
APPROVED |
Yêu cầu liên kết tài khoản đã được phê duyệt. |
AccountLinkTarget
Xác định xem bạn có thể quản lý tất cả cơ sở lưu trú hay một nhóm cơ sở lưu trú trong tài khoản Hotel Center bằng tài khoản Google Ads được liên kết hay không. Nếu là một tập hợp con, bạn phải chỉ định các thuộc tính cụ thể.
| Biểu diễn dưới dạng 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.
} |
| Trường |
Trường nhóm targets_oneof. Tất cả cơ sở lưu trú hoặc danh sách cơ sở lưu trú trong tài khoản Hotel Center được cung cấp cho mối liên kết tài khoản. targets_oneof chỉ có thể là một trong những trạng thái sau: |
allHotels |
boolean
Giá trị là true nếu tất cả các cơ sở lưu trú trong tài khoản Hotel Center đều được cung cấp cho mối liên kết tài khoản. Mặc định là false.
|
hotelList |
object (HotelList)
Danh sách các tài sản được cung cấp cho mối liên kết tài khoản.
|
HotelList
Các cơ sở lưu trú trong tài khoản Hotel Center mà bạn có thể quản lý bằng tài khoản Google Ads.
| Biểu diễn dưới dạng JSON |
{
"partnerHotelIds": [
string
]
} |
| Trường |
partnerHotelIds[] |
string
Mã khách sạn.
|
Phương thức |
|
|
Tạo một mối liên kết tài khoản mới giữa tài khoản Hotel Center và tài khoản Google Ads. |
|
|
Xoá một mối liên kết tài khoản. |
|
|
Trả về thực thể AccountLink được liên kết với tên tài nguyên liên kết tài khoản được chỉ định trong URL yêu cầu. |
|
|
Trả về các mối liên kết tài khoản cho một tài khoản Hotel Center. |
|
|
Cập nhật mục tiêu liên kết tài khoản của một mối liên kết tài khoản. |
Mọi quyền được bảo lưu. Java là một nhãn hiệu đã đăng ký của Oracle và/hoặc chi nhánh của Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eAccountLink represents the connection between a Google Ads customer and a Hotel Ads (Hotel Center) account, defining the managed hotels.\u003c/p\u003e\n"],["\u003cp\u003eAccountLinkTarget specifies whether all or a subset of Hotel Center properties are managed by the linked Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eAccountLinkStatus indicates the current state of the link, such as requested, approved, or unknown.\u003c/p\u003e\n"],["\u003cp\u003eHotelList identifies the specific hotels within the Hotel Center account that are accessible through the account link.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage account links using methods like create, delete, get, list, and patch to control the Google Ads and Hotel Center connection.\u003c/p\u003e\n"]]],[],null,["# REST Resource: accounts.accountLinks\n\n- [Resource: AccountLink](#AccountLink)\n - [JSON representation](#AccountLink.SCHEMA_REPRESENTATION)\n- [AccountLinkStatus](#AccountLinkStatus)\n- [AccountLinkTarget](#AccountLinkTarget)\n - [JSON representation](#AccountLinkTarget.SCHEMA_REPRESENTATION)\n- [HotelList](#HotelList)\n - [JSON representation](#HotelList.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AccountLink\n---------------------\n\nAn account link. Represents the link between a Google Ads customer and a Hotel Ads (Hotel Center) account. An account link defines the set of hotels under the Hotel Center account that is linked to the Google Ads customer.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"googleAdsCustomerName\": string, \"status\": enum (/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#AccountLinkStatus), \"accountLinkTarget\": { object (/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#AccountLinkTarget) } } ``` |\n\n| Fields ||\n|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name for the account link in the format `accounts/{account_id}/accountLinks/{account_link_id}`. |\n| `googleAdsCustomerName` | `string` Required for CREATE requests. The value representing the Google Ads customer ID in the format `customers/{google_ads_customer_id}`. For example: `customers/0123456789`. Note that the `googleAdsCustomerName` field is not returned in responses to GET requests. |\n| `status` | `enum (`[AccountLinkStatus](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#AccountLinkStatus)`)` The current status of the account link. |\n| `accountLinkTarget` | `object (`[AccountLinkTarget](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#AccountLinkTarget)`)` Required for CREATE requests. The properties in the Hotel Center account that can be managed using the linked Google Ads account. |\n\nAccountLinkStatus\n-----------------\n\nPossible current statuses of the account link. New values might be added in the future.\n\n| Enums ||\n|-----------------------------------|--------------------------------------------------------------------------------------------------|\n| `ACCOUNT_LINK_STATUS_UNSPECIFIED` | Default value. |\n| `ACCOUNT_LINK_STATUS_UNKNOWN` | The account link status is not recognized by this API version. |\n| `REQUESTED_FROM_HOTEL_CENTER` | The account link was initiated through Hotel Center and has not yet been approved in Google Ads. |\n| `REQUESTED_FROM_GOOGLE_ADS` | The account link was initiated through Google Ads and has not yet been approved in Hotel Center. |\n| `APPROVED` | The account link has been approved. |\n\nAccountLinkTarget\n-----------------\n\nDefines whether all properties or a subset of properties in the Hotel Center account can be managed with the linked Google Ads account. If a subset, the specific properties are specified.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `targets_oneof` can be only one of the following: \"allHotels\": boolean, \"hotelList\": { object (/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#HotelList) } // End of list of possible types for union field `targets_oneof`. } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `targets_oneof`. Either all properties or a list of properties under the Hotel Center account that is made available to the account link. `targets_oneof` can be only one of the following: ||\n| `allHotels` | `boolean` True if all properties under the Hotel Center account are made available to the account link. The default is `false`. |\n| `hotelList` | `object (`[HotelList](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks#HotelList)`)` List of properties that is made available to the account link. |\n\nHotelList\n---------\n\nThe properties in the Hotel Center account that can be managed with the Google Ads account.\n\n| JSON representation |\n|-------------------------------------------|\n| ``` { \"partnerHotelIds\": [ string ] } ``` |\n\n| Fields ||\n|---------------------|---------------------|\n| `partnerHotelIds[]` | `string` Hotel IDs. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|\n| ### [create](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks/create) | Creates a new account link between a Hotel Center account and a Google Ads account. |\n| ### [delete](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks/delete) | Deletes an account link. |\n| ### [get](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks/get) | Returns the `AccountLink` instance associated with the account link resource name specified in the request URL. |\n| ### [list](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks/list) | Returns the account links for a Hotel Center account. |\n| ### [patch](/hotels/hotel-prices/api-reference/rest/v3/accounts.accountLinks/patch) | Updates the account link target of an account link. |"]]
