REST Resource: customers.ads

FinalAppUrl

특정 운영체제의 앱으로 연결되는 딥 링크의 URL입니다.

JSON 표현 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
입력란
osType

enum (AppUrlOperatingSystemType)

이 URL에서 타겟팅하는 운영체제입니다. 필수 항목입니다.
url

string

앱 딥 링크 URL입니다. 딥 링크는 앱에서 표시하려는 콘텐츠에 해당하는 위치를 지정하며, {scheme}://{host_path} 형식이어야 합니다. 스키마는 열려는 앱을 식별합니다. 앱에 앱 이름으로 시작하는 맞춤 스키마를 사용할 수 있습니다. 호스트와 경로는 앱에서 콘텐츠가 있는 고유한 위치를 지정합니다. 예: 'exampleapp://productid_1234' 필수 항목입니다.

AppUrlOperatingSystemType

운영체제

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
IOS Apple IOS 운영체제
ANDROID Android 운영체제

CustomParameter

trackingUrlTemplate, finalUrls 또는 mobile_final_urls의 맞춤 매개변수 태그에서 사용할 수 있는 매핑입니다.

JSON 표현 
{
  "key": string,
  "value": string
}
입력란
key

string

매개변수 태그 이름과 일치하는 키입니다.
value

string

대체할 값입니다.

AdType

가능한 광고 유형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
TEXT_AD 광고가 텍스트 광고입니다.
EXPANDED_TEXT_AD 광고가 확장 텍스트 광고입니다.
EXPANDED_DYNAMIC_SEARCH_AD 광고가 확장 동적 검색 광고입니다.
HOTEL_AD 광고가 호텔 광고입니다.
SHOPPING_SMART_AD 광고가 스마트 쇼핑 광고입니다.
SHOPPING_PRODUCT_AD 광고가 일반 쇼핑 광고입니다.
VIDEO_AD 광고가 동영상 광고입니다.
IMAGE_AD 이 광고는 이미지 광고입니다.
RESPONSIVE_SEARCH_AD 광고가 반응형 검색 광고입니다.
LEGACY_RESPONSIVE_DISPLAY_AD 광고가 기존 반응형 디스플레이 광고입니다.
APP_AD 광고가 앱 광고입니다.
LEGACY_APP_INSTALL_AD 광고가 기존 앱 설치 광고입니다.
RESPONSIVE_DISPLAY_AD 광고가 반응형 디스플레이 광고입니다.
LOCAL_AD 광고가 지역 광고입니다.
HTML5_UPLOAD_AD 광고가 HTML5_UPLOAD_AD 제품 유형을 사용하는 디스플레이 업로드 광고입니다.
DYNAMIC_HTML5_AD 광고는 DYNAMIC_HTML5_* 제품 유형 중 하나를 사용한 디스플레이 업로드 광고입니다.
APP_ENGAGEMENT_AD 광고가 앱 참여 광고입니다.
SHOPPING_COMPARISON_LISTING_AD 광고가 쇼핑 비교 등록정보 광고입니다.
VIDEO_BUMPER_AD 동영상 범퍼 광고입니다.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 건너뛸 수 없는 인스트림 광고입니다.
VIDEO_OUTSTREAM_AD 동영상 아웃스트림 광고
VIDEO_TRUEVIEW_IN_STREAM_AD 동영상 TrueView 인스트림 광고
VIDEO_RESPONSIVE_AD 동영상 반응형 광고입니다.
SMART_CAMPAIGN_AD 스마트 캠페인 광고
CALL_AD 통화 광고
APP_PRE_REGISTRATION_AD 유니버설 앱 사전 등록 광고
IN_FEED_VIDEO_AD 인피드 동영상 광고
DISCOVERY_MULTI_ASSET_AD 디스커버리 멀티 애셋 광고입니다.
TRAVEL_AD 여행 광고
DISCOVERY_VIDEO_RESPONSIVE_AD 디스커버리 동영상 반응형 광고

기기

타겟팅에 사용할 수 있는 Google Ads 기기를 나열합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
MOBILE 풀브라우징 기능이 탑재된 휴대기기
TABLET 풀브라우징 기능이 탑재된 태블릿
DESKTOP 컴퓨터
CONNECTED_TV 스마트 TV 및 게임 콘솔
OTHER 기타 기기 유형.

UrlCollection

고유 식별자로 태그가 추가된 URL 컬렉션입니다.

JSON 표현 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
입력란
finalUrls[]

string

가능한 최종 도착 URL의 목록입니다.
finalMobileUrls[]

string

가능한 최종 모바일 URL의 목록입니다.
urlCollectionId

string

이 UrlCollection 인스턴스의 고유 식별자입니다.
trackingUrlTemplate

string

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

SystemManagedResourceSource

가능한 시스템 관리 항목 소스를 나열하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_VARIATIONS 생성된 유사 광고 실험 광고

TextAdInfo

텍스트 광고입니다.

JSON 표현 
{
  "headline": string,
  "description1": string,
  "description2": string
}
입력란
headline

string

광고의 제목입니다.
description1

string

광고 설명의 첫 번째 줄입니다.
description2

string

광고 설명의 두 번째 줄입니다.

ExpandedTextAdInfo

확장 텍스트 광고입니다.

JSON 표현 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
입력란
headlinePart1

string

광고 제목의 첫 번째 부분입니다.
headlinePart2

string

광고 제목의 두 번째 부분입니다.
headlinePart3

string

광고 제목의 세 번째 부분입니다.
description

string

광고 설명입니다.
description2

string

광고의 두 번째 설명입니다.
path1

string

광고의 표시 URL 옆에 표시될 수 있는 텍스트입니다.
path2

string

광고의 표시 URL 옆에 표시될 수 있는 추가 텍스트입니다.

CallAdInfo

전화 유도 광고

JSON 표현 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
입력란
countryCode

string

광고의 국가 코드입니다.
phoneNumber

string

광고의 전화번호입니다.
businessName

string

광고의 업체 이름입니다.
headline1

string

광고의 첫 번째 광고 제목입니다.
headline2

string

광고의 두 번째 광고 제목입니다.
description1

string

광고 설명의 첫 번째 줄입니다.
description2

string

광고 설명의 두 번째 줄입니다.
callTracked

boolean

광고 소재에 대한 통화 추적 사용 설정 여부입니다. 통화 추적을 사용하면 통화 전환도 활성화됩니다.
disableCallConversion

boolean

광고 소재의 통화 전환을 사용 중지할지 여부입니다. true로 설정하면 callTracked이 true인 경우에도 통화 전환이 사용 중지됩니다. callTracked가 false이면 이 필드는 무시됩니다.
phoneNumberVerificationUrl

string

전화번호 인증에 사용할 URL입니다.
conversionAction

string

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

enum (CallConversionReportingState)

통화 광고의 통화 전환 행동입니다. 자체 통화 전환 설정을 사용하거나 계정 수준 설정을 상속하거나 사용 중지할 수 있습니다.
path1

string

광고의 URL에 추가될 수 있는 텍스트의 첫 부분입니다. 선택사항입니다.
path2

string

광고의 URL에 추가될 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다. 선택사항입니다.

CallConversionReportingState

통화 전환 액션 상태에 사용할 수 있는 데이터 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
DISABLED 통화 전환 액션이 사용 중지되었습니다.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 통화 전환 액션에서는 계정 수준에서 설정된 통화 전환 유형을 사용합니다.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 통화 전환 액션은 리소스 (통화 전용 광고/전화번호 광고 확장) 수준에서 설정된 통화 전환 유형을 사용합니다.

ExpandedDynamicSearchAdInfo

확장 동적 검색 광고

JSON 표현 
{
  "description": string,
  "description2": string
}
입력란
description

string

광고 설명입니다.
description2

string

광고의 두 번째 설명입니다.

HotelAdInfo

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

호텔 광고

ShoppingSmartAdInfo

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

스마트 쇼핑 광고

ShoppingProductAdInfo

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

일반 쇼핑 광고입니다.

ImageAdInfo

이미지 광고입니다.

JSON 표현 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
입력란
mimeType

enum (MimeType)

이미지의 MIME 유형입니다.
pixelWidth

string (int64 format)

원본 크기 이미지의 너비(픽셀)입니다.
pixelHeight

string (int64 format)

원본 크기 이미지의 높이(픽셀)입니다.
imageUrl

string

원본 크기 이미지의 URL입니다.
previewPixelWidth

string (int64 format)

미리보기 크기 이미지의 너비(픽셀)입니다.
previewPixelHeight

string (int64 format)

미리보기 크기 이미지의 높이(픽셀)입니다.
previewImageUrl

string

미리보기 크기 이미지의 URL입니다.
name

string

이미지의 이름입니다. 미디어 파일에서 이미지를 만든 경우에는 미디어 파일의 이름입니다. 이미지가 바이트에서 생성된 경우 비어 있습니다.
통합 필드 image. ImageAd를 만들 이미지입니다. 다음 두 가지 방법 중 하나로 지정할 수 있습니다. 1. 기존 MediaFile 리소스. 2. 바이트 형식의 원시 이미지 데이터입니다. image은 다음 중 하나여야 합니다.
imageAsset

object (AdImageAsset)

광고에 사용된 이미지 애셋입니다.
data

string (bytes format)

바이트 형식의 원시 이미지 데이터입니다.

base64 인코딩 문자열입니다.
adIdToCopyImageFrom

string (int64 format)

이미지를 복사할 광고 ID입니다.

MimeType

MIME 유형

열거형
UNSPECIFIED MIME 유형이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
IMAGE_JPEG image/jpeg의 MIME 유형입니다.
IMAGE_GIF image/gif의 MIME 형식입니다.
IMAGE_PNG image/png의 MIME 형식입니다.
FLASH application/x-shockwave-flash의 MIME 유형입니다.
TEXT_HTML text/html의 MIME 유형입니다.
PDF application/pdf의 MIME 형식입니다.
MSWORD application/msword의 MIME 형식입니다.
MSEXCEL application/vnd.ms-excel의 MIME 유형입니다.
RTF application/rtf의 MIME 유형입니다.
AUDIO_WAV audio/wav의 MIME 형식입니다.
AUDIO_MP3 audio/mp3의 MIME 형식입니다.
HTML5_AD_ZIP application/x-html5-ad-zip의 MIME 유형입니다.

AdImageAsset

광고 내에서 사용되는 이미지 애셋입니다.

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

string

이 이미지의 애셋 리소스 이름입니다.

VideoAdInfo

동영상 광고입니다.

JSON 표현 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
입력란
video

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 애셋입니다.
통합 필드 format. 여러 동영상 형식에 대한 형식별 스키마입니다. format은 다음 중 하나여야 합니다.
inStream

object (VideoTrueViewInStreamAdInfo)

동영상 TrueView 인스트림 광고 형식입니다.
bumper

object (VideoBumperInStreamAdInfo)

동영상 범퍼 인스트림 광고 형식입니다.
outStream

object (VideoOutstreamAdInfo)

동영상 아웃스트림 광고 형식입니다.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

건너뛸 수 없는 인스트림 광고 형식입니다.
inFeed

object (InFeedVideoAdInfo)

인피드 동영상 광고 형식

AdVideoAsset

광고 내에서 사용되는 동영상 애셋입니다.

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

string

이 동영상의 저작물 리소스 이름입니다.

VideoTrueViewInStreamAdInfo

동영상 TrueView 인스트림 광고 형식을 나타냅니다 (동영상이 재생되는 도중에 표시되는 광고. 대개 시작 부분에 표시되며, 동영상에 건너뛰기 버튼을 표시하는 경우가 많음).

JSON 표현 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
입력란
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 CTA (클릭 유도 문구) 버튼의 라벨입니다. 액션 TrueView 캠페인의 경우 필수이며, 그렇지 않은 경우에는 선택사항입니다.
actionHeadline

string

맥락을 제공하고 버튼 클릭을 유도하기 위해 CTA (클릭 유도 문구) 버튼과 함께 표시되는 추가 텍스트입니다.
companionBanner

object (AdImageAsset)

광고에 사용된 컴패니언 배너의 이미지 애셋입니다.

VideoBumperInStreamAdInfo

동영상 범퍼 인스트림 광고 형식 (건너뛸 수 없는 매우 짧은 인스트림 광고)을 나타냅니다.

JSON 표현 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
입력란
companionBanner

object (AdImageAsset)

광고에 사용된 컴패니언 배너의 이미지 애셋입니다.
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 '클릭 유도 문구' 버튼의 라벨
actionHeadline

string

맥락을 제공하고 버튼 클릭을 유도하기 위해 CTA (클릭 유도 문구) 버튼과 함께 표시되는 추가 텍스트입니다.

VideoOutstreamAdInfo

동영상 아웃스트림 광고 형식을 나타냅니다 (소리 없이 자동 재생되는 피드와 함께 게재되는 광고).

JSON 표현 
{
  "headline": string,
  "description": string
}
입력란
headline

string

광고의 제목입니다.
description

string

내용 입력란입니다.

VideoNonSkippableInStreamAdInfo

건너뛸 수 없는 인스트림 광고 형식 (15초 건너뛸 수 없는 인스트림 광고)을 나타냅니다.

JSON 표현 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
입력란
companionBanner

object (AdImageAsset)

광고에 사용된 컴패니언 배너의 이미지 애셋입니다.
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 '클릭 유도 문구' 버튼의 라벨
actionHeadline

string

맥락을 제공하고 버튼 클릭을 유도하기 위해 '클릭 유도 문구' 버튼과 함께 표시되는 추가 텍스트입니다.

InFeedVideoAdInfo

인피드 동영상 광고 형식의 표현입니다.

JSON 표현 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
입력란
headline

string

광고의 제목입니다.
description1

string

광고의 첫 번째 텍스트 줄입니다.
description2

string

광고의 두 번째 텍스트 줄입니다.
thumbnail

enum (VideoThumbnail)

사용할 동영상 썸네일 이미지입니다.

VideoThumbnail

동영상 썸네일의 가능한 유형을 나열하는 열거형입니다.

열거형
UNSPECIFIED 유형이 지정되지 않았습니다.
UNKNOWN 수신된 값을 이 버전에서 알 수 없습니다. 이 값은 응답 전용입니다.
DEFAULT_THUMBNAIL 기본 썸네일입니다. 자동 생성되거나 사용자가 업로드할 수 있습니다.
THUMBNAIL_1 동영상에서 생성된 썸네일 1
THUMBNAIL_2 동영상에서 생성된 썸네일 2
THUMBNAIL_3 동영상에서 생성된 썸네일 3

VideoResponsiveAdInfo

동영상 반응형 광고입니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
입력란
headlines[]

object (AdTextAsset)

짧은 광고 제목에 사용된 텍스트 애셋 목록입니다. 현재 짧은 광고 제목에는 하나의 값만 지원됩니다.
longHeadlines[]

object (AdTextAsset)

긴 광고 제목에 사용된 텍스트 애셋 목록입니다. 현재 긴 광고 제목에는 하나의 값만 지원됩니다.
descriptions[]

object (AdTextAsset)

설명에 사용된 텍스트 애셋 목록입니다. 현재 설명에는 하나의 값만 지원됩니다.
callToActions[]

object (AdTextAsset)

버튼에 사용된 텍스트 애셋 목록(예: '클릭 유도 문구' 버튼) 현재 버튼에는 하나의 값만 지원됩니다.
videos[]

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 애셋의 목록입니다. 현재 YouTube 동영상 저작물에는 하나의 값만 지원됩니다.
companionBanners[]

object (AdImageAsset)

컴패니언 배너에 사용된 이미지 애셋의 목록입니다. 현재 컴패니언 배너 애셋에는 하나의 값만 지원됩니다.
breadcrumb1

string

표시 URL과 함께 광고에 표시되는 텍스트의 첫 부분입니다.
breadcrumb2

string

표시 URL과 함께 광고에 표시되는 텍스트의 두 번째 부분입니다.

AdTextAsset

광고 내에서 사용되는 텍스트 애셋입니다.

JSON 표현 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
입력란
pinnedField

enum (ServedAssetFieldType)

애셋의 고정된 필드입니다. 이렇게 하면 확장 소재가 이 필드 내에서만 게재되도록 제한됩니다. 여러 애셋을 동일한 필드에 고정할 수 있습니다. 다른 필드에 고정 해제되거나 고정된 애셋은 일부 다른 애셋이 고정된 필드에는 게재되지 않습니다.
assetPerformanceLabel

enum (AssetPerformanceLabel)

이 텍스트 애셋의 실적 라벨입니다.
policySummaryInfo

object (AdAssetPolicySummary)

이 텍스트 애셋의 정책 요약입니다.
text

string

애셋 텍스트.

ServedAssetFieldType

가능한 저작물 필드 유형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
HEADLINE_1 광고 제목 1에 사용된 확장 소재입니다.
HEADLINE_2 광고 제목 2에 사용된 확장 소재입니다.
HEADLINE_3 광고 제목 3에 사용된 확장 소재입니다.
DESCRIPTION_1 확장 소재가 내용 입력란 1에 사용되었습니다.
DESCRIPTION_2 광고 확장 소재가 내용 입력란 2에 사용되었습니다.
HEADLINE 확장 소재가 광고 제목에 사용되었습니다. 광고에 광고 제목이 하나만 있는 경우에만 사용합니다. 그 외의 경우에는 HEADLINE_1, HEADLINE_2 또는 HEADLINE_3 enum을 사용하세요.
HEADLINE_IN_PORTRAIT 애셋이 세로 모드 이미지의 광고 제목으로 사용되었습니다.
LONG_HEADLINE 애셋이 긴 광고 제목에 사용되었습니다 (MultiAssetRespondAd에 사용됨).
DESCRIPTION 확장 소재가 내용 입력란에 사용되었습니다. 광고에 설명이 하나만 있는 경우에만 사용합니다. 그렇지 않으면 DESCRIPTION_1 또는 DESCRIPTION_@ enum을 사용합니다.
DESCRIPTION_IN_PORTRAIT 애셋이 세로 모드 이미지의 설명으로 사용되었습니다.
BUSINESS_NAME_IN_PORTRAIT 확장 소재가 세로 모드 이미지에서 업체 이름으로 사용되었습니다.
BUSINESS_NAME 확장 소재가 비즈니스 이름으로 사용되었습니다.
MARKETING_IMAGE 확장 소재가 마케팅 이미지로 사용되었습니다.
MARKETING_IMAGE_IN_PORTRAIT 애셋이 세로 모드 이미지에서 마케팅 이미지로 사용되었습니다.
SQUARE_MARKETING_IMAGE 확장 소재가 정사각형 마케팅 이미지로 사용되었습니다.
PORTRAIT_MARKETING_IMAGE 애셋이 세로 모드 마케팅 이미지로 사용되었습니다.
CALL_TO_ACTION 애셋이 클릭 유도 문구로 사용되었습니다.
YOU_TUBE_VIDEO 저작물이 YouTube 동영상으로 사용되었습니다.
CALL 통화로 사용되는 애셋입니다.
MOBILE_APP 모바일 앱으로 사용되는 애셋입니다.
CALLOUT 콜아웃으로 사용되는 확장 소재입니다.
STRUCTURED_SNIPPET 구조화된 스니펫으로 사용 중인 확장 소재입니다.
PRICE 가격으로 사용되는 애셋입니다.
PROMOTION 프로모션으로 사용되는 애셋입니다.
AD_IMAGE 이미지로 사용된 애셋입니다.
LEAD_FORM 확장 소재가 리드 양식으로 사용됩니다.

AssetPerformanceLabel

애셋의 가능한 실적 라벨을 설명하는 열거형으로, 일반적으로 연결과 관련하여 계산됩니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PENDING 이 애셋은 아직 실적 정보가 없습니다. 아직 검토 중이기 때문일 수 있습니다.
LEARNING 확장 소재에서 노출이 발생하기 시작했지만 통계가 통계적으로 유의미하지 않아 확장 소재 실적 라벨을 표시할 수 없습니다.
LOW 실적이 저조한 애셋
GOOD 실적이 우수한 애셋
BEST 실적이 가장 우수한 애셋

AdAssetPolicySummary

광고 내 애셋의 정책 정보를 포함합니다.

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

object (PolicyTopicEntry)

이 저작물의 정책 발견 항목 목록입니다.
reviewStatus

enum (PolicyReviewStatus)

이 애셋의 검토 과정 중
approvalStatus

enum (PolicyApprovalStatus)

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

PolicyTopicEntry

리소스에 연결된 정책 발견 항목 (예: 주류 판매 사이트와 연결된 주류 정책)

각 PolicyTopicEntry에는 항목과 관련된 특정 광고 정책을 나타내는 주제와 항목이 게재에 미치는 영향을 나타내는 유형이 있습니다. 원하는 경우 발견 항목의 이유를 나타내는 하나 이상의 증거가 포함될 수 있습니다. 선택사항으로 게재가 제한될 수 있는 방법에 대한 세부정보를 제공하는 하나 이상의 제약조건이 있을 수도 있습니다.

JSON 표현 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
입력란
type

enum (PolicyTopicEntryType)

이 정책이 게재에 미칠 부정적 또는 긍정적인 영향을 설명합니다.
evidences[]

object (PolicyTopicEvidence)

정책 발견 항목을 설명하는 추가 정보 (예: 상표 발견 항목의 브랜드 이름)
constraints[]

object (PolicyTopicConstraint)

이 리소스의 제공이 어떤 영향을 받을 수 있는지를 나타냅니다 (예: 특정 국가에 게재되지 않음).
topic

string

이 발견 항목이 참조하는 정책 주제입니다. 예: 'ALCOHOL', 'TRADEMARKS_IN_AD_TEXT', 'DESTINATION_NOT_WORKING' 가능한 정책 주제는 특정 API 버전에 국한된 것이 아니며 언제든지 변경될 수 있습니다.

PolicyTopicEntryType

가능한 정책 주제 항목 유형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
PROHIBITED 리소스가 제공되지 않습니다.
LIMITED 경우에 따라 리소스가 제공되지 않습니다.
FULLY_LIMITED 현재 타겟팅 기준으로 인해 리소스를 전혀 게재할 수 없습니다.
DESCRIPTIVE 흥미로울 수 있지만 리소스가 제공되는 방식을 제한하지는 않습니다.
BROADENING 노출 범위가 평소보다 확대될 수 있습니다.
AREA_OF_INTEREST_ONLY 모든 타겟 국가에 대해 제약을 받지만, 관심 지역을 통해 다른 국가에도 게재할 수 있습니다.

PolicyTopicEvidence

정책 발견 항목을 설명하는 추가 정보입니다.

JSON 표현 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
입력란
통합 필드 value. 증거 유형에 따른 구체적인 증거 정보 value은 다음 중 하나여야 합니다.
websiteList

object (WebsiteList)

이 리소스와 연결된 웹사이트 목록입니다.
textList

object (TextList)

리소스의 텍스트에서 발견된 증거의 목록입니다.
languageCode

string

리소스 작성 시 감지된 언어입니다. 이는 'en-US'와 같은 IETF 언어 태그입니다.
destinationTextList

object (DestinationTextList)

정책 발견의 원인이 되는 리소스의 대상 텍스트입니다.
destinationMismatch

object (DestinationMismatch)

리소스 URL의 대상 위치가 일치하지 않습니다.
destinationNotWorking

object (DestinationNotWorking)

도착 페이지가 HTTP 오류 코드를 반환하거나 일반적으로 사용되는 기기의 모든 위치에서 작동하지 않는 경우의 세부정보입니다.

WebsiteList

정책 발견의 원인이 된 웹사이트 목록입니다. 예를 들어 ONE_WEBSITE_PER_AD_GROUP 정책 주제에 사용됩니다. 웹사이트가 5개 이상인 경우 상위 5개 (리소스에 가장 많이 표시되는 웹사이트)만 여기에 표시됩니다.

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

string

정책 결정의 원인이 된 웹사이트

TextList

정책을 위반한 텍스트 조각 목록입니다.

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

string

정책 발견 항목을 유발한 리소스의 텍스트 조각입니다.

DestinationTextList

도착 페이지에서 정책 발견의 원인이 된 문자열의 목록입니다.

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

string

리소스의 대상 페이지에서 찾은 텍스트 목록입니다.

DestinationMismatch

리소스의 URL 간 불일치 증거.

JSON 표현 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
입력란
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

서로 일치하지 않는 URL 집합입니다.

PolicyTopicEvidenceDestinationMismatchUrlType

가능한 정책 주제 증거 도착 페이지 불일치 URL 유형입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
DISPLAY_URL 표시 URL입니다.
FINAL_URL 최종 URL입니다.
FINAL_MOBILE_URL 최종 모바일 URL입니다.
TRACKING_URL 추적 URL 템플릿(대체 데스크톱 URL 포함)
MOBILE_TRACKING_URL 대체 모바일 URL이 포함된 추적 URL 템플릿

DestinationNotWorking

도착 페이지가 HTTP 오류 코드를 반환하거나 일반적으로 사용되는 기기의 모든 위치에서 작동하지 않는 경우의 증거 세부정보.

JSON 표현 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
입력란
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

URL을 로드하지 못한 기기 유형입니다.
expandedUrl

string

사용할 수 없는 전체 URL
lastCheckedDateTime

string

URL이 마지막으로 확인된 시간입니다. 형식은 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
통합 필드 reason. DESTINATION_NOT_WORKING 정책 결과의 이유를 나타냅니다. reason은 다음 중 하나여야 합니다.
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS 오류 유형입니다.
httpErrorCode

string (int64 format)

HTTP 오류 코드입니다.

PolicyTopicEvidenceDestinationNotWorkingDevice

정책 주제 증거 도착 페이지가 작동하지 않을 수 있습니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
DESKTOP 방문 페이지가 데스크톱 기기에서 작동하지 않습니다.
ANDROID 방문 페이지가 Android 기기에서 작동하지 않습니다.
IOS 방문 페이지는 iOS 기기에서 작동하지 않습니다.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

작동하지 않는 DNS 오류 유형이 있을 수 있는 정책 주제 증거 대상입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
HOSTNAME_NOT_FOUND 방문 페이지를 가져올 때 DNS에서 호스트 이름을 찾을 수 없습니다.
GOOGLE_CRAWLER_DNS_ISSUE DNS와 통신할 때 Google 내부 크롤러 문제가 발생합니다. 이 오류는 방문 페이지가 작동하지 않는다는 것을 의미하지 않습니다. Google에서 방문 페이지를 다시 크롤링합니다.

PolicyTopicConstraint

정책 주제 항목이 게재에 미치는 영향을 설명합니다.

JSON 표현 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
입력란
통합 필드 value. 제약조건에 대한 구체적인 정보 value은 다음 중 하나여야 합니다.
countryConstraintList

object (CountryConstraintList)

리소스를 제공할 수 없는 국가입니다.
resellerConstraint

object (ResellerConstraint)

리셀러 제약조건.
certificateMissingInCountryList

object (CountryConstraintList)

서비스 제공을 위해 인증서가 필요한 국가입니다.
certificateDomainMismatchInCountryList

object (CountryConstraintList)

리소스의 도메인에 연결된 인증서가 적용되지 않는 국가입니다.

CountryConstraintList

리소스의 게재가 제한된 국가 목록입니다.

JSON 표현 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
입력란
countries[]

object (CountryConstraint)

광고 게재가 제한된 국가입니다.
totalTargetedCountries

integer

리소스가 타겟팅하는 총 국가 수입니다.

CountryConstraint

특정 국가에서 리소스를 게재할 수 있는 기능이 제한되어 있음을 나타냅니다.

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

string

게재가 제한되는 국가의 지역 타겟팅 상수 리소스 이름입니다.

ResellerConstraint

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

리셀러 목적으로 웹사이트가 비승인되어 정책 주제가 제한되었음을 나타냅니다.

PolicyReviewStatus

가능한 정책 검토 상태입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
REVIEW_IN_PROGRESS 현재 검토 중입니다.
REVIEWED 기본 검토가 완료되었습니다. 다른 검토는 계속될 수 있습니다.
UNDER_APPEAL 승인을 위해 리소스가 다시 제출되었거나 정책 결정에 대한 이의신청을 제출했습니다.
ELIGIBLE_MAY_SERVE 리소스가 요건을 충족하며 게재 중일 수 있지만 추가 검토가 진행될 수 있습니다.

PolicyApprovalStatus

가능한 정책 승인 상태입니다. 사용 가능한 승인 상태가 여러 개인 경우 가장 심각한 상태가 사용됩니다. 심각도 순서는 DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED, APPROVED입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
DISAPPROVED 게재되지 않습니다.
APPROVED_LIMITED 제한적으로 제공됩니다.
APPROVED 제한 없이 제공됩니다.
AREA_OF_INTEREST_ONLY 타겟 국가에서는 광고가 게재되지 않지만, 타겟팅된 국가에 대한 정보를 검색하는 사용자에게는 광고가 게재될 수 있습니다.

ResponsiveSearchAdInfo

반응형 검색 광고

반응형 검색 광고를 사용하면 더 많은 텍스트와 관련성이 높은 메시지를 고객에게 보여주도록 광고를 만들 수 있습니다. 반응형 검색 광고를 만들 때 여러 광고 제목과 설명을 입력하면, 시간이 지남에 따라 Google Ads에서 자동으로 여러 조합을 테스트하여 어떤 조합이 가장 실적이 좋은지 학습합니다. 반응형 검색 광고는 잠재고객의 검색어와 최대한 일치하도록 광고의 콘텐츠를 조정하여 캠페인 실적을 개선할 수 있습니다.

자세한 내용은 https://support.google.com/google-ads/answer/7684791을 참고하세요.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
입력란
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재될 때 이 목록에서 광고 제목이 선택됩니다.
descriptions[]

object (AdTextAsset)

설명의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
path1

string

광고의 URL에 추가될 수 있는 텍스트의 첫 부분입니다.
path2

string

광고의 URL에 추가될 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다.

LegacyResponsiveDisplayAdInfo

기존 반응형 디스플레이 광고 이 유형의 광고는 Google Ads UI에서 '반응형 광고'로 표시됩니다.

JSON 표현 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
입력란
formatSetting

enum (DisplayAdFormatSetting)

광고가 게재될 형식을 지정합니다. 기본값은 ALL_FORMATS입니다.
shortHeadline

string

광고 제목의 짧은 버전입니다.
longHeadline

string

광고 제목의 긴 버전입니다.
description

string

광고 설명입니다.
businessName

string

광고의 업체 이름입니다.
allowFlexibleColor

boolean

유연한 색상 허용에 대한 광고주의 동의 true인 경우 필요한 경우 광고가 다른 색상으로 게재될 수 있습니다. false인 경우 광고는 지정된 색상 또는 중성색으로 게재됩니다. 기본값은 true입니다. mainColor 및 accentColor가 설정되지 않은 경우 true여야 합니다.
accentColor

string

광고의 강조 색상을 16진수로 지정합니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 것도 필요합니다.
mainColor

string

광고의 기본 색상을 16진수로 지정합니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 것도 필요합니다.
callToActionText

string

광고의 클릭 유도문안 텍스트입니다.
logoImage

string

광고에 사용된 로고 이미지의 MediaFile 리소스 이름입니다.
squareLogoImage

string

광고에 사용된 정사각형 로고 이미지의 MediaFile 리소스 이름입니다.
marketingImage

string

광고에 사용된 마케팅 이미지의 MediaFile 리소스 이름입니다.
squareMarketingImage

string

광고에 사용된 정사각형 마케팅 이미지의 MediaFile 리소스 이름입니다.
pricePrefix

string

가격 앞에 접두사를 추가하세요. (예: '최저').
promoText

string

반응형 광고의 동적 형식에 사용되는 프로모션 텍스트입니다. 예: '2일 무료 배송'

DisplayAdFormatSetting

디스플레이 광고 형식 설정을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
ALL_FORMATS 텍스트, 이미지, 네이티브 형식
NON_NATIVE 텍스트 및 이미지 형식
NATIVE 네이티브 형식(예: 형식 렌더링)은 Google이 아닌 게시자가 관리합니다.

AppAdInfo

앱 광고

JSON 표현 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
입력란
mandatoryAdText

object (AdTextAsset)

필수 광고문안입니다.
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재될 때 이 목록에서 광고 제목이 선택됩니다.
descriptions[]

object (AdTextAsset)

설명의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 이미지 확장 소재의 목록입니다.
youtubeVideos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 YouTube 동영상 애셋의 목록입니다.
html5MediaBundles[]

object (AdMediaBundleAsset)

광고와 함께 사용할 수 있는 미디어 번들 애셋 목록입니다.

AdMediaBundleAsset

광고 내에서 사용되는 미디어 번들 애셋입니다.

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

string

이 미디어 번들의 애셋 리소스 이름입니다.

LegacyAppInstallAdInfo

일부 고객만 사용할 수 있는 기존 앱 설치 광고입니다.

JSON 표현 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
입력란
appStore

enum (LegacyAppInstallAdAppStore)

모바일 앱을 사용할 수 있는 앱 스토어입니다.
appId

string

모바일 앱의 ID입니다.
headline

string

광고의 제목입니다.
description1

string

광고의 첫 번째 내용 입력란입니다.
description2

string

광고의 두 번째 내용 입력란입니다.

LegacyAppInstallAdAppStore

기존 앱 설치 광고의 앱 스토어 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store
WINDOWS_PHONE_STORE Windows Phone Store
CN_APP_STORE 앱이 중국 앱 스토어에서 호스팅됩니다.

ResponsiveDisplayAdInfo

반응형 디스플레이 광고

JSON 표현 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
입력란
marketingImages[]

object (AdImageAsset)

광고에 사용될 마케팅 이미지입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 600x314이고 가로세로 비율은 1.91:1 (+-1%)이어야 합니다. marketingImage가 1개 이상 필요합니다. squareMarketingImages와 결합하면 최댓값은 15입니다.
squareMarketingImages[]

object (AdImageAsset)

광고에 사용되는 정사각형 마케팅 이미지입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 300x300이고 가로세로 비율은 1:1 (+-1%)이어야 합니다. 정사각형 marketingImage이(가) 1개 이상 필요합니다. marketingImages와 결합하면 최댓값은 15입니다.
logoImages[]

object (AdImageAsset)

광고에 사용될 로고 이미지 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 512x128이고 가로세로 비율은 4:1 (+-1%)이어야 합니다. squareLogoImages와 결합하면 최댓값은 5입니다.
squareLogoImages[]

object (AdImageAsset)

광고에 사용될 정사각형 로고 이미지입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (+-1%)이어야 합니다. logoImages와 결합하면 최댓값은 5입니다.
headlines[]

object (AdTextAsset)

광고의 짧은 형식 제목입니다. 최대 길이는 30자(영문 기준)입니다. 광고 제목을 1~5개 지정할 수 있습니다.
longHeadline

object (AdTextAsset)

긴 형식의 필수 광고 제목입니다. 최대 길이는 90자(영문 기준)입니다.
descriptions[]

object (AdTextAsset)

광고 설명 텍스트입니다. 최대 길이는 90자(영문 기준)입니다. 광고 제목을 1~5개 지정할 수 있습니다.
youtubeVideos[]

object (AdVideoAsset)

광고에 사용할 YouTube 동영상입니다(선택사항). 최대 5개의 동영상을 지정할 수 있습니다.
formatSetting

enum (DisplayAdFormatSetting)

광고가 게재될 형식을 지정합니다. 기본값은 ALL_FORMATS입니다.
controlSpec

object (ResponsiveDisplayAdControlSpec)

다양한 광고 소재 관리 기능의 사양입니다.
businessName

string

광고주/브랜드 이름입니다. 최대 디스플레이 너비는 25입니다.
mainColor

string

광고의 기본 색상을 16진수로 지정합니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 것도 필요합니다.
accentColor

string

광고의 강조 색상을 16진수로 지정합니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 것도 필요합니다.
allowFlexibleColor

boolean

유연한 색상 허용에 대한 광고주의 동의 true인 경우 필요한 경우 광고가 다른 색상으로 게재될 수 있습니다. false인 경우 광고는 지정된 색상 또는 중성색으로 게재됩니다. 기본값은 true입니다. mainColor 및 accentColor가 설정되지 않은 경우 true여야 합니다.
callToActionText

string

광고의 클릭 유도문안 텍스트입니다. 최대 디스플레이 너비는 30입니다.
pricePrefix

string

가격 앞에 접두사를 추가하세요. (예: '최저').
promoText

string

반응형 광고의 동적 형식에 사용되는 프로모션 텍스트입니다. 예: '2일 무료 배송'

ResponsiveDisplayAdControlSpec

반응형 디스플레이 광고의 다양한 광고 소재 관리 기능에 대한 사양입니다.

JSON 표현 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
입력란
enableAssetEnhancements

boolean

광고주가 애셋 개선 기능을 선택했는지 여부입니다.
enableAutogenVideo

boolean

광고주가 자동 생성 동영상 기능을 선택했는지 여부입니다.

LocalAdInfo

지역 광고

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
입력란
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재될 때 이 목록에서 광고 제목이 선택됩니다. 광고 제목을 1~5개 지정해야 합니다.
descriptions[]

object (AdTextAsset)

설명의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다. 설명은 1~5개 지정해야 합니다.
callToActions[]

object (AdTextAsset)

클릭 유도 문구의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 클릭 유도 문구가 선택됩니다. 클릭 유도 문구는 1~5개를 지정해야 합니다.
marketingImages[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 마케팅 이미지 확장 소재의 목록입니다. 이미지는 314x600픽셀 또는 320x320픽셀이어야 합니다. 이미지 확장 소재를 1~20개까지 지정해야 합니다.
logoImages[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 로고 이미지 확장 소재의 목록입니다. 이미지는 128x128픽셀이어야 하며 120KB 이하여야 합니다. 이미지 확장 소재를 1~5개까지 지정해야 합니다.
videos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 YouTube 동영상 애셋의 목록입니다. 1~20개의 동영상 애셋을 지정해야 합니다.
path1

string

광고의 URL에 추가될 수 있는 선택 텍스트의 첫 부분입니다.
path2

string

광고의 URL에 추가될 수 있는 선택 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다.

DisplayUploadAdInfo

디스플레이 광고의 일반적인 유형. 정확한 광고 형식은 광고에 포함되어야 하는 데이터의 종류를 결정하는 displayUploadProductType 필드에 의해 제어됩니다.

JSON 표현 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
입력란
displayUploadProductType

enum (DisplayUploadProductType)

이 광고의 제품 유형입니다. 자세한 내용은 enum에 대한 주석을 참조하세요.
통합 필드 media_asset. 광고를 구성하는 애셋 데이터. media_asset은 다음 중 하나여야 합니다.
mediaBundle

object (AdMediaBundleAsset)

광고에 사용될 미디어 번들 애셋입니다. HTML5_UPLOAD_AD용 미디어 번들에 대한 자세한 내용은 https://support.google.com/google-ads/answer/1722096을 참조하세요. 동적 제품 유형에 속하는 미디어 번들은 Google Web Designer를 통해 만들어야 하는 특수한 형식을 사용합니다. 자세한 내용은 https://support.google.com/webdesigner/answer/7543898을 참고하세요.

DisplayUploadProductType

디스플레이 업로드 제품 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
HTML5_UPLOAD_AD HTML5 업로드 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다.
DYNAMIC_HTML5_EDUCATION_AD 동적 HTML5 교육 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 교육 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_FLIGHT_AD 동적 HTML5 광고 게재 기간 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 광고 게재 기간 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_HOTEL_RENTAL_AD 동적 HTML5 호텔 및 임대 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 호텔 캠페인에만 사용할 수 있습니다.
DYNAMIC_HTML5_JOB_AD 동적 HTML5 취업정보 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 취업정보 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_LOCAL_AD 동적 HTML5 지역 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 지역 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_REAL_ESTATE_AD 동적 HTML5 부동산 광고 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 부동산 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_CUSTOM_AD 동적 HTML5 맞춤 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 맞춤 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_TRAVEL_AD 동적 HTML5 여행 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 여행 캠페인에만 사용할 수 있습니다.
DYNAMIC_HTML5_HOTEL_AD 동적 HTML5 호텔 광고입니다. 이 제품 유형에는 DisplayUploadAdInfo에 upload_media_bundle 필드를 설정해야 합니다. 호텔 캠페인에만 사용할 수 있습니다.

AppEngagementAdInfo

앱 재참여 광고를 이용하면 체크인, 구매, 항공권 예약과 같은 앱 내 특정 행동을 촉구하는 텍스트를 광고에 넣을 수 있습니다. 광고 단위를 통해 사용자가 원하는 정보를 더 쉽고 빠르게 찾을 수 있는 앱의 특정 부분으로 이동하게 할 수 있습니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
입력란
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재될 때 이 목록에서 광고 제목이 선택됩니다.
descriptions[]

object (AdTextAsset)

설명의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 이미지 확장 소재의 목록입니다.
videos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 동영상 애셋의 목록입니다.

ShoppingComparisonListingAdInfo

쇼핑 비교 등록정보 광고

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

string

광고의 제목입니다. 필수 입력란입니다. 허용되는 길이는 25~45자(영문 기준)입니다.

SmartCampaignAdInfo

스마트 캠페인 광고

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
입력란
headlines[]

object (AdTextAsset)

광고가 게재될 때 광고 제목에 해당하는 텍스트 애셋 목록입니다. 이 목록은 3~15개의 텍스트 애셋으로 구성됩니다.
descriptions[]

object (AdTextAsset)

광고 게재 시 설명에 해당하는 텍스트 애셋 목록입니다. 이 목록은 2~4개의 텍스트 애셋으로 구성됩니다.

AppPreRegistrationAdInfo

앱 사전 등록 광고는 Google Play의 앱 또는 게임 등록정보로 연결되며 Google Play, YouTube (인스트림만), 디스플레이 네트워크의 다른 앱 및 모바일 웹사이트에 게재될 수 있습니다. 앱 또는 게임에 대한 사용자의 관심을 유도하고 출시 전에 앱 또는 게임의 초기 설치 수를 확보하는 데 도움이 됩니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
입력란
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재될 때 이 목록에서 광고 제목이 선택됩니다.
descriptions[]

object (AdTextAsset)

설명의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 이미지 애셋 ID의 목록입니다.
youtubeVideos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 동영상이 있는 YouTube 동영상 애셋 ID의 목록입니다.

DiscoveryMultiAssetAdInfo

디스커버리 멀티 애셋 광고입니다.

JSON 표현 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
입력란
marketingImages[]

object (AdImageAsset)

광고에 사용될 마케팅 이미지 확장 소재입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 600x314이고 가로세로 비율은 1.91:1 (+-1%)이어야 합니다. SquareMarketingImages가 없는 경우 필수입니다. squareMarketingImages 및 portraitMarketingImages를 조합하면 최댓값은 20입니다.
squareMarketingImages[]

object (AdImageAsset)

광고에 사용될 정사각형 마케팅 이미지 확장 소재입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 300x300이고 가로세로 비율은 1:1 (+-1%)이어야 합니다. MarketingImages가 없는 경우 필수입니다. marketingImages 및 portraitMarketingImages를 조합하면 최댓값은 20입니다.
portraitMarketingImages[]

object (AdImageAsset)

광고에 사용할 세로 모드 마케팅 이미지 애셋입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 480x600이고 가로세로 비율은 4:5 (+-1%)여야 합니다. marketingImages 및 squareMarketingImages를 조합하면 최댓값은 20입니다.
logoImages[]

object (AdImageAsset)

광고에 사용될 로고 이미지 애셋입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (+-1%)이어야 합니다. 로고 이미지를 1~5개까지 지정할 수 있습니다.
headlines[]

object (AdTextAsset)

광고의 광고 제목 텍스트 애셋입니다. 최대 디스플레이 너비는 30입니다. 광고 제목을 1~5개 지정할 수 있습니다.
descriptions[]

object (AdTextAsset)

광고를 설명하는 텍스트입니다. 최대 디스플레이 너비는 90입니다. 1~5개의 설명을 지정할 수 있습니다.
businessName

string

광고주/브랜드 이름입니다. 최대 디스플레이 너비는 25입니다. 필수 항목입니다.
callToActionText

string

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

boolean

이 광고를 리드 양식과 함께 게재해야 하는지 여부를 나타내는 부울 옵션입니다.

DiscoveryCarouselAdInfo

디스커버리 캐러셀 광고

JSON 표현 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
입력란
businessName

string

필수 항목입니다. 광고주/브랜드 이름입니다.
logoImage

object (AdImageAsset)

필수 항목입니다. 광고에 사용될 로고 이미지입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (+-1%)이어야 합니다.
headline

object (AdTextAsset)

필수 항목입니다. 광고의 제목입니다.
description

object (AdTextAsset)

필수 항목입니다. 광고를 설명하는 텍스트입니다.
callToActionText

string

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

object (AdDiscoveryCarouselCardAsset)

필수 항목입니다. 광고와 함께 표시될 캐러셀 카드입니다. 최소 2~10개입니다.

AdDiscoveryCarouselCardAsset

광고 내에서 사용되는 디스커버리 캐러셀 카드 애셋입니다.

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

string

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

DiscoveryVideoResponsiveAdInfo

디스커버리 동영상 반응형 광고입니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
입력란
headlines[]

object (AdTextAsset)

짧은 광고 제목에 사용된 텍스트 애셋 목록입니다.
longHeadlines[]

object (AdTextAsset)

긴 광고 제목에 사용된 텍스트 애셋 목록입니다.
descriptions[]

object (AdTextAsset)

설명에 사용된 텍스트 애셋 목록입니다.
videos[]

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 애셋의 목록입니다.
logoImages[]

object (AdImageAsset)

광고에 사용될 로고 이미지입니다. 유효한 이미지 형식은 GIF, JPEG 및 PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (+-1%)이어야 합니다.
breadcrumb1

string

표시 URL과 함께 광고에 표시되는 텍스트의 첫 부분입니다.
breadcrumb2

string

표시 URL과 함께 광고에 표시되는 텍스트의 두 번째 부분입니다.
businessName

object (AdTextAsset)

필수 항목입니다. 광고주/브랜드 이름입니다.
callToActions[]

object (AdCallToActionAsset)

'클릭 유도 문구' 버튼에 사용된 CallToActionAsset 유형의 확장 소재입니다.

AdCallToActionAsset

광고 내에서 사용되는 클릭 유도 문구 애셋입니다.

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

string

이 클릭 유도 문구 애셋의 애셋 리소스 이름입니다.

TravelAdInfo

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

여행 광고

방법

get

 요청된 광고를 자세히 반환합니다.

mutate

 광고를 업데이트합니다.