Method: customers.suggestTravelAssets

返回旅行素材资源建议。系统会尽量返回素材资源建议。我们无法保证针对任何给定酒店房源都会返回所有可能的素材资源类型。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
字段
languageOption

string

必需。素材资源建议的 BCP 47 格式语言规范（例如 en-US、zh-CN 等）。文本将采用这种语言。通常与某种广告系列目标语言相符。
placeIds[]

string

资源所请求酒店的 Google 地图地点 ID。如需了解详情，请访问 https://developers.google.com/places/web-service/place-id。

响应正文

TravelAssetSuggestionService.SuggestTravelAssets 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
字段
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

针对请求中提交的每个地点 ID 的素材资源建议。

授权范围

需要以下 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 商家信息 ID。
finalUrl

string

为 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

酒店素材资源建议的可能状态。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中未知收到的错误代码。
SUCCESS 已成功检索到酒店素材资源建议。
HOTEL_NOT_FOUND 查询酒店时不会返回任何内容。
INVALID_PLACE_ID Google 地点 ID 无效，无法进行解码。