Method: customers.suggestTravelAssets

عرض اقتراحات مواد عرض السفر. يتمّ عرض اقتراحات مواد العرض وفقًا لأفضل الإمكانيات المتاحة. ما مِن ضمانات بإرجاع جميع أنواع مواد العرض المحتملة لأي فندق معيّن.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
الحقول
languageOption

string

مطلوبة. مواصفات اللغة بتنسيق BCP 47 (على سبيل المثال، en-US وzh-CN وما إلى ذلك) لاقتراحات مواد العرض. سيكون النص بهذه اللغة. عادةً ما تتطابق مع إحدى اللغات المستهدفة للحملة.
placeIds[]

string

أرقام تعريف أماكن "خرائط Google" للفنادق التي يتمّ طلب مواد عرض لها. راجع 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.

HotelAssetSuggestion

رسالة تحتوي على اقتراحات مواد العرض لفندق.

تمثيل JSON 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
الحقول
placeId

string

رقم تعريف "أماكن Google" للفندق.
finalUrl

string

عنوان URL النهائي المقترَح لمجموعة مواد العرض
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)

نوع مادة العرض النصية على سبيل المثال، HEADLINE وDESCRIPTION وما إلى ذلك.

HotelImageAsset

اقتراح لمواد عرض صورة واحدة لأحد الفنادق

تمثيل JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
الحقول
uri

string

معرّف الموارد المنتظم (URI) للصورة.
assetFieldType

enum (AssetFieldType)

نوع مادة عرض الصورة على سبيل المثال، MARKETING_IMAGE، PORTRAIT_MARKETING_IMAGE، وما إلى ذلك.

HotelAssetSuggestionStatus

الحالات المحتملة لاقتراح مادة عرض فندق.

عمليات التعداد
UNSPECIFIED لم يتم تحديد التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
SUCCESS تم استرداد اقتراح مادة عرض الفندق بنجاح.
HOTEL_NOT_FOUND لا ينتج عن البحث عن فندق أيّ نتائج.
INVALID_PLACE_ID معرّف أماكن Google غير صالح ولا يمكن فك ترميزه.