- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- HotelAssetSuggestion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelTextAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelImageAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- HotelAssetSuggestionStatus
- 试试看!
返回旅行素材资源建议。系统会尽最大努力返回素材资源建议。我们无法保证针对任何指定酒店房源都会返回所有可能的素材资源类型。
HTTP 请求
POST https://googleads.googleapis.com/v17/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 无效,无法进行解码。 |