REST Resource: accounts.accountLinks

• منبع: AccountLink
  • نمایندگی JSON
• AccountLinkStatus
• AccountLinkTarget
  • نمایندگی JSON
• لیست هتل
  • نمایندگی JSON
• مواد و روش ها

منبع: AccountLink

یک لینک حساب کاربری نشان دهنده پیوند بین مشتری Google Ads و حساب تبلیغات هتل (مرکز هتل). پیوند حساب مجموعه ای از هتل ها را در حساب مرکز هتل تعریف می کند که به مشتری Google Ads پیوند داده شده است.

نمایندگی JSON
{ "name": string, "googleAdsCustomerName": string, "status": enum (AccountLinkStatus), "accountLinkTarget": { object (AccountLinkTarget) } }

زمینه های
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. }

زمینه های
Union field targets_oneof . همه دارایی‌ها یا فهرستی از املاک تحت حساب مرکز هتل که در پیوند حساب در دسترس است. targets_oneof تنها می تواند یکی از موارد زیر باشد:
allHotels	boolean درست است اگر همه دارایی های تحت حساب مرکز هتل در پیوند حساب در دسترس باشد. پیش فرض false است.
hotelList	object ( HotelList ) فهرست املاکی که برای پیوند حساب در دسترس قرار گرفته است.

لیست هتل

دارایی‌های موجود در حساب مرکز هتل که با حساب Google Ads قابل مدیریت هستند.

نمایندگی JSON
{ "partnerHotelIds": [ string ] }

زمینه های
partnerHotelIds[]	string شناسه های هتل

مواد و روش ها
create	یک پیوند حساب جدید بین حساب مرکز هتل و حساب Google Ads ایجاد می کند.
delete	پیوند حساب را حذف می کند.
get	نمونه AccountLink مرتبط با نام منبع پیوند حساب مشخص شده در URL درخواست را برمی‌گرداند.
list	پیوندهای حساب را برای یک حساب مرکز هتل برمی گرداند.
patch	هدف پیوند حساب پیوند حساب را به روز می کند.