REST Resource: accounts.accountLinks

• Resource: AccountLink
  • JSON representation
• AccountLinkStatus
• AccountLinkTarget
  • JSON representation
• HotelList
  • JSON representation
• Methods

Resource: AccountLink

An 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.

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

Fields
name	string The resource name for the account link in the format accounts/{account_id}/accountLinks/{account_link_id}.
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.
status	enum (AccountLinkStatus) The current status of the account link.
accountLinkTarget	object (AccountLinkTarget) Required for CREATE requests. The properties in the Hotel Center account that can be managed using the linked Google Ads account.

AccountLinkStatus

Possible current statuses of the account link. New values might be added in the future.

Enums
ACCOUNT_LINK_STATUS_UNSPECIFIED	Default value.
ACCOUNT_LINK_STATUS_UNKNOWN	The account link status is not recognized by this API version.
REQUESTED_FROM_HOTEL_CENTER	The account link was initiated through Hotel Center and has not yet been approved in Google Ads.
REQUESTED_FROM_GOOGLE_ADS	The account link was initiated through Google Ads and has not yet been approved in Hotel Center.
APPROVED	The account link has been approved.

AccountLinkTarget

Defines 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.

JSON representation
{ // 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. }

Fields
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:
allHotels	boolean True if all properties under the Hotel Center account are made available to the account link. The default is false.
hotelList	object (HotelList) List of properties that is made available to the account link.

HotelList

The properties in the Hotel Center account that can be managed with the Google Ads account.

JSON representation
{ "partnerHotelIds": [ string ] }

Fields
partnerHotelIds[]	string Hotel IDs.

Methods
create	Creates a new account link between a Hotel Center account and a Google Ads account.
delete	Deletes an account link.
get	Returns the AccountLink instance associated with the account link resource name specified in the request URL.
list	Returns the account links for a Hotel Center account.
patch	Updates the account link target of an account link.