REST Resource: accounts.accountLinks
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: AccountLink
تمثّل هذه السمة رابط حساب. تمثّل هذه السمة الرابط بين عميل على "إعلانات Google" وحساب على "إعلانات الفنادق" (Hotel Center). يحدّد رابط الحساب مجموعة الفنادق ضمن حساب Hotel Center المرتبط بعميل "إعلانات Google".
| الحقول |
name |
string
اسم المرجع لرابط الحساب بالتنسيق accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
مطلوبة لطلبات CREATE. القيمة التي تمثّل الرقم التعريفي لعميل "إعلانات Google" بالتنسيق customers/{google_ads_customer_id}. على سبيل المثال: customers/0123456789. يُرجى العِلم أنّه لا يتم عرض الحقل googleAdsCustomerName في الردود على طلبات GET.
|
status |
enum (AccountLinkStatus)
الحالة الحالية لربط الحساب
|
accountLinkTarget |
object (AccountLinkTarget)
مطلوبة لطلبات CREATE. المواقع في حساب Hotel Center التي يمكن إدارتها باستخدام حساب "إعلانات Google" المرتبط
|
AccountLinkStatus
الحالات الحالية المحتملة لربط الحساب قد تتم إضافة قيم جديدة في المستقبل.
| عمليات التعداد |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
القيمة التلقائية |
ACCOUNT_LINK_STATUS_UNKNOWN |
لا تتعرّف إصدار واجهة برمجة التطبيقات هذا على حالة ربط الحساب. |
REQUESTED_FROM_HOTEL_CENTER |
تم بدء ربط الحساب من خلال Hotel Center ولم تتم الموافقة عليه بعد في "إعلانات Google". |
REQUESTED_FROM_GOOGLE_ADS |
تم بدء ربط الحساب من خلال "إعلانات Google" ولم تتم الموافقة عليه بعد في Hotel Center. |
APPROVED |
تمت الموافقة على ربط الحساب. |
AccountLinkTarget
تحدّد هذه السمة ما إذا كان يمكن إدارة جميع المواقع أو مجموعة فرعية من المواقع في حساب Hotel Center باستخدام حساب "إعلانات Google" المرتبط. إذا كانت مجموعة فرعية، يتم تحديد السمات المحدّدة.
| تمثيل 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 إما جميع الفنادق أو قائمة بالفنادق ضمن حساب Hotel Center الذي يتم إتاحته لربط الحساب. يمكن أن تكون targets_oneof إحدى القيم التالية فقط: |
allHotels |
boolean
تعرض القيمة "صحيح" إذا تم إتاحة جميع المواقع ضمن حساب "مركز إدارة معلومات الفنادق" لعملية ربط الحساب. القيمة التلقائية هي false.
|
hotelList |
object (HotelList)
قائمة المواقع التي يتم إتاحتها لربط الحساب.
|
HotelList
المواقع في حساب Hotel Center التي يمكن إدارتها باستخدام حساب "إعلانات Google"
| تمثيل JSON |
{
"partnerHotelIds": [
string
]
} |
| الحقول |
partnerHotelIds[] |
string
معرّفات الفنادق
|
الطُرق |
|
|
تنشئ هذه الطريقة رابط حساب جديدًا بين حساب على Hotel Center وحساب على "إعلانات Google". |
|
|
يحذف هذا الإجراء رابط حساب. |
|
|
تعرض هذه الطريقة مثيل AccountLink المرتبط باسم مورد ربط الحساب المحدّد في عنوان URL للطلب. |
|
|
تعرض هذه الطريقة روابط الحسابات لحساب على Hotel Center. |
|
|
تعدّل هذه الطريقة هدف ربط الحساب في عملية ربط الحساب. |
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
