Asset

확장 소재는 여러 광고에서 공유할 수 있는 광고의 일부입니다. 이미지 (ImageAsset), 동영상 (YoutubeVideoAsset) 등일 수 있습니다. 애셋은 변경할 수 없으며 삭제할 수 없습니다. 확장 소재의 게재를 중지하려면 확장 소재를 사용 중인 항목에서 확장 소재를 삭제하세요.

JSON 표현
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
입력란
resourceName

string

변경할 수 없습니다. 애셋의 리소스 이름입니다. 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assets/{asset_id}

type

enum (AssetType)

출력 전용. 저작물의 유형입니다.

finalUrls[]

string

모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.

finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 사용 가능한 최종 모바일 URL의 목록입니다.

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, FinalUrls 또는 FinalMobileUrls의 URL 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑의 목록입니다.

source

enum (AssetSource)

출력 전용. 애셋의 소스입니다.

policySummary

object (AssetPolicySummary)

출력 전용. 저작물에 대한 정책 정보입니다.

fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

출력 전용. 각 FieldType의 저작물에 대한 정책 정보입니다.

id

string (int64 format)

출력 전용. 애셋의 ID입니다.

name

string

애셋의 이름입니다(선택사항).

trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.

finalUrlSuffix

string

병렬 추적으로 게재되는 방문 페이지 URL에 매개변수를 추가하기 위한 URL 템플릿

통합 필드 asset_data. 저작물의 구체적인 유형입니다. asset_data은 다음 중 하나여야 합니다.
youtubeVideoAsset

object (YoutubeVideoAsset)

변경할 수 없습니다. YouTube 동영상 저작물입니다.

mediaBundleAsset

object (MediaBundleAsset)

변경할 수 없습니다. 미디어 번들 애셋입니다.

imageAsset

object (ImageAsset)

출력 전용. 이미지 애셋입니다.

textAsset

object (TextAsset)

변경할 수 없습니다. 텍스트 애셋입니다.

leadFormAsset

object (LeadFormAsset)

리드 양식 확장 소재

bookOnGoogleAsset

object (BookOnGoogleAsset)

Google Asset에 관한 도서

promotionAsset

object (PromotionAsset)

프로모션 확장 소재

calloutAsset

object (CalloutAsset)

콜아웃 확장 소재

structuredSnippetAsset

object (StructuredSnippetAsset)

구조화된 스니펫 확장 소재입니다.

pageFeedAsset

object (PageFeedAsset)

페이지 피드 애셋입니다.

dynamicEducationAsset

object (DynamicEducationAsset)

동적 교육 애셋

mobileAppAsset

object (MobileAppAsset)

모바일 앱 확장 소재

hotelCalloutAsset

object (HotelCalloutAsset)

호텔 콜아웃 확장 소재

callAsset

object (CallAsset)

전화번호 확장 소재

priceAsset

object (PriceAsset)

가격 확장 소재

callToActionAsset

object (CallToActionAsset)

변경할 수 없습니다. 클릭 유도 문구 애셋입니다.

dynamicRealEstateAsset

object (DynamicRealEstateAsset)

동적 부동산 확장 소재

dynamicCustomAsset

object (DynamicCustomAsset)

동적 맞춤 애셋

dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

동적 호텔 및 임대 확장 소재

dynamicFlightsAsset

object (DynamicFlightsAsset)

동적 항공편 애셋

dynamicTravelAsset

object (DynamicTravelAsset)

동적 여행 애셋

dynamicLocalAsset

object (DynamicLocalAsset)

동적 로컬 애셋입니다.

dynamicJobsAsset

object (DynamicJobsAsset)

동적 취업정보 애셋

locationAsset

object (LocationAsset)

출력 전용. 위치 확장 소재

hotelPropertyAsset

object (HotelPropertyAsset)

변경할 수 없습니다. 호텔 숙박 시설 애셋입니다.

AssetType

가능한 자산 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
YOUTUBE_VIDEO YouTube 동영상 애셋입니다.
MEDIA_BUNDLE 미디어 번들 애셋입니다.
IMAGE 이미지 확장 소재
TEXT 텍스트 애셋입니다.
LEAD_FORM 리드 양식 확장 소재
BOOK_ON_GOOGLE Google에서 예약 애셋입니다.
PROMOTION 프로모션 확장 소재
CALLOUT 콜아웃 확장 소재
STRUCTURED_SNIPPET 구조화된 스니펫 확장 소재입니다.
PAGE_FEED 페이지 피드 애셋
DYNAMIC_EDUCATION 동적 교육 애셋입니다.
MOBILE_APP 모바일 앱 확장 소재
HOTEL_CALLOUT 호텔 콜아웃 확장 소재
CALL 전화번호 확장 소재를 탭합니다.
PRICE 가격 확장 소재
CALL_TO_ACTION 클릭 유도 문구 애셋입니다.
DYNAMIC_REAL_ESTATE 동적 부동산 확장 소재
DYNAMIC_CUSTOM 동적 맞춤 애셋
DYNAMIC_HOTELS_AND_RENTALS 동적 호텔 및 공유숙박 애셋입니다.
DYNAMIC_FLIGHTS 동적 항공편 애셋
DYNAMIC_TRAVEL 동적 여행 애셋입니다.
DYNAMIC_LOCAL 동적 지역 애셋입니다.
DYNAMIC_JOBS 동적 채용 정보 애셋입니다.
LOCATION 위치 확장 소재
HOTEL_PROPERTY 호텔 숙박 시설 애셋입니다.

AssetPolicySummary

저작물의 정책 정보를 포함합니다.

JSON 표현
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
입력란
policyTopicEntries[]

object (PolicyTopicEntry)

출력 전용. 이 저작물의 정책 발견 항목 목록입니다.

reviewStatus

enum (PolicyReviewStatus)

출력 전용. 검토 과정 중 이 저작물의 위치

approvalStatus

enum (PolicyApprovalStatus)

출력 전용. 이 저작물의 전반적인 승인 상태로, 개별 정책 주제 항목의 상태를 기준으로 계산됩니다.

AssetFieldTypePolicySummary

AssetFieldType 컨텍스트에서 저작물에 대한 정책 정보가 포함됩니다.

JSON 표현
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
입력란
assetFieldType

enum (AssetFieldType)

출력 전용. 이 저작물의 FieldType입니다.

assetSource

enum (AssetSource)

출력 전용. 이 애셋의 소스입니다.

policySummaryInfo

object (AssetPolicySummary)

출력 전용. 정책 요약

YoutubeVideoAsset

YouTube 저작물

JSON 표현
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
입력란
youtubeVideoTitle

string

YouTube 동영상 제목

youtubeVideoId

string

YouTube 동영상 ID입니다. YouTube 동영상 URL에 사용되는 11자의 문자열 값입니다.

MediaBundleAsset

MediaBundle 애셋입니다.

JSON 표현
{
  "data": string
}
입력란
data

string (bytes format)

미디어 번들 (ZIP 파일) 애셋 데이터 업로드된 ZIP 파일의 형식은 이 파일이 사용될 광고 필드에 따라 다릅니다. 형식에 대한 자세한 내용은 MediaBundleAsset을 사용하려는 광고 필드의 문서를 참조하세요. 이 필드는 변경 전용입니다.

base64 인코딩 문자열입니다.

ImageAsset

이미지 애셋입니다.

JSON 표현
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
입력란
mimeType

enum (MimeType)

이미지 애셋의 MIME 유형입니다.

fullSize

object (ImageDimension)

이 이미지의 원본 크기 메타데이터입니다.

data

string (bytes format)

이미지의 원시 바이트 데이터입니다. 이 필드는 변경 전용입니다.

base64 인코딩 문자열입니다.

fileSize

string (int64 format)

이미지 애셋의 파일 크기(바이트)입니다.

ImageDimension

특정 크기(원본 또는 크기 조정)의 이미지에 대한 메타데이터입니다.

JSON 표현
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
입력란
heightPixels

string (int64 format)

이미지의 높이입니다.

widthPixels

string (int64 format)

이미지의 너비입니다.

url

string

이 높이와 너비의 이미지를 반환하는 URL입니다.

TextAsset

텍스트 애셋입니다.

JSON 표현
{
  "text": string
}
입력란
text

string

텍스트 애셋의 텍스트 콘텐츠입니다.

LeadFormAsset

리드 양식 확장 소재

JSON 표현
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
입력란
businessName

string

필수 항목입니다. 광고 중인 비즈니스의 이름입니다.

callToActionType

enum (LeadFormCallToActionType)

필수 항목입니다. 사용자가 양식을 펼치도록 유도하는 사전 정의된 표시 텍스트

callToActionDescription

string

필수 항목입니다. 사용자가 양식을 확장한 후 기대할 수 있는 것에 대한 명확한 가치 제안을 제공하는 텍스트

headline

string

필수 항목입니다. 양식에서 요구하거나 지원하는 내용을 설명하는 펼쳐진 양식의 제목입니다.

description

string

필수 항목입니다. 양식에서 요청 또는 지원하는 내용을 설명하는 확장된 양식에 대한 자세한 설명입니다.

privacyPolicyUrl

string

필수 항목입니다. 광고주/비즈니스에서 수집된 데이터를 처리하는 방식에 대한 정책을 설명하는 페이지 링크

fields[]

object (LeadFormField)

입력란의 순서가 지정된 목록입니다. 이 필드는 질문 순서를 변경하여 업데이트할 수 있지만 질문을 추가하거나 삭제하여 업데이트할 수는 없습니다.

customQuestionFields[]

object (LeadFormCustomQuestionField)

맞춤 질문 필드의 순서가 지정된 목록입니다. 이 입력란에는 양식당 5개의 질문만 입력할 수 있습니다.

deliveryMethods[]

object (LeadFormDeliveryMethod)

수집된 리드 데이터를 광고주에게 전달할 방법을 구성했습니다. WebhookDelivery로 입력한 방법을 하나만 구성할 수 있습니다.

postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

양식이 제출된 후 사용자 액션을 유도하는 사전 정의된 표시 텍스트입니다.

desiredIntent

enum (LeadFormDesiredIntent)

리드 양식에서 선택한 의도(예: 더 많은 리드 확보 또는 더 많은 잠재고객 확보)

postSubmitHeadline

string

광고주가 사용자에게 후속 조치를 취하는 방법을 설명하는 양식 제출 후 표시되는 텍스트 제목입니다.

postSubmitDescription

string

양식 제출 후 광고주가 사용자에게 후속 조치를 취하는 방법을 설명하는 자세한 설명입니다.

backgroundImageAsset

string

배경 이미지의 애셋 리소스 이름입니다. 이미지 크기는 정확히 1200x628이어야 합니다.

customDisclosure

string

리드 양식에 Google 면책 조항과 함께 표시되는 맞춤 공개 정보 허용된 고객만 액세스할 수 있습니다.

LeadFormCallToActionType

리드 양식의 클릭 유도 문구 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LEARN_MORE 자세히 알아보세요
GET_QUOTE 견적 받기
APPLY_NOW 지금 신청하세요.
SIGN_UP 가입
CONTACT_US 지원팀에 문의하세요.
SUBSCRIBE 구독을 탭합니다.
DOWNLOAD 다운로드를 탭합니다.
BOOK_NOW 지금 예약하세요.
GET_OFFER 혜택을 받으세요.
REGISTER 등록합니다.
GET_INFO 정보 확인
REQUEST_DEMO 데모를 요청하세요.
JOIN_NOW 지금 가입하세요.
GET_STARTED Android Auto를 시작합니다

LeadFormField

양식 내에 하나의 입력란 인스턴스입니다.

JSON 표현
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
입력란
inputType

enum (LeadFormFieldUserInputType)

입력 유형을 설명합니다. '성명'과 같은 사전 정의된 유형이거나 '어떤 종류의 차량을 보유하고 계신가요?'와 같은 사전 검증된 질문일 수 있습니다.

통합 필드 answers. 이 양식 필드에서 허용하는 답변 구성을 정의합니다. oneof가 설정되지 않은 경우 자유 텍스트 답변입니다. answers은 다음 중 하나여야 합니다.
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

단답형 질문에 대한 답변 구성입니다. 사전 검증된 질문 입력란에만 설정할 수 있습니다. 답변은 최소 2개에서 최대 12개까지 허용됩니다.

hasLocationAnswer

boolean

위치 질문에 대한 답변 구성입니다. true이면 캠페인/계정 수준의 위치 데이터 (주, 도시, 업체 이름 등)가 리드 양식에서 렌더링됩니다. V13.1부터 캠페인/계정 수준에서 위치 확장 소재를 설정한 광고주의 경우 '어떤 대리점을 선호하시나요?'라는 질문에만 hasLocationAnswer를 설정할 수 있습니다.

LeadFormSingleChoiceAnswers

단일 선택 질문에 대한 가능한 답변을 정의하며 일반적으로 단일 선택 드롭다운 목록으로 표시됩니다.

JSON 표현
{
  "answers": [
    string
  ]
}
입력란
answers[]

string

단일 질문 필드의 선택 목록입니다. 항목의 순서는 UI 순서를 정의합니다. 답변은 최소 2개에서 최대 12개까지 허용됩니다.

LeadFormCustomQuestionField

양식 내 1개의 맞춤 질문 입력란 인스턴스입니다.

JSON 표현
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
입력란
customQuestionText

string

정확한 맞춤 질문 입력란 텍스트 (예: '어떤 종류의 차량을 갖고 계신가요?')를 입력해 주세요.

통합 필드 answers. 이 양식 필드에서 허용하는 답변 구성을 정의합니다. oneof가 설정되지 않은 경우 자유 텍스트 답변입니다. answers은 다음 중 하나여야 합니다.
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

단답형 질문에 대한 답변 구성입니다. 답변은 최소 2개에서 최대 12개까지 허용됩니다.

hasLocationAnswer

boolean

위치 질문에 대한 답변 구성입니다. true이면 캠페인/계정 수준의 위치 데이터 (주, 도시, 업체 이름 등)가 리드 양식에서 렌더링됩니다. V13.1부터 캠페인/계정 수준에서 위치 확장 소재를 설정한 광고주의 경우 '어떤 대리점을 선호하시나요?'라는 질문에만 hasLocationAnswer를 설정할 수 있습니다.

LeadFormDeliveryMethod

광고주에게 리드가 전달되는 방식의 구성입니다.

JSON 표현
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
입력란
통합 필드 delivery_details. 다양한 게재 하위유형 delivery_details은 다음 중 하나여야 합니다.
webhook

object (WebhookDelivery)

웹훅 게재 방법입니다.

WebhookDelivery

Google은 광고주가 지정한 엔드포인트에 대한 HTTP 호출을 수행하여 광고주에게 리드를 알립니다. 요청에는 Google에서 양식 광고 문서의 일부로 게시하는 스키마와 일치하는 JSON이 포함됩니다.

JSON 표현
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
입력란
advertiserWebhookUrl

string

광고주가 리드를 보내기 위해 지정한 웹훅 URL입니다.

googleSecret

string

광고주가 웹훅 페이로드의 일부로 설정한 스푸핑 방지 보안 비밀입니다.

payloadSchemaVersion

string (int64 format)

이 전송 인스턴스에서 사용할 스키마 버전입니다.

LeadFormPostSubmitCallToActionType

리드 양식의 제출 후 클릭 유도 문구 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
VISIT_SITE 사이트 방문
DOWNLOAD 다운로드를 탭합니다.
LEARN_MORE 자세히 알아보세요
SHOP_NOW 지금 구매하기

LeadFormDesiredIntent

생성된 리드에서 선택한 의도 수준을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LOW_INTENT 낮은 품질의 리드를 더 많이 제공
HIGH_INTENT 더욱 가치 있는 리드를 제공합니다.

BookOnGoogleAsset

이 유형에는 필드가 없습니다.

Google에서 예약 저작물 사용자를 Google을 통해 예약하도록 리디렉션하는 데 사용됩니다. Google에서 예약하면 리디렉션 URL이 Google을 통해 직접 예약하도록 변경됩니다.

PromotionAsset

프로모션 확장 소재

JSON 표현
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
입력란
promotionTarget

string

필수 항목입니다. 프로모션의 타겟팅 대상에 관한 자유 형식의 설명입니다.

discountModifier

enum (PromotionExtensionDiscountModifier)

할인 자격을 위한 수정자입니다.

redemptionStartDate

string

프로모션을 사용할 수 있는 시작일의 yyyy-MM-dd 형식입니다.

redemptionEndDate

string

프로모션을 사용할 수 있는 마지막 날짜로 yyyy-MM-dd 형식입니다.

occasion

enum (PromotionExtensionOccasion)

프로모션 대상입니다. 행사가 설정된 경우 혜택 사용 기간은 행사와 관련된 기간 내에 있어야 합니다.

languageCode

string

프로모션 언어입니다. BCP 47 언어 태그로 표현됩니다.

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일로 yyyy-MM-dd 형식입니다.

endDate

string

이 확장 소재가 유효하여 계속 게재되는 마지막 날짜입니다(yyyy-MM-dd 형식).

adScheduleTargets[]

object (AdScheduleInfo)

확장 소재가 게재될 수 있는 모든 시간 간격을 지정하는 중복되지 않는 일정의 목록입니다. 하루 최대 6개의 일정(총 42개)을 사용할 수 있습니다.

통합 필드 discount_type. 할인 유형으로, 비율 할인 또는 할인 금액일 수 있습니다. discount_type은 다음 중 하나여야 합니다.
percentOff

string (int64 format)

프로모션의 할인율입니다. 1,000,000 = 100%입니다. 이 값 또는 amountAmountOff는 필수 항목입니다.

moneyAmountOff

object (Money)

프로모션에서 할인되는 금액 이 값 또는 percentOff가 필요합니다.

통합 필드 promotion_trigger. 프로모션 트리거입니다. 프로모션 코드 또는 요건을 충족하는 주문 금액의 프로모션으로 할 수 있습니다. promotion_trigger은 다음 중 하나여야 합니다.
promotionCode

string

사용자가 프로모션 자격요건을 갖추기 위해 사용해야 하는 코드입니다.

ordersOverAmount

object (Money)

사용자가 프로모션을 이용하기 위해 필요한 총 주문 금액입니다.

CalloutAsset

콜아웃 확장 소재

JSON 표현
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
입력란
calloutText

string

필수 항목입니다. 콜아웃 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일로 yyyy-MM-dd 형식입니다.

endDate

string

이 확장 소재가 유효하여 계속 게재되는 마지막 날짜입니다(yyyy-MM-dd 형식).

adScheduleTargets[]

object (AdScheduleInfo)

확장 소재가 게재될 수 있는 모든 시간 간격을 지정하는 중복되지 않는 일정의 목록입니다. 하루 최대 6개의 일정(총 42개)을 사용할 수 있습니다.

StructuredSnippetAsset

구조화된 스니펫 확장 소재입니다.

JSON 표현
{
  "header": string,
  "values": [
    string
  ]
}
입력란
header

string

필수 항목입니다. 스니펫의 헤더입니다. 이 문자열은 https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers에 사전 정의된 값 중 하나여야 합니다.

values[]

string

필수 항목입니다. 스니펫의 값입니다. 이 컬렉션의 크기는 3 이상 10 이하여야 합니다. 각 값의 길이는 1~25자(영문 기준)여야 합니다.

SitelinkAsset

사이트링크 확장 소재입니다.

JSON 표현
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
입력란
description1

string

사이트링크 설명의 첫 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description2도 설정해야 합니다.

description2

string

사이트링크 설명의 두 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description1도 설정해야 합니다.

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일로 yyyy-MM-dd 형식입니다.

endDate

string

이 확장 소재가 유효하여 계속 게재되는 마지막 날짜입니다(yyyy-MM-dd 형식).

adScheduleTargets[]

object (AdScheduleInfo)

확장 소재가 게재될 수 있는 모든 시간 간격을 지정하는 중복되지 않는 일정의 목록입니다. 하루 최대 6개의 일정(총 42개)을 사용할 수 있습니다.

PageFeedAsset

페이지 피드 애셋

JSON 표현
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
입력란
pageUrl

string

필수 항목입니다. 광고주가 타겟팅하려는 웹페이지입니다.

labels[]

string

페이지 URL을 그룹화하는 데 사용되는 라벨입니다.

DynamicEducationAsset

동적 교육 애셋입니다.

JSON 표현
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
입력란
programId

string

필수 항목입니다. 프로그램 ID로서 임의의 문자와 숫자 시퀀스이며 고유해야 하고 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

locationId

string

위치 ID로, 임의의 문자와 숫자 시퀀스가 될 수 있으며 고유해야 합니다.

programName

string

필수 항목입니다. 프로그램 이름(예: 간호) 필수 항목입니다.

subject

string

연구 주제(예: 건강)

programDescription

string

프로그램 설명(예: 간호 자격증)

schoolName

string

학교 이름(예: 마운틴뷰 간호 학교)

address

string

다음 형식 중 하나로 지정할 수 있는 학교 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

contextualKeywords[]

string

문맥 키워드(예: 간호 자격증, 건강, 마운틴 뷰)

similarProgramIds[]

string

유사 프로그램 ID입니다.

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

thumbnailImageUrl

string

썸네일 이미지 URL(예: http://www.example.com/thumbnail.png) 썸네일 이미지는 이미지 애셋으로 업로드되지 않습니다.

imageUrl

string

이미지 URL(예: http://www.example.com/image.png) 이미지는 이미지 확장 소재로 업로드되지 않습니다.

MobileAppAsset

모바일 앱을 나타내는 애셋입니다.

JSON 표현
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
입력란
appId

string

필수 항목입니다. 모바일 애플리케이션을 고유하게 식별하는 문자열입니다. Android의 경우 'com.android.ebay', iOS의 경우 '12345689'와 같은 플랫폼 네이티브 ID만 포함되어야 합니다.

appStore

enum (MobileAppVendor)

필수 항목입니다. 이 특정 앱을 배포하는 애플리케이션 스토어입니다.

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일로 yyyy-MM-dd 형식입니다.

endDate

string

이 확장 소재가 유효하여 계속 게재되는 마지막 날짜입니다(yyyy-MM-dd 형식).

HotelCalloutAsset

호텔 콜아웃을 나타내는 확장 소재입니다.

JSON 표현
{
  "text": string,
  "languageCode": string
}
입력란
text

string

필수 항목입니다. 호텔 콜아웃 확장 소재의 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

languageCode

string

필수 항목입니다. 호텔 콜아웃의 언어입니다. BCP 47 언어 태그로 표현됩니다.

CallAsset

전화번호 확장 소재

JSON 표현
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
입력란
countryCode

string

필수 항목입니다. 전화번호의 두 자리 국가 코드입니다. 예: 'US', 'us'.

phoneNumber

string

필수 항목입니다. 광고주의 원시 전화번호입니다. 예: '1234567890', '(123)456-7890'

callConversionReportingState

enum (CallConversionReportingState)

이 CallAsset에 자체 통화 전환 설정을 사용할지, 계정 수준 설정을 따라야 하는지, 통화 전환을 사용 중지해야 하는지를 나타냅니다.

callConversionAction

string

통화 전환에 기여한 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. 이 필드는 callConversionReportingState가 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION으로 설정된 경우에만 적용됩니다.

adScheduleTargets[]

object (AdScheduleInfo)

확장 소재가 게재될 수 있는 모든 시간 간격을 지정하는 중복되지 않는 일정의 목록입니다. 하루 최대 6개의 일정(총 42개)을 사용할 수 있습니다.

PriceAsset

가격 혜택 목록을 나타내는 애셋입니다.

JSON 표현
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
입력란
type

enum (PriceExtensionType)

필수 항목입니다. 가격 확장 소재의 유형입니다.

priceQualifier

enum (PriceExtensionPriceQualifier)

가격 확장 소재의 가격 책정 요소.

languageCode

string

필수 항목입니다. 가격 확장 소재의 언어입니다. BCP 47 언어 태그로 표현됩니다.

priceOfferings[]

object (PriceOffering)

가격 확장 소재가 제공하는 가격입니다. 이 컬렉션의 크기는 3 이상 8 이하여야 합니다.

PriceOffering

PriceAsset 내의 단일 가격 서비스입니다.

JSON 표현
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
입력란
header

string

필수 항목입니다. 가격 서비스의 헤더입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

description

string

필수 항목입니다. 제공 가격에 대한 설명입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

price

object (Money)

필수 항목입니다. 제공하는 서비스의 가격 값입니다.

unit

enum (PriceExtensionPriceUnit)

제공하는 가격의 단위입니다.

finalUrl

string

필수 항목입니다. 모든 교차 도메인 리디렉션 후의 최종 URL입니다.

finalMobileUrl

string

모든 교차 도메인 리디렉션 후의 최종 모바일 URL입니다.

CallToActionAsset

클릭 유도 문구 애셋입니다.

JSON 표현
{
  "callToAction": enum (CallToActionType)
}
입력란
callToAction

enum (CallToActionType)

클릭 유도 문구

DynamicRealEstateAsset

동적 부동산 확장 소재

JSON 표현
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
입력란
listingId

string

필수 항목입니다. 문자와 숫자의 임의의 조합으로 된 등록정보 ID로, 고유해야 하며 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

listingName

string

필수 항목입니다. 등록정보 이름(예: 대로 방갈로) 필수 항목입니다.

cityName

string

도시 이름(예: 서울 강남구)

description

string

설명(예: 침대 3개, 욕실 2개, 1,568평방피트)

address

string

다음 형식 중 하나로 지정할 수 있는 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

price

string

숫자 뒤에 알파벳 통화 코드가 올 수 있는 ISO 4217 표준 가격입니다. 소수점 표시로 '.'를 사용합니다(예: 200,000.00 USD).

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

propertyType

string

속성 유형(예: 주택)

listingType

string

등록정보 유형(예: 판매용)

contextualKeywords[]

string

문맥 키워드(예: 매매용, 매매용 주택)

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성이 설정되면 '가격' 대신 사용됩니다(예: 최저 $200,000.00).

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

similarListingIds[]

string

유사 등록정보 ID입니다.

DynamicCustomAsset

동적 맞춤 애셋

JSON 표현
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
입력란
id

string

필수 항목입니다. ID는 문자와 숫자의 조합으로 구성될 수 있으며, 고유해야 하며 리마케팅 태그(예: 세단)의 값과 일치해야 합니다. 필수 항목입니다.

id2

string

ID2는 문자와 숫자의 조합(예: 빨간색)일 수 있습니다. ID 시퀀스 (ID + ID2)는 고유해야 합니다.

itemTitle

string

필수 항목입니다. 항목 제목(예: 중형 세단) 필수 항목입니다.

itemSubtitle

string

항목 부제목(예: 마운틴뷰 대리점에서)

itemDescription

string

상품 설명(예: 인기 판매 중형 자동차)

itemAddress

string

다음 형식 중 하나로 지정할 수 있는 항목 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

itemCategory

string

상품 카테고리(예: 세단)

price

string

숫자 뒤에 알파벳 통화 코드가 올 수 있는 ISO 4217 표준 가격입니다. 소수점 표시로 '.'를 사용합니다(예: 20,000.00 USD).

salePrice

string

할인가로 숫자 뒤에 알파벳 통화 코드가 붙을 수 있습니다(ISO 4217 표준). 소수점 표시로 '.'를 사용합니다(예: 15,000.00 USD). '가격' 입력란보다 작아야 합니다.

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성을 설정하면 '가격' 대신 사용됩니다(예: 최저 $20,000.00).

formattedSalePrice

string

서식이 지정된 할인가이며 모든 문자가 될 수 있습니다. 이 속성이 설정되면 '할인가' 대신 사용됩니다(예: $15,000.00로 할인 판매).

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

contextualKeywords[]

string

문맥 키워드(예: 세단, 4도어 세단)

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

similarIds[]

string

유사 ID

DynamicHotelsAndRentalsAsset

동적 호텔 및 임대 확장 소재

JSON 표현
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
입력란
propertyId

string

필수 항목입니다. 문자와 숫자의 조합으로 이루어진 속성 ID로, 고유해야 하며 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

propertyName

string

필수 항목입니다. 숙박 시설 이름(예: 마운틴 뷰 호텔) 필수 항목입니다.

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

destinationName

string

목적지 이름(예: 다운타운 마운틴 뷰)

description

string

설명(예: SJC 공항 근처)

price

string

숫자 뒤에 알파벳 통화 코드가 올 수 있는 ISO 4217 표준 가격입니다. 소수점 표시로 '.'를 사용합니다(예: 100.00 USD).

salePrice

string

ISO 4217 표준입니다. 소수점 표시로 '.'를 사용합니다(예: 80000.00 KRW). '가격' 입력란보다 작아야 합니다.

starRating

string (int64 format)

별표 평점입니다. 1 이상 5 이하의 숫자여야 합니다.

category

string

카테고리(예: 호텔 스위트룸)

contextualKeywords[]

string

문맥 키워드(예: 마운틴뷰 '호텔', 사우스 베이 호텔)

address

string

다음 형식 중 하나로 지정할 수 있는 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성을 설정하면 '가격' 대신 사용됩니다(예: 최저 $100.00).

formattedSalePrice

string

서식이 지정된 할인가이며 모든 문자가 될 수 있습니다. 이 속성이 설정되면 '할인가' 대신 사용됩니다(예: $80.00 할인 판매).

similarPropertyIds[]

string

유사 속성 ID.

DynamicFlightsAsset

동적 항공편 애셋

JSON 표현
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
입력란
destinationId

string

필수 항목입니다. 도착 페이지 ID로, 임의의 문자와 숫자 시퀀스일 수 있으며 고유해야 하며 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

originId

string

출발지 ID로, 임의의 문자와 숫자 시퀀스가 될 수 있습니다. ID 순서 (목적지 ID + 출발지 ID)는 고유해야 합니다.

flightDescription

string

필수 항목입니다. 항공편 설명입니다(예: '티켓 예약'). 필수 항목입니다.

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

destinationName

string

목적지 이름(예: 파리)

originName

string

출발지 이름(예: London)

flightPrice

string

항공편 가격은 숫자 뒤에 알파벳 통화 코드가 오는 형식이며 ISO 4217 표준입니다. 소수점 표시로 '.'를 사용합니다(예: 100.00 USD).

flightSalePrice

string

항공편 할인가로, 숫자 뒤에 알파벳 통화 코드가 올 수 있으며 ISO 4217 표준입니다. 소수점 표시로 '.'를 사용합니다(예: 80000.00 KRW). 'flightPrice' 필드보다 작아야 합니다.

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성을 설정하면 '가격' 대신 사용됩니다(예: 최저 $100.00).

formattedSalePrice

string

서식이 지정된 할인가이며 모든 문자가 될 수 있습니다. 이 속성이 설정되면 '할인가' 대신 사용됩니다(예: $80.00 할인 판매).

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

similarDestinationIds[]

string

유사 목적지 ID(예: PAR, LON)

customMapping

string

': , , ... , | : , ... , | ... | : , ... ,' 형식으로 구분자 (',', '|', ':'으로 구분되는 값에 매핑되는 여러 개의 키일 수 있는 맞춤 필드입니다. 예: wifi:most | 항공편: 320, 77W | 항공편: 420, 77W | 항공편: 42}1){/11

DiscoveryCarouselCardAsset

디스커버리 캐러셀 카드 애셋입니다.

JSON 표현
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
입력란
marketingImageAsset

string

연결된 1.91:1 마케팅 이미지의 애셋 리소스 이름입니다. 정사각형 마케팅 이미지 확장 소재가 필요합니다.

squareMarketingImageAsset

string

연결된 정사각형 마케팅 이미지의 애셋 리소스 이름입니다. 이 확장 소재 또는 마케팅 이미지 확장 소재가 필요합니다.

portraitMarketingImageAsset

string

연결된 4:5 세로 모드 마케팅 이미지의 애셋 리소스 이름입니다.

headline

string

필수 항목입니다. 캐러셀 카드의 제목입니다.

callToActionText

string

클릭 유도문안 텍스트입니다.

DynamicTravelAsset

동적 여행 애셋

JSON 표현
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
입력란
destinationId

string

필수 항목입니다. 도착 페이지 ID로, 임의의 문자와 숫자 시퀀스일 수 있으며 고유해야 하며 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

originId

string

출발지 ID로, 임의의 문자와 숫자 시퀀스가 될 수 있습니다. ID 순서 (목적지 ID + 출발지 ID)는 고유해야 합니다.

title

string

필수 항목입니다. 제목(예: 기차표 예약) 필수 항목입니다.

destinationName

string

목적지 이름(예: 파리)

destinationAddress

string

다음 형식 중 하나로 지정할 수 있는 목적지 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

originName

string

출발지 이름(예: London)

price

string

숫자 뒤에 알파벳 통화 코드가 오는 ISO 4217 표준 가격입니다. 소수점 표시로 '.'를 사용합니다(예: 100.00 USD).

salePrice

string

할인가로, 숫자 뒤에 알파벳 통화 코드가 붙을 수 있습니다(ISO 4217 표준). 소수점 표시로 '.'를 사용합니다(예: 80000.00 KRW). '가격' 입력란보다 작아야 합니다.

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성을 설정하면 '가격' 대신 사용됩니다(예: 최저 $100.00).

formattedSalePrice

string

서식이 지정된 할인가이며 모든 문자가 될 수 있습니다. 이 속성이 설정되면 '할인가' 대신 사용됩니다(예: $80.00 할인 판매).

category

string

카테고리(예: Express)

contextualKeywords[]

string

문맥 키워드(예: 파리 기차)

similarDestinationIds[]

string

유사 목적지 ID(예: NYC).

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

DynamicLocalAsset

동적 로컬 애셋입니다.

JSON 표현
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
입력란
dealId

string

필수 항목입니다. 문자와 숫자의 임의의 조합으로 된 거래 ID로, 고유하고 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

dealName

string

필수 항목입니다. 할인 상품 이름(예: 마운틴뷰 식료품점 50% 할인) 필수 항목입니다.

subtitle

string

부제목(예: 식료품)

description

string

설명(예: 주간 청구서 할인)

price

string

숫자 뒤에 알파벳 통화 코드가 오는 ISO 4217 표준 가격입니다. 소수점 표시로 '.'를 사용합니다(예: 100.00 USD).

salePrice

string

할인가로 숫자 뒤에 알파벳 통화 코드가 붙을 수 있습니다(ISO 4217 표준). 소수점 표시로 '.'를 사용합니다(예: 80000.00 KRW). '가격' 입력란보다 작아야 합니다.

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

address

string

다음 형식 중 하나로 지정할 수 있는 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

category

string

카테고리(예: 음식)

contextualKeywords[]

string

문맥 키워드(예: 식료품 저장 쿠폰)

formattedPrice

string

형식이 지정된 가격이며 임의의 문자일 수 있습니다. 이 속성을 설정하면 '가격' 대신 사용됩니다(예: 최저 $100.00).

formattedSalePrice

string

서식이 지정된 할인가이며 모든 문자가 될 수 있습니다. 이 속성이 설정되면 '할인가' 대신 사용됩니다(예: $80.00 할인 판매).

similarDealIds[]

string

유사 거래 ID(예: 1275)

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

DynamicJobsAsset

동적 취업정보 애셋

JSON 표현
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
입력란
jobId

string

필수 항목입니다. 문자와 숫자의 임의의 조합으로 된 작업 ID로, 고유해야 하며 리마케팅 태그의 값과 일치해야 합니다. 필수 항목입니다.

locationId

string

문자와 숫자의 조합으로 이루어진 위치 ID입니다. ID 시퀀스 (작업 ID + 위치 ID)는 고유해야 합니다.

jobTitle

string

필수 항목입니다. 직책(예: 소프트웨어 엔지니어) 필수 항목입니다.

jobSubtitle

string

직책 부제목(예: 등급 II)

description

string

설명(예: 기술 역량 적용)

imageUrl

string

이미지 URL, 예: http://www.example.com/image.png 이미지는 이미지 확장 소재로 업로드되지 않습니다.

jobCategory

string

취업정보 카테고리(예: 기술)

contextualKeywords[]

string

문맥 키워드(예: 소프트웨어 엔지니어링 작업)

address

string

다음 형식 중 하나로 지정할 수 있는 주소입니다. (1) 도시, 주, 코드, 국가(예: Mountain View, CA, USA). (2) 전체 주소(예: 123 Boulevard St, Mountain View, CA 94043). (3) DDD 형식의 위도-경도(예: 41.40338, 2.17403)

salary

string

급여(예: $100,000)

similarJobIds[]

string

유사 작업 ID(예: 1275)

iosAppStoreId

string (int64 format)

iOS App Store ID입니다. 사용자가 딥 링크 전에 기기에 앱을 설치했는지 확인하는 데 사용되며 이 필드가 설정되면 iosAppLink 필드도 있어야 합니다.

LocationAsset

위치 확장 소재

JSON 표현
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
입력란
placeId

string

장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 이 입력란은 고객 ID 및 확장 소재 유형별로 고유합니다. 장소 ID에 대한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

businessProfileLocations[]

object (BusinessProfileLocation)

고객의 업체 위치 목록입니다. 이는 위치 확장 소재가 비즈니스 프로필 계정에서 동기화되는 경우에만 반환됩니다. 동일한 계정에 동일한 장소 ID를 가리키는 여러 비즈니스 프로필 비즈니스 정보가 있을 수 있습니다.

locationOwnershipType

enum (LocationOwnershipType)

위치 소유권의 유형입니다. 유형이 BUSINESS_OWNER인 경우 위치 광고 확장으로 게재됩니다. 유형이 AFFILIATE인 경우 제휴사 위치로 게재됩니다.

BusinessProfileLocation

연결된 비즈니스 프로필 계정에서 동기화된 비즈니스 프로필 위치 데이터

JSON 표현
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
입력란
labels[]

string

광고주가 비즈니스 프로필 계정의 위치에 대해 지정한 라벨입니다. 비즈니스 프로필 계정에서 동기화됩니다.

storeCode

string

이 위치의 비즈니스 프로필 판매점 코드입니다. 비즈니스 프로필 계정에서 동기화됩니다.

listingId

string (int64 format)

이 비즈니스 프로필 위치의 등록정보 ID입니다. 연결된 비즈니스 프로필 계정에서 동기화됩니다.

HotelPropertyAsset

호텔 숙박 시설 애셋입니다.

JSON 표현
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
입력란
placeId

string

장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

hotelAddress

string

호텔의 주소입니다. 읽기 전용입니다.

hotelName

string

호텔 이름입니다. 읽기 전용입니다.