REST Resource: accounts.accountLinks
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: AccountLink
Tautan akun. Mewakili penautan antara pelanggan Google Ads dan akun Iklan Hotel (Pusat Pengelolaan Hotel). Penautan akun menentukan kumpulan hotel dalam akun Pusat Pengelolaan Hotel yang ditautkan ke pelanggan Google Ads.
| Kolom |
name |
string
Nama resource untuk penautan akun dalam format accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
Wajib untuk permintaan CREATE. Nilai yang merepresentasikan ID pelanggan Google Ads dalam format customers/{google_ads_customer_id}. Contoh: customers/0123456789. Perhatikan bahwa kolom googleAdsCustomerName tidak ditampilkan dalam respons terhadap permintaan GET.
|
status |
enum (AccountLinkStatus)
Status penautan akun saat ini.
|
accountLinkTarget |
object (AccountLinkTarget)
Wajib untuk permintaan CREATE. Properti di akun Pusat Pengelolaan Hotel yang dapat dikelola menggunakan akun Google Ads tertaut.
|
AccountLinkStatus
Kemungkinan status saat ini dari penautan akun. Nilai baru mungkin ditambahkan pada masa mendatang.
| Enum |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
Nilai default. |
ACCOUNT_LINK_STATUS_UNKNOWN |
Status penautan akun tidak dikenali oleh versi API ini. |
REQUESTED_FROM_HOTEL_CENTER |
Penautan akun dimulai melalui Pusat Pengelolaan Hotel dan belum disetujui di Google Ads. |
REQUESTED_FROM_GOOGLE_ADS |
Penautan akun dimulai melalui Google Ads dan belum disetujui di Pusat Pengelolaan Hotel. |
APPROVED |
Penautan akun telah disetujui. |
AccountLinkTarget
Menentukan apakah semua properti atau subset properti di akun Pusat Pengelolaan Hotel dapat dikelola dengan akun Google Ads tertaut. Jika subset, properti tertentu akan ditentukan.
| Representasi 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.
} |
| Kolom |
Kolom union targets_oneof. Semua properti atau daftar properti di akun Pusat Pengelolaan Hotel yang tersedia untuk penautan akun. targets_oneof hanya dapat berupa salah satu dari berikut: |
allHotels |
boolean
Benar jika semua properti di akun Pusat Pengelolaan Hotel tersedia untuk penautan akun. Defaultnya adalah false.
|
hotelList |
object (HotelList)
Daftar properti yang tersedia untuk penautan akun.
|
HotelList
Properti di akun Pusat Pengelolaan Hotel yang dapat dikelola dengan akun Google Ads.
| Representasi JSON |
{
"partnerHotelIds": [
string
]
} |
| Kolom |
partnerHotelIds[] |
string
ID Hotel.
|
Metode |
|
|
Membuat penautan akun baru antara akun Pusat Pengelolaan Hotel dan akun Google Ads. |
|
|
Menghapus penautan akun. |
|
|
Menampilkan instance AccountLink yang terkait dengan nama resource penautan akun yang ditentukan di URL permintaan. |
|
|
Menampilkan link akun untuk akun Pusat Pengelolaan Hotel. |
|
|
Memperbarui target penautan akun dari penautan akun. |
Semua hak dilindungi undang-undang. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
