Method: customers.suggestTravelAssets

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

HTTP 请求

POST https://googleads.googleapis.com/v14/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 无效，无法解码。