- 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 Places ID 無效且無法解碼。 |