- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- 試してみる
旅行アセットの候補を返します。アセットの候補はベスト エフォート ベースで返されます。特定のホテル物件について、考え得るすべてのアセットタイプが返されるという保証はありません。
HTTP リクエスト
POST https://googleads.googleapis.com/v16/customers/{customerId}:suggestTravelAssets
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
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 |
アセット グループの最終ページ URL の候補。 |
hotelName |
リクエストされた言語でのホテル名。 |
callToAction |
行動を促すフレーズのタイプ。 |
textAssets[] |
広告見出しや説明文などのテキスト アセット |
imageAssets[] |
横向き、縦向き、スクエアなどの画像アセット |
status |
ホテルアセットの提案のステータス。 |
HotelTextAsset
ホテルに関する 1 つのテキスト アセットの提案。
JSON 表現 |
---|
{
"text": string,
"assetFieldType": enum ( |
フィールド | |
---|---|
text |
リクエストされた言語でのアセット テキスト。 |
assetFieldType |
テキスト アセットのタイプ。(例: HEADLINE、DESCRIPTION など)。 |
HotelImageAsset
ホテルに関する 1 つの画像アセットの提案です。
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 が無効なため、デコードできません。 |