- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- 试试看!
返回旅行素材资源建议。系统会尽可能返回素材资源建议。我们无法保证为所有给定的酒店房源返回所有可能的素材资源类型。
HTTP 请求
POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestTravelAssets
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "languageOption": string, "placeIds": [ string ] } |
字段 | |
---|---|
languageOption |
必需。素材资源建议的语言规范,采用 BCP 47 格式(例如 en-US、zh-CN 等)。将采用这种语言。通常与广告系列的目标语言之一匹配。 |
placeIds[] |
请求素材资源的酒店的 Google 地图地点 ID。如需了解详情,请参阅 https://developers.google.com/places/web-service/place-id。 |
响应正文
TravelAssetSuggestionService.SuggestTravelAssets
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"hotelAssetSuggestions": [
{
object ( |
字段 | |
---|---|
hotelAssetSuggestions[] |
针对请求中提交的每个地点 ID 的素材资源建议。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
HotelAssetSuggestion
包含酒店素材资源建议的消息。
JSON 表示法 |
---|
{ "placeId": string, "finalUrl": string, "hotelName": string, "callToAction": enum ( |
字段 | |
---|---|
placeId |
酒店的 Google 商家信息 ID。 |
finalUrl |
为 AssetGroup 建议的最终到达网址。 |
hotelName |
以所请求的语言显示的酒店名称。 |
callToAction |
号召性用语类型。 |
textAssets[] |
文字素材资源,例如标题、广告内容描述等。 |
imageAssets[] |
图片素材资源,例如横向/纵向/方形等 |
status |
酒店素材资源建议的状态。 |
HotelTextAsset
一条针对酒店的文字素材资源建议。
JSON 表示法 |
---|
{
"text": string,
"assetFieldType": enum ( |
字段 | |
---|---|
text |
采用所请求的语言的素材资源文字。 |
assetFieldType |
文字素材资源的类型。例如,HEADLINE、DESCRIPTION 等。 |
HotelImageAsset
针对某酒店的单张图片素材资源建议。
JSON 表示法 |
---|
{
"uri": string,
"assetFieldType": enum ( |
字段 | |
---|---|
uri |
图片的 URI。 |
assetFieldType |
图片资源类型。例如,MARKETING_IMAGE、PORTRAIT_MARKETING_IMAGE 等。 |
HotelAssetSuggestionStatus
酒店素材资源建议的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中不知道收到的错误代码。 |
SUCCESS |
已成功检索到酒店素材资源建议。 |
HOTEL_NOT_FOUND |
查询酒店时不会返回任何内容。 |
INVALID_PLACE_ID |
Google 地点 ID 无效,无法解码。 |