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