REST Resource: accounts.accountLinks
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: AccountLink
계정 링크입니다. Google Ads 고객과 호텔 광고 (Hotel Center) 계정 간의 연결을 나타냅니다. 계정 링크는 Google Ads 고객에게 연결된 Hotel Center 계정의 호텔 집합을 정의합니다.
| 필드 |
name |
string
계정 연결의 리소스 이름입니다(형식: accounts/{account_id}/accountLinks/{account_link_id}).
|
googleAdsCustomerName |
string
CREATE 요청에 필요합니다. customers/{google_ads_customer_id} 형식의 Google Ads 고객 ID를 나타내는 값입니다. 예를 들면 customers/0123456789입니다. googleAdsCustomerName 필드는 GET 요청에 대한 응답에 반환되지 않습니다.
|
status |
enum (AccountLinkStatus)
계정 연결의 현재 상태입니다.
|
accountLinkTarget |
object (AccountLinkTarget)
CREATE 요청에 필요합니다. 연결된 Google Ads 계정을 사용하여 관리할 수 있는 Hotel Center 계정의 숙박 시설입니다.
|
AccountLinkStatus
계정 연결의 가능한 현재 상태입니다. 향후에 새 값이 추가될 수 있습니다.
| 열거형 |
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 |
계정 연결이 승인되었습니다. |
AccountLinkTarget
연결된 Google Ads 계정으로 Hotel Center 계정의 모든 숙박 시설 또는 일부 숙박 시설을 관리할 수 있는지 정의합니다. 하위 집합인 경우 특정 속성이 지정됩니다.
| 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 계정의 모든 숙박 시설이 계정 연결에 제공되는 경우 True입니다. 기본값은 false입니다.
|
hotelList |
object (HotelList)
계정 연결에 사용할 수 있는 속성 목록입니다.
|
HotelList
Google Ads 계정으로 관리할 수 있는 Hotel Center 계정의 숙박 시설입니다.
| JSON 표현 |
{
"partnerHotelIds": [
string
]
} |
| 필드 |
partnerHotelIds[] |
string
호텔 ID입니다.
|
메서드 |
|
|
Hotel Center 계정과 Google Ads 계정 간에 새 계정 링크를 만듭니다. |
|
|
계정 연결을 삭제합니다. |
|
|
요청 URL에 지정된 계정 링크 리소스 이름과 연결된 AccountLink 인스턴스를 반환합니다. |
|
|
Hotel Center 계정의 계정 링크를 반환합니다. |
|
|
계정 연결의 계정 연결 타겟을 업데이트합니다. |
All rights reserved. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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. |"]]
