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.
} |
| ช่อง |
ฟิลด์ Union targets_oneof ที่พักทั้งหมดหรือรายการที่พักในบัญชี Hotel Center ที่พร้อมใช้งานสำหรับการลิงก์บัญชี targets_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
allHotels |
boolean
เป็นจริงหากมีการทำให้ที่พักทั้งหมดในบัญชี Hotel Center พร้อมใช้งานสำหรับการลิงก์บัญชี โดยมีค่าเริ่มต้นเป็น false
|
hotelList |
object (HotelList)
รายการพร็อพเพอร์ตี้ที่พร้อมใช้งานสำหรับการลิงก์บัญชี
|
HotelList
ที่พักในบัญชี Hotel Center ที่จัดการด้วยบัญชี Google Ads ได้
| การแสดง JSON |
{
"partnerHotelIds": [
string
]
} |
| ช่อง |
partnerHotelIds[] |
string
รหัสโรงแรม
|
เมธอด |
|
|
สร้างลิงก์บัญชีใหม่ระหว่างบัญชี 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. |"]]
