REST Resource: accounts.accountLinks
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: AccountLink
Es un vínculo de la cuenta. Representa la vinculación entre un cliente de Google Ads y una cuenta de Hotel Ads (Hotel Center). Un vínculo de la cuenta define el conjunto de hoteles de la cuenta de Hotel Center que está vinculada al cliente de Google Ads.
| Campos |
name |
string
Nombre del recurso de la vinculación de la cuenta en el formato accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
Se requiere para las solicitudes de CREATE. Es el valor que representa el ID de cliente de Google Ads en el formato customers/{google_ads_customer_id}. Por ejemplo: customers/0123456789. Ten en cuenta que el campo googleAdsCustomerName no se devuelve en las respuestas a las solicitudes GET.
|
status |
enum (AccountLinkStatus)
Es el estado actual de la vinculación de la cuenta.
|
accountLinkTarget |
object (AccountLinkTarget)
Se requiere para las solicitudes de CREATE. Son las propiedades de la cuenta de Hotel Center que se pueden administrar con la cuenta de Google Ads vinculada.
|
AccountLinkStatus
Son los posibles estados actuales de la vinculación de la cuenta. Es posible que se agreguen valores nuevos en el futuro.
| Enumeraciones |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
Valor predeterminado |
ACCOUNT_LINK_STATUS_UNKNOWN |
La API no reconoce el estado de la vinculación de la cuenta. |
REQUESTED_FROM_HOTEL_CENTER |
La vinculación de la cuenta se inició a través de Hotel Center y aún no se aprobó en Google Ads. |
REQUESTED_FROM_GOOGLE_ADS |
La vinculación de la cuenta se inició a través de Google Ads y aún no se aprobó en Hotel Center. |
APPROVED |
Se aprobó la vinculación de la cuenta. |
AccountLinkTarget
Define si todas las propiedades o un subconjunto de propiedades de la cuenta de Hotel Center se pueden administrar con la cuenta de Google Ads vinculada. Si es un subconjunto, se especifican las propiedades específicas.
| Representación 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.
} |
| Campos |
Campo de unión targets_oneof. Todas las propiedades o una lista de propiedades de la cuenta de Hotel Center que se pone a disposición de la vinculación de la cuenta Las direcciones (targets_oneof) solo pueden ser una de las siguientes opciones: |
allHotels |
boolean
Es verdadero si todas las propiedades de la cuenta de Hotel Center están disponibles para la vinculación de la cuenta. El valor predeterminado es false.
|
hotelList |
object (HotelList)
Es la lista de propiedades que se pone a disposición de la vinculación de la cuenta.
|
HotelList
Son las propiedades de la cuenta de Hotel Center que se pueden administrar con la cuenta de Google Ads.
| Representación JSON |
{
"partnerHotelIds": [
string
]
} |
| Campos |
partnerHotelIds[] |
string
Son los IDs de hotel.
|
Métodos |
|
|
Crea una nueva vinculación de cuenta entre una cuenta de Hotel Center y una cuenta de Google Ads. |
|
|
Borra una vinculación de la cuenta. |
|
|
Devuelve la instancia de AccountLink asociada con el nombre del recurso de la vinculación de la cuenta especificado en la URL de la solicitud. |
|
|
Devuelve los vínculos de la cuenta de una cuenta de Hotel Center. |
|
|
Actualiza el destino de la vinculación de una cuenta. |
Todos los derechos reservados. Java es una marca comercial de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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. |"]]
