Method: customers.suggestTravelAssets

پیشنهادات دارایی سفر را برمی‌گرداند. پیشنهادات دارایی بر اساس بهترین تلاش بازگردانده می شوند. هیچ تضمینی وجود ندارد که تمام انواع دارایی‌های ممکن برای هر ملک خاص هتل بازگردانده شود.

درخواست HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:suggestTravelAssets

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
زمینه های
languageOption

string

ضروری. مشخصات زبان در قالب BCP 47 (به عنوان مثال، en-US، zh-CN، و غیره) برای پیشنهادات دارایی. متن به این زبان خواهد بود. معمولاً با یکی از زبان های هدف کمپین مطابقت دارد.

placeIds[]

string

شناسه مکان‌های Google Maps هتل‌هایی که دارایی برای آنها درخواست شده است. برای اطلاعات بیشتر به https://developers.google.com/places/web-service/place-id مراجعه کنید.

بدن پاسخگو

پیام پاسخ برای TravelAssetSuggestionService.SuggestTravelAssets .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
زمینه های
hotelAssetSuggestions[]

object ( HotelAssetSuggestion )

پیشنهادهای دارایی برای هر شناسه مکان ارسال شده در درخواست.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

پیشنهاد هتل دارایی

پیام حاوی پیشنهادات دارایی برای یک هتل.

نمایندگی JSON
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
زمینه های
placeId

string

شناسه Google Places هتل.

finalUrl

string

URL نهایی پیشنهادی برای AssetGroup.

hotelName

string

نام هتل به زبان درخواستی

callToAction

enum ( CallToActionType )

نوع فراخوان برای اقدام

textAssets[]

object ( HotelTextAsset )

دارایی های متنی مانند عنوان، توضیحات و غیره.

imageAssets[]

object ( HotelImageAsset )

دارایی های تصویر مانند منظره / پرتره / مربع و غیره

status

enum ( HotelAssetSuggestionStatus )

وضعیت پیشنهاد دارایی هتل.

HotelTextAsset

پیشنهاد دارایی متنی برای هتل.

نمایندگی JSON
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
زمینه های
text

string

متن دارایی به زبان درخواستی

assetFieldType

enum ( AssetFieldType )

نوع دارایی متن به عنوان مثال، عنوان، DESCRIPTION، و غیره.

HotelImageAsset

پیشنهاد دارایی تصویر واحد برای یک هتل.

نمایندگی JSON
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
زمینه های
uri

string

URI برای تصویر

assetFieldType

enum ( AssetFieldType )

نوع دارایی تصویر به عنوان مثال، MARKETING_IMAGE، PORTRAIT_MARKETING_IMAGE، و غیره.

HotelAssetSuggestionStatus

وضعیت های احتمالی پیشنهاد دارایی هتل.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
SUCCESS پیشنهاد دارایی هتل با موفقیت بازیابی شد.
HOTEL_NOT_FOUND نگاه کردن به هتل چیزی برنمی‌گرداند.
INVALID_PLACE_ID شناسه Google Places نامعتبر است و قابل رمزگشایی نیست.