Method: customers.suggestTravelAssets

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

طلب HTTP

POST https://googleads.googleapis.com/v14/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، POSRAIT_MARKETING_IMAGE، وغيرها.

HotelAssetSuggestionStatus

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

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