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 סופית עבור קבוצת 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' אינו חוקי ולא ניתן לפענח אותו.