Method: customers.suggestTravelAssets

여행 애셋 추천을 반환합니다. 최선을 다해 확장 소재 추천이 반환됩니다. 특정 호텔 숙박 시설에 대해 가능한 모든 애셋 유형이 반환된다는 보장은 없습니다.

HTTP 요청

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestTravelAssets

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
필드
languageOption

string

필수 항목입니다. 확장 소재 추천에 사용할 BCP 47 형식 (예: en-US, zh-CN 등)의 언어 사양입니다. 텍스트는 이 언어로 표시됩니다. 일반적으로 캠페인 타겟 언어 중 하나와 일치합니다.
placeIds[]

string

애셋이 요청된 호텔의 Google 지도 장소 ID입니다. 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

응답 본문

TravelAssetSuggestionService.SuggestTravelAssets의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
필드
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

요청에 제출된 각 장소 ID에 대한 애셋 추천입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adwords

자세한 내용은 OAuth 2.0 개요를 참고하세요.

HotelAssetSuggestion

호텔에 대한 애셋 추천이 포함된 메시지입니다.

JSON 표현 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
필드
placeId

string

호텔의 Google 지역 정보 ID입니다.
finalUrl

string

AssetGroup에 권장되는 최종 URL입니다.
hotelName

string

요청한 언어로 된 호텔 이름입니다.
callToAction

enum (CallToActionType)

클릭 유도 문구 유형입니다.
textAssets[]

object (HotelTextAsset)

광고 제목, 설명 등의 텍스트 애셋
imageAssets[]

object (HotelImageAsset)

가로 모드/세로/정사각형 등의 이미지 애셋
status

enum (HotelAssetSuggestionStatus)

호텔 확장 소재 추천의 상태입니다.

HotelTextAsset

호텔에 대한 단일 텍스트 애셋 추천입니다.

JSON 표현 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
필드
text

string

요청한 언어로 된 저작물 텍스트입니다.
assetFieldType

enum (AssetFieldType)

텍스트 애셋 유형입니다. 예: HEADLINE, DESCRIPTION

HotelImageAsset

호텔의 단일 이미지 확장 소재 추천입니다.

JSON 표현 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
필드
uri

string

이미지의 URI입니다.
assetFieldType

enum (AssetFieldType)

이미지 확장 소재 유형입니다. 예: MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE 등

HotelAssetSuggestionStatus

호텔 확장 소재 추천의 가능한 상태입니다.

열거형
UNSPECIFIED 열거형이 지정되지 않았습니다.
UNKNOWN 수신된 오류 코드를 이 버전에서 알 수 없습니다.
SUCCESS 호텔 확장 소재 추천을 가져왔습니다.
HOTEL_NOT_FOUND 호텔 조회는 결과를 반환하지 않습니다.
INVALID_PLACE_ID Google 지역 정보 ID가 잘못되어 디코딩할 수 없습니다.