REST Resource: accounts.accountLinks
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource : AccountLink
Un lien vers votre compte. Représente l'association entre un client Google Ads et un compte Hotel Ads (Hotel Center). Un lien de compte définit l'ensemble des hôtels du compte Hotel Center associé au client Google Ads.
| Champs |
name |
string
Nom de ressource pour l'association de compte au format accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
Obligatoire pour les requêtes CREATE. Valeur représentant le numéro client Google Ads au format customers/{google_ads_customer_id}. Exemple : customers/0123456789. Notez que le champ googleAdsCustomerName n'est pas renvoyé dans les réponses aux requêtes GET.
|
status |
enum (AccountLinkStatus)
État actuel de l'association de compte.
|
accountLinkTarget |
object (AccountLinkTarget)
Obligatoire pour les requêtes CREATE. Les établissements du compte Hotel Center qui peuvent être gérés à l'aide du compte Google Ads associé.
|
AccountLinkStatus
États actuels possibles de l'association de compte. De nouvelles valeurs pourront être ajoutées à l'avenir.
| Enums |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
Valeur par défaut. |
ACCOUNT_LINK_STATUS_UNKNOWN |
L'état d'association du compte n'est pas reconnu par cette version de l'API. |
REQUESTED_FROM_HOTEL_CENTER |
L'association de compte a été initiée dans Hotel Center et n'a pas encore été approuvée dans Google Ads. |
REQUESTED_FROM_GOOGLE_ADS |
L'association de comptes a été initiée dans Google Ads, mais n'a pas encore été approuvée dans Hotel Center. |
APPROVED |
L'association de compte a été approuvée. |
AccountLinkTarget
Définit si toutes les propriétés ou un sous-ensemble de propriétés du compte Hotel Center peuvent être gérées avec le compte Google Ads associé. Si c'est un sous-ensemble, les propriétés spécifiques sont indiquées.
| Représentation 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.
} |
| Champs |
Champ d'union targets_oneof. Toutes les propriétés ou une liste de propriétés du compte Hotel Center sont mises à disposition pour l'association de compte. targets_oneof ne peut être qu'un des éléments suivants : |
allHotels |
boolean
La valeur est "true" si toutes les propriétés du compte Hotel Center sont disponibles pour l'association de compte. La valeur par défaut est false.
|
hotelList |
object (HotelList)
Liste des propriétés mises à disposition pour l'association de compte.
|
HotelList
Établissements du compte Hotel Center pouvant être gérés avec le compte Google Ads.
| Représentation JSON |
{
"partnerHotelIds": [
string
]
} |
| Champs |
partnerHotelIds[] |
string
Identifiants d'hôtels
|
Méthodes |
|
|
Crée une association de compte entre un compte Hotel Center et un compte Google Ads. |
|
|
Supprime l'association d'un compte. |
|
|
Renvoie l'instance AccountLink associée au nom de ressource d'association de compte spécifié dans l'URL de la requête. |
|
|
Renvoie les associations de compte pour un compte Hotel Center. |
|
|
Met à jour la cible de l'association de compte. |
Tous droits réservés. Java est une marque déposée d'Oracle et/ou ses affiliés.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
