REST Resource: accounts.accountLinks
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: AccountLink
یک لینک حساب کاربری نشان دهنده پیوند بین مشتری Google Ads و حساب تبلیغات هتل (مرکز هتل). پیوند حساب مجموعه ای از هتل ها را در حساب مرکز هتل تعریف می کند که به مشتری Google Ads پیوند داده شده است.
| فیلدها |
|---|
name | string نام منبع پیوند حساب در قالب accounts/{account_id}/accountLinks/{account_link_id} . |
googleAdsCustomerName | string برای ایجاد درخواست‌ها مورد نیاز است. مقداری که شناسه مشتری Google Ads را در قالب customers/{google_ads_customer_id} نشان می‌دهد. به عنوان مثال: customers/0123456789 . توجه داشته باشید که فیلد googleAdsCustomerName در پاسخ به درخواست‌های GET برگردانده نمی‌شود. |
status | enum ( AccountLinkStatus ) وضعیت فعلی پیوند حساب. |
accountLinkTarget | object ( AccountLinkTarget ) برای ایجاد درخواست‌ها مورد نیاز است. دارایی‌های موجود در حساب مرکز هتل که با استفاده از حساب Google Ads پیوند شده قابل مدیریت هستند. |
AccountLinkStatus
وضعیت های فعلی ممکن پیوند حساب. ممکن است در آینده مقادیر جدیدی اضافه شود.
| Enums |
|---|
ACCOUNT_LINK_STATUS_UNSPECIFIED | مقدار پیش فرض |
ACCOUNT_LINK_STATUS_UNKNOWN | وضعیت پیوند حساب توسط این نسخه API شناسایی نمی شود. |
REQUESTED_FROM_HOTEL_CENTER | پیوند حساب از طریق Hotel Center آغاز شده است و هنوز در Google Ads تأیید نشده است. |
REQUESTED_FROM_GOOGLE_ADS | پیوند حساب از طریق Google Ads آغاز شده است و هنوز در مرکز هتل تأیید نشده است. |
APPROVED | لینک حساب تایید شده است. |
AccountLinkTarget
تعیین می‌کند که آیا همه دارایی‌ها یا زیرمجموعه‌ای از دارایی‌ها در حساب مرکز هتل را می‌توان با حساب Google Ads مرتبط مدیریت کرد. اگر یک زیرمجموعه باشد، ویژگی های خاص مشخص می شود.
| نمایندگی 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 . همه دارایی‌ها یا فهرستی از املاک تحت حساب مرکز هتل که در پیوند حساب در دسترس است. targets_oneof تنها می تواند یکی از موارد زیر باشد: |
allHotels | boolean درست است اگر همه دارایی های تحت حساب مرکز هتل در پیوند حساب در دسترس باشد. پیش فرض false است. |
hotelList | object ( HotelList ) فهرست املاکی که برای پیوند حساب در دسترس قرار گرفته است. |
لیست هتل
دارایی‌های موجود در حساب مرکز هتل که با حساب Google Ads قابل مدیریت هستند.
| نمایندگی JSON |
|---|
{
"partnerHotelIds": [
string
]
} |
| فیلدها |
|---|
partnerHotelIds[] | string شناسه های هتل |
روش ها |
|---|
| یک پیوند حساب جدید بین حساب مرکز هتل و حساب Google Ads ایجاد می کند. |
| پیوند حساب را حذف می کند. |
| نمونه AccountLink مرتبط با نام منبع پیوند حساب مشخص شده در URL درخواست را برمی‌گرداند. |
| پیوندهای حساب را برای یک حساب مرکز هتل برمی گرداند. |
| هدف پیوند حساب پیوند حساب را به روز می کند. |
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
