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 סופית ל- 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)

הסוג של נכס הטקסט. לדוגמה, HEADLINE, DESCRIPTION וכו'.

HotelImageAsset

הצעה אחת לנכס תמונות עבור מלון.

ייצוג JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
שדות
uri

string

URI של התמונה.
assetFieldType

enum (AssetFieldType)

הסוג של נכס התמונות. לדוגמה, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE וכו'.

HotelAssetSuggestionStatus

סטטוסים אפשריים של הצעה לנכס מלון.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה זו.
SUCCESS ההצעה לנכס מלון אוחזרה בהצלחה.
HOTEL_NOT_FOUND חיפוש של מלון לא מחזיר שום דבר.
INVALID_PLACE_ID מזהה Google Places אינו חוקי ולא ניתן לפענח אותו.