REST Resource: accounts.accountLinks
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: AccountLink
קישור לחשבון. מייצג את הקישור בין לקוח Google Ads לבין חשבון במרכז המודעות להזמנת חדרים (Hotel Center). קישור חשבון מגדיר את קבוצת המלונות בחשבון Hotel Center שמקושר ללקוח Google Ads.
| שדות |
name |
string
שם המשאב של קישור החשבון בפורמט accounts/{account_id}/accountLinks/{account_link_id}.
|
googleAdsCustomerName |
string
נדרש לבקשות CREATE. הערך שמייצג את מספר הלקוח ב-Google Ads בפורמט customers/{google_ads_customer_id}. לדוגמה: customers/0123456789 הערה: השדה googleAdsCustomerName לא מוחזר בתגובות לבקשות GET.
|
status |
enum (AccountLinkStatus)
הסטטוס הנוכחי של קישור החשבון.
|
accountLinkTarget |
object (AccountLinkTarget)
נדרש לבקשות CREATE. הנכסים בחשבון Hotel Center שאפשר לנהל באמצעות חשבון Google Ads המקושר.
|
AccountLinkStatus
הסטטוסים הנוכחיים האפשריים של קישור החשבון. יכול להיות שבעתיד יתווספו ערכים חדשים.
| טיפוסים בני מנייה (enum) |
ACCOUNT_LINK_STATUS_UNSPECIFIED |
ערך ברירת המחדל. |
ACCOUNT_LINK_STATUS_UNKNOWN |
סטטוס הקישור של החשבון לא מזוהה על ידי גרסת ה-API הזו. |
REQUESTED_FROM_HOTEL_CENTER |
הקישור לחשבון נוצר דרך Hotel Center ועדיין לא אושר ב-Google Ads. |
REQUESTED_FROM_GOOGLE_ADS |
הקישור לחשבון נוצר דרך Google Ads ועדיין לא אושר ב-Hotel Center. |
APPROVED |
הקישור לחשבון אושר. |
AccountLinkTarget
הגדרה שקובעת אם אפשר לנהל את כל הנכסים או קבוצת משנה של נכסים בחשבון Hotel Center באמצעות חשבון 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. כל הנכסים או רשימת נכסים בחשבון Hotel Center שזמינים לקישור החשבון. הערך targets_oneof יכול להיות רק אחד מהבאים: |
allHotels |
boolean
הערך הוא True אם כל הנכסים בחשבון Hotel Center זמינים לקישור לחשבון. ערך ברירת המחדל הוא false.
|
hotelList |
object (HotelList)
רשימת הנכסים שזמינה לקישור לחשבון.
|
HotelList
הנכסים בחשבון Hotel Center שאפשר לנהל באמצעות חשבון Google Ads.
| ייצוג ב-JSON |
{
"partnerHotelIds": [
string
]
} |
| שדות |
partnerHotelIds[] |
string
מזהי מלונות.
|
Methods |
|
|
יצירת קישור חדש בין חשבון Hotel Center לבין חשבון Google Ads. |
|
|
מחיקת קישור לחשבון. |
|
|
הפונקציה מחזירה את מופע AccountLink שמשויך לשם משאב קישור החשבון שצוין בכתובת ה-URL של הבקשה. |
|
|
מחזירה את קישורי החשבון לחשבון Hotel Center. |
|
|
עדכון של יעד קישור החשבון בקישור לחשבון. |
כל הזכויות שמורות. Java הוא סימן מסחרי רשום של Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
