REST Resource: advertisers.adGroupAds

리소스: AdGroupAd

광고 그룹과 연결된 단일 광고입니다.

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of list of possible types for union field ad_details.
}
필드
name

string

출력 전용입니다. 광고의 리소스 이름입니다.
advertiserId

string (int64 format)

출력 전용입니다. 광고가 속한 광고주의 고유 ID입니다.
adGroupAdId

string (int64 format)

출력 전용입니다. 광고의 고유 ID입니다. 시스템에서 할당합니다.
adGroupId

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. 광고가 속한 광고 그룹의 고유 ID입니다.
displayName

string

필수 항목입니다. 광고의 표시 이름입니다.

최대 크기가 255바이트인 UTF-8로 인코딩되어야 합니다.
adPolicy

object (AdPolicy)

출력 전용입니다. 광고의 정책 승인 상태입니다.
entityStatus

enum (EntityStatus)

필수 항목입니다. 광고의 항목 상태입니다.
adUrls[]

object (AdUrl)

출력 전용입니다. 광고에서 사용되는 URL 목록입니다.
dcmTrackingInfo

object (DcmTrackingInfo)

선택사항입니다. DCM 추적 광고 정보입니다. 디맨드젠 광고에만 유효합니다.

DCM 추적 광고 정보를 삭제하려면 이 필드를 비워 두세요.
통합 필드 ad_details. 광고 세부정보입니다. ad_details은 다음 중 하나여야 합니다.
displayVideoSourceAd

object (DisplayVideoSourceAd)

출력 전용입니다. Display & Video 360 광고 소재에서 가져온 광고의 세부정보입니다.
mastheadAd

object (MastheadAd)

출력 전용입니다. YouTube 홈 피드에 게재되는 광고의 세부정보입니다.
inStreamAd

object (InStreamAd)

출력 전용입니다. 브랜드 인지도 또는 도달범위 마케팅 목표에 사용되는 5초 후에 건너뛸 수 있는 인스트림 광고의 세부정보입니다.
nonSkippableAd

object (NonSkippableAd)

출력 전용입니다. 도달범위 마케팅 목표에 사용되는 6~15초 길이의 건너뛸 수 없는 짧은 인스트림 동영상 광고의 세부정보입니다.
bumperAd

object (BumperAd)

출력 전용입니다. 도달범위에 사용되며 길이가 6초 이하인 건너뛸 수 없는 짧은 동영상 광고의 세부정보입니다.
audioAd

object (AudioAd)

출력 전용입니다. 도달범위 마케팅 목표에 사용되는 오디오 광고의 세부정보입니다.
videoDiscoverAd

object (VideoDiscoveryAd)

출력 전용입니다. 디스커버리 위치에 표시되는 동영상을 홍보하는 광고의 세부정보입니다.
videoPerformanceAd

object (VideoPerformanceAd)

출력 전용입니다. 비즈니스, 서비스 또는 제품에 대한 액션을 유도하기 위해 동영상 액션 캠페인에 사용된 광고의 세부정보입니다.
demandGenVideoAd

object (DemandGenVideoAd)

디맨드젠 동영상 광고의 세부정보입니다.
demandGenImageAd

object (DemandGenImageAd)

디맨드젠 이미지 광고의 세부정보입니다.
demandGenProductAd

object (DemandGenProductAd)

디맨드젠 제품 광고의 세부정보입니다.

AdPolicy

광고 그룹 광고와 연결된 단일 광고 정책입니다.

JSON 표현 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
필드
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

승인 결정을 나타내는 광고의 정책 승인 상태입니다.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

광고의 정책 검토 상태로, 현재 광고가 검토 프로세스의 어느 단계에 있는지를 나타냅니다.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

광고와 관련된 것으로 식별된 각 정책 주제의 항목입니다. 각 항목에는 주제, 제한 수준, 정책 문제 해결 방법 안내가 포함되어 있습니다.

AdPolicyApprovalStatus

광고 정책 승인의 가능한 상태입니다.

열거형
AD_POLICY_APPROVAL_STATUS_UNKNOWN 알 수 없거나 지정되지 않았습니다.
DISAPPROVED 게재되지 않습니다.
APPROVED_LIMITED 제한이 적용되어 게재됩니다.
APPROVED 제한 없이 게재됩니다.
AREA_OF_INTEREST_ONLY 타겟팅된 국가에서는 게재되지 않지만 타겟팅된 국가에 관한 정보를 검색하는 사용자에게는 게재될 수 있습니다.

AdPolicyReviewStatus

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

열거형
AD_POLICY_REVIEW_STATUS_UNKNOWN 알 수 없거나 지정되지 않았습니다.
REVIEW_IN_PROGRESS 현재 검토 중입니다.
REVIEWED 기본 검토가 완료되었습니다. 다른 검토는 아직 진행 중일 수 있습니다.
UNDER_APPEAL 승인을 위해 다시 제출되었거나 정책 결정에 대한 이의신청이 제출되었습니다.
ELIGIBLE_MAY_SERVE 게재 가능으로 간주되며 게재될 수 있습니다. 추가 검토가 진행될 수 있습니다.

AdPolicyTopicEntry

광고가 광고 정책과 관련이 있는 것으로 식별된 방법을 설명하는 항목입니다.

JSON 표현 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
필드
policyTopic

string

정책 주제입니다.

예: '상표', '주류' 등
policyLabel

string

정책의 현지화된 라벨 텍스트입니다.

예: '텍스트에 상표 포함', '알코올 포함' 등
policyTopicDescription

string

정책 주제에 관한 간단한 요약 설명입니다.
policyTopicType

enum (AdPolicyTopicEntryType)

광고 정책 주제와의 관련성으로 인해 광고 게재가 어떤 영향을 받는지
policyDecisionType

enum (AdPolicyDecisionType)

정책 결정의 소스입니다.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

정책 검토에 사용되는 정책 시행 수단입니다.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

정책 결정에 사용된 증거입니다.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

정책 결정과 관련된 게재 제약 조건입니다.
appealInfo

object (AdPolicyTopicAppealInfo)

정책 결정에 대해 이의신청하는 방법에 관한 정보입니다.

AdPolicyTopicEntryType

광고 정책 주제가 게재에 미칠 수 있는 영향입니다.

열거형
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN 알 수 없거나 지정되지 않았습니다.
PROHIBITED 리소스가 게재되지 않습니다.
FULLY_LIMITED 이 리소스는 일부 타겟팅 국가에서 게재되지 않습니다.
LIMITED 일부 국가에서는 리소스를 게재할 수 없습니다.
DESCRIPTIVE 리소스가 게재될 수 있습니다.
BROADENING 리소스가 게재될 수 있으며, 일반적인 게재 범위를 넘어 게재될 수도 있습니다.
AREA_OF_INTEREST_ONLY 이 리소스는 모든 대상 국가에서 제한되지만 대상 국가에 관한 정보를 검색하는 사용자에게는 게재될 수 있습니다.

AdPolicyDecisionType

정책 결정의 가능한 소스입니다.

열거형
AD_POLICY_DECISION_TYPE_UNKNOWN 알 수 없거나 지정되지 않았습니다.
PURSUANT_TO_NOTICE 법적 통지, 법원 명령, 상표 콘텐츠 소유자 신고 등에 따른 결정입니다.
GOOGLE_INVESTIGATION 이 결정은 Google 소유 조사에서 내려진 것입니다.

AdPolicyEnforcementMeans

정책 검토에 사용된 가능한 정책 시행 수단입니다.

열거형
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN 알 수 없거나 지정되지 않았습니다.
AUTOMATED 시정 조치 프로세스는 완전히 자동화되었습니다.
HUMAN_REVIEW 결정 시행 절차에 사람이 부분적으로 또는 완전히 관여했습니다.

AdPolicyTopicEvidence

정책 결정에 사용된 증거 정보입니다.

JSON 표현 
{

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
필드
통합 필드 value. 정책 결정의 증거입니다. value은 다음 중 하나여야 합니다.
textList

object (TextList)

광고 텍스트에서 발견된 증거 목록입니다.
websiteList

object (WebsiteList)

광고에 연결된 웹사이트 목록입니다.
httpCode

integer

최종 URL이 크롤링될 때 반환된 HTTP 코드입니다.
languageCode

string

광고가 작성된 것으로 감지된 언어입니다.

이 필드는 'en-US'와 같은 IETF 언어 태그를 사용합니다.
destinationTextList

object (DestinationTextList)

정책 위반을 유발하는 광고 도착 페이지의 텍스트입니다.
destinationMismatch

object (DestinationMismatch)

광고 도착 URL 간의 불일치
destinationNotWorking

object (DestinationNotWorking)

광고 도착 페이지와 관련된 HTTP 또는 DNS 오류에 관한 정보입니다.
trademark

object (Trademark)

정책 위반을 야기한 상표 용어입니다.
legalRemoval

object (LegalRemoval)

정책 위반을 야기한 법률 관련 규정 시행입니다.
counterfeit

object (Counterfeit)

정책 위반을 야기한 위조품 시정 조치입니다.
regionalRequirements

object (RegionalRequirements)

정책 위반을 야기한 T&S 사전 시행입니다.

TextList

정책을 위반한 텍스트의 일부 목록입니다.

JSON 표현 
{
  "texts": [
    string
  ]
}
필드
texts[]

string

정책 발견의 원인이 된 리소스의 텍스트 프래그먼트입니다.

WebsiteList

정책을 위반한 웹사이트 목록입니다.

JSON 표현 
{
  "websites": [
    string
  ]
}
필드
websites[]

string

정책 발견을 유발한 웹사이트입니다.

DestinationTextList

정책을 위반한 대상 텍스트 목록입니다.

JSON 표현 
{
  "destinationTexts": [
    string
  ]
}
필드
destinationTexts[]

string

정책 위반을 야기한 대상 텍스트입니다.

DestinationMismatch

도착 URL 유형 간 불일치에 대한 세부정보입니다.

JSON 표현 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
필드
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

일치하지 않는 URL 집합입니다. 목록에는 단일 또는 여러 URI 유형이 포함될 수 있습니다.

예 1: [DISPLAY_URL, FINAL_URL] 은 광고 표시 URL이 광고 최종 URL과 일치하지 않음을 의미합니다.

예 2: [FINAL_URL] 는 광고 최종 URL이 크롤링된 URL과 일치하지 않음을 의미하며, 이는 도착 페이지 불일치로 간주됩니다.

AdPolicyTopicEvidenceDestinationMismatchUrlType

가능한 URL 유형입니다.

열거형
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN 지정되지 않았거나 알 수 없습니다.
DISPLAY_URL 표시 URL입니다.
FINAL_URL 최종 URL.
FINAL_MOBILE_URL 최종 모바일 URL입니다.
TRACKING_URL 추적 URL입니다.
MOBILE_TRACKING_URL 모바일 추적 URL입니다.

DestinationNotWorking

광고 도착 페이지와 관련된 HTTP 또는 DNS 오류에 대한 세부정보입니다.

JSON 표현 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
필드
expandedUri

string

작동하지 않는 전체 URL입니다.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

URL 방문 시 오류가 발생한 기기입니다.
lastCheckedTime

string (Timestamp format)

URL로 이동할 때 오류가 마지막으로 표시된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
통합 필드 reason. HTTP 또는 DNS 오류입니다. reason은 다음 중 하나여야 합니다.
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS 오류의 유형입니다.
httpErrorCode

string (int64 format)

HTTP 오류 코드입니다.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

가능한 DNS 오류 유형입니다.

열거형
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN 지정되지 않았거나 알 수 없습니다.
HOSTNAME_NOT_FOUND 방문 페이지를 가져올 때 DNS에서 호스트 이름을 찾을 수 없습니다.
GOOGLE_CRAWLER_DNS_ISSUE Google에서 DNS와 통신할 때 방문 페이지를 크롤링할 수 없습니다.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

URL을 방문할 때 오류가 발생한 기기일 수 있습니다.

열거형
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN 지정되지 않았거나 알 수 없습니다.
DESKTOP 데스크톱 기기
ANDROID Android 기기
IOS iOS 기기

상표권

정책 위반을 야기한 상표 용어입니다.

JSON 표현 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
필드
owner

string

상표 콘텐츠 소유자입니다.
term

string

상표 용어입니다.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

정책 위반과 관련된 국가입니다.

AdPolicyCriterionRestriction

국가 제한을 나타냅니다.

JSON 표현 
{
  "countryCriterionId": string,
  "countryLabel": string
}
필드
countryCriterionId

string (int64 format)

국가 기준 ID입니다.
countryLabel

string

국가의 현지화된 이름입니다. 비어 있을 수 있습니다.

LegalRemoval

DMCA 또는 현지 법규에 따른 법적 규제 시행

JSON 표현 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
필드
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

법적 삭제를 야기한 신고 유형입니다.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

법적 삭제로 인해 제한된 국가입니다.
restrictedUris[]

string

법적 삭제로 인해 제한된 URL입니다.
통합 필드 type. 법적 삭제 유형에 대한 세부정보입니다. type은 다음 중 하나여야 합니다.
dmca

object (Dmca)

DMCA 규정 법적 삭제에 관한 세부정보입니다.

DMCA

DMCA 관련 신고 세부정보입니다.

JSON 표현 
{
  "complainant": string
}
필드
complainant

string

법적 불만사항을 제기한 법인입니다.

LocalLegal

현지 법규 세부정보입니다.

JSON 표현 
{
  "lawType": string
}
필드
lawType

string

법적 고지의 법률 유형입니다.

AdPolicyTopicEvidenceLegalRemovalComplaintType

법적 삭제에 대한 가능한 신고 유형입니다.

열거형
COPYRIGHT

저작권.

DMCA에만 적용됩니다.
COURT_ORDER

법원 명령

현지 법률에만 적용됩니다.

위조품

정책 위반을 야기한 위조품 시정 조치에 대한 세부정보입니다.

JSON 표현 
{
  "owners": [
    string
  ]
}
필드
owners[]

string

신고를 제출한 콘텐츠 또는 제품 소유자입니다.

RegionalRequirements

지역 요구사항을 해결하기 위한 정책에 대한 신뢰와 안전 (T&S) 사전 시행 이는 사전 예방적 T&S 시행이므로 규정 알림이 아닌 Google 소유 조사로 간주됩니다.

JSON 표현 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
필드
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

지역별 요구사항 목록입니다.

RegionalRequirementsEntry

정책 수준의 리전 법규 위반 세부정보입니다.

JSON 표현 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
필드
legalPolicy

string

위반된 법적 정책입니다.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

법적 정책으로 인해 제한된 국가입니다.

AdPolicyTopicConstraint

광고 게재 제약 조건에 관한 세부정보입니다.

JSON 표현 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
필드
통합 필드 constraint. 게재 제약 조건입니다. constraint은 다음 중 하나여야 합니다.
countryConstraint

object (AdPolicyCountryConstraintList)

광고를 게재할 수 없는 국가입니다.
resellerConstraint

object (AdPolicyResellerConstraint)

리셀러 제약 조건입니다.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

게재에 인증이 필요한 국가입니다.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

리소스의 도메인이 연결된 인증서로 보호되지 않는 국가입니다.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

모든 국가에서 광고를 게재하려면 인증서가 필요합니다.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

모든 국가에서 게재하려면 인증서가 필요하지만 기존 인증서가 광고의 도메인을 포함하지 않습니다.

AdPolicyCountryConstraintList

정책 제약으로 인해 광고를 게재할 수 없는 국가 목록입니다.

JSON 표현 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
필드
countries[]

object (AdPolicyCriterionRestriction)

광고를 게재할 수 없는 국가입니다.

AdPolicyResellerConstraint

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

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

AdPolicyGlobalCertificateMissingConstraint

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

모든 국가에서 광고를 게재하려면 인증서가 필요합니다.

AdPolicyGlobalCertificateDomainMismatchConstraint

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

모든 국가에서 게재하려면 인증서가 필요하지만 기존 인증서가 광고의 도메인을 포함하지 않습니다.

AdPolicyTopicAppealInfo

정책 결정에 대해 이의신청하는 방법에 관한 정보

JSON 표현 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
필드
appealType

enum (AdPolicyAppealType)

셀프 서비스 이의신청 또는 이의신청 양식을 통해 결정에 이의신청할 수 있는지 여부입니다.

AdPolicyAppealType

가능한 이의신청 유형입니다.

열거형
AD_POLICY_APPEAL_TYPE_UNKNOWN 알 수 없거나 지정되지 않았습니다.
SELF_SERVICE_APPEAL 셀프서비스 이의신청을 통해 결정에 이의를 제기할 수 있습니다.
APPEAL_FORM 이의신청 양식을 사용하여 결정에 이의를 제기할 수 있습니다.

DisplayVideoSourceAd

DV360 광고 소재에서 가져온 광고입니다.

JSON 표현 
{
  "creativeId": string
}
필드
creativeId

string (int64 format)

소스 광고 소재의 ID입니다.

MastheadAd

마스트헤드 광고의 세부정보입니다.

JSON 표현 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
필드
video

object (YoutubeVideoDetails)

광고에서 사용되는 YouTube 동영상입니다.
headline

string

광고의 제목입니다.
description

string

광고 설명입니다.
videoAspectRatio

enum (VideoAspectRatio)

마스트헤드에서 자동 재생되는 YouTube 동영상의 가로세로 비율입니다.
autoplayVideoStartMillisecond

string (int64 format)

동영상 재생이 시작되기까지의 시간(밀리초)입니다.
autoplayVideoDuration

string (Duration format)

동영상이 자동 재생되는 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
callToActionButtonLabel

string

클릭 유도 문구 버튼의 텍스트입니다.
callToActionFinalUrl

string

클릭 유도 문구 버튼의 도착 URL입니다.
callToActionTrackingUrl

string

클릭 유도 문구 버튼의 추적 URL입니다.
showChannelArt

boolean

YouTube 페이지 상단에 표시되는 배경 또는 배너를 표시할지 여부입니다.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

데스크톱에서 마스트헤드 광고 옆에 표시되는 동영상입니다. 두 개 이하로 지정해야 합니다.

YoutubeVideoDetails

YouTube 동영상의 세부정보입니다.

JSON 표현 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
필드
id

string

출력 전용입니다. YouTube 웹페이지에서 검색할 수 있는 YouTube 동영상 ID입니다.
unavailableReason

enum (VideoUnavailableReason)

동영상 데이터를 사용할 수 없는 이유입니다.
videoAssetId

string (int64 format)

필수 항목입니다. YouTube 동영상 애셋 ID입니다. AdAsset 리소스의 adAssetId입니다.

VideoUnavailableReason

동영상을 사용할 수 없는 이유

열거형
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED 알 수 없거나 지정되지 않았습니다.
VIDEO_UNAVAILABLE_REASON_PRIVATE 비공개 동영상입니다.
VIDEO_UNAVAILABLE_REASON_DELETED 동영상이 삭제되었습니다.

VideoAspectRatio

YouTube 동영상의 가능한 가로세로 비율입니다.

열거형
VIDEO_ASPECT_RATIO_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
VIDEO_ASPECT_RATIO_WIDESCREEN 동영상이 늘어나고 상단과 하단이 잘립니다.
VIDEO_ASPECT_RATIO_FIXED_16_9 동영상은 고정된 16:9 가로세로 비율을 사용합니다.

InStreamAd

인스트림 광고의 세부정보입니다.

JSON 표현 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
필드
commonInStreamAttribute

object (CommonInStreamAttribute)

일반적인 광고 속성입니다.
customParameters

map (key: string, value: string)

추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

인스트림 광고, 건너뛸 수 없는 광고, 범퍼 광고의 공통 속성입니다.

JSON 표현 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
필드
displayUrl

string

광고에 표시되는 웹페이지 주소입니다.
finalUrl

string

사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
trackingUrl

string

추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
actionButtonLabel

string

클릭 유도 문구 버튼의 텍스트입니다.
actionHeadline

string

클릭 유도 문구 배너의 광고 제목입니다.
video

object (YoutubeVideoDetails)

광고의 YouTube 동영상입니다.
companionBanner

object (ImageAsset)

동영상 광고 옆에 표시되는 이미지입니다.

ImageAsset

이미지 확장 소재의 메타데이터입니다.

JSON 표현 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
필드
mimeType

string

출력 전용입니다. 이미지 애셋의 MIME 유형입니다.
fullSize

object (Dimensions)

출력 전용입니다. 원래 크기의 이 이미지에 대한 메타데이터입니다.
fileSize

string (int64 format)

출력 전용입니다. 이미지 확장 소재의 파일 크기(바이트)입니다.
assetId

string (int64 format)

필수 항목입니다. 애셋의 고유 ID입니다.

NonSkippableAd

건너뛸 수 없는 광고의 세부정보입니다.

JSON 표현 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
필드
commonInStreamAttribute

object (CommonInStreamAttribute)

일반적인 광고 속성입니다.
customParameters

map (key: string, value: string)

추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

BumperAd

범퍼 광고의 세부정보입니다.

JSON 표현 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
필드
commonInStreamAttribute

object (CommonInStreamAttribute)

일반적인 광고 속성입니다.

AudioAd

오디오 광고의 세부정보입니다.

JSON 표현 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
필드
displayUrl

string

광고에 표시되는 웹페이지 주소입니다.
finalUrl

string

사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
trackingUrl

string

추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
video

object (YoutubeVideoDetails)

광고의 YouTube 동영상입니다.

VideoDiscoveryAd

동영상 디스커버리 광고의 세부정보입니다.

JSON 표현 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
필드
headline

string

광고의 제목입니다.
description1

string

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

string

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

object (YoutubeVideoDetails)

광고에서 홍보하는 YouTube 동영상입니다.
thumbnail

enum (Thumbnail)

광고에 사용되는 썸네일 이미지입니다.

썸네일

동영상 디스커버리 광고에서 사용할 수 있는 썸네일 옵션입니다.

열거형
THUMBNAIL_UNSPECIFIED 알 수 없거나 지정되지 않았습니다.
THUMBNAIL_DEFAULT 기본 썸네일로, 자동 생성되거나 사용자가 업로드할 수 있습니다.
THUMBNAIL_1 동영상에서 생성된 썸네일 1
THUMBNAIL_2 동영상에서 생성된 썸네일 2
THUMBNAIL_3 동영상에서 생성된 썸네일 3

VideoPerformanceAd

동영상 실적 광고의 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
필드
finalUrl

string

사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
trackingUrl

string

추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
actionButtonLabels[]

string

클릭 유도 문구 버튼에 표시되는 텍스트 애셋 목록입니다.
headlines[]

string

클릭 유도문안 배너에 표시되는 광고 제목 목록입니다.
longHeadlines[]

string

클릭 유도 문구 배너에 표시되는 긴 광고 제목 목록입니다.
descriptions[]

string

클릭 유도문안 배너에 표시되는 설명 목록입니다.
displayUrlBreadcrumb1

string

표시 URL의 도메인 뒤에 오는 첫 번째 부분입니다.
displayUrlBreadcrumb2

string

표시 URL에서 도메인 다음의 두 번째 부분입니다.
domain

string

표시 URL의 도메인입니다.
videos[]

object (YoutubeVideoDetails)

이 광고에서 사용되는 YouTube 동영상 애셋 목록입니다.
customParameters

map (key: string, value: string)

추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]

object (ImageAsset)

이 광고에서 사용되는 컴패니언 배너 목록입니다.

DemandGenVideoAd

디맨드젠 캠페인 동영상 광고의 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
필드
finalUrl

string

필수 항목입니다. 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
trackingUrl

string

출력 전용입니다. 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
userSpecifiedTrackingUrl

string

선택사항입니다. 사용자가 수동으로 지정한 추적 URL입니다.
callToAction

enum (CallToAction)

필수 항목입니다. 광고에 표시되는 클릭 유도 문구 버튼입니다.

지원되는 값은 다음과 같습니다.

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

필수 항목입니다. 광고에 표시되는 제목 목록입니다.
longHeadlines[]

string

필수 항목입니다. 광고에 표시되는 긴 광고 제목 목록입니다.
descriptions[]

string

필수 항목입니다. 광고에 표시되는 설명 목록입니다.
displayUrlBreadcrumb1

string

선택사항입니다. 표시 URL에서 도메인 다음의 첫 번째 부분입니다.
displayUrlBreadcrumb2

string

선택사항입니다. 표시 URL에서 도메인 다음의 두 번째 부분입니다.
videos[]

object (YoutubeVideoDetails)

필수 항목입니다. 이 광고에서 사용되는 YouTube 동영상 애셋 목록입니다.
customParameters

map (key: string, value: string)

선택사항입니다. 추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanner

object (ImageAsset)

선택사항입니다. 이 광고에서 사용되는 컴패니언 배너입니다.
finalMobileUrl

string

선택사항입니다. 사용자가 휴대기기에서 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
finalUrlSuffix

string

선택사항입니다. 방문 페이지 URL에 추가할 접미사입니다.
businessName

string

필수 항목입니다. 광고에 표시되는 비즈니스 이름입니다.

CallToAction

디맨드젠 제품/동영상 광고에 사용할 수 있는 클릭 유도 문구 값입니다.

열거형
CALL_TO_ACTION_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
AUTOMATED 자동 처리됩니다.
LEARN_MORE 자세히 알아보기
GET_QUOTE 견적 받기
APPLY_NOW 지금 신청하세요.
SIGN_UP 가입을 선택합니다.
CONTACT_US 문의하기
SUBSCRIBE 구독을 탭합니다.
DOWNLOAD 다운로드를 탭합니다.
BOOK_NOW 지금 예약하세요.
SHOP_NOW 지금 구매하세요.
BUY_NOW 지금 구입하세요.
DONATE_NOW 지금 기부하세요.
ORDER_NOW 지금 주문하세요.
PLAY_NOW 지금 플레이하세요.
SEE_MORE 자세히 알아보기.
START_NOW 지금 시작하고
VISIT_SITE 사이트 방문
WATCH_NOW 지금 시청하세요.

DemandGenImageAd

디맨드젠 캠페인 이미지 광고의 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
필드
finalUrl

string

필수 항목입니다. 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
trackingUrl

string

출력 전용입니다. 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
userSpecifiedTrackingUrl

string

선택사항입니다. 사용자가 수동으로 지정한 추적 URL입니다.
callToAction

string

필수 항목입니다. 광고에 표시되는 클릭 유도 문구 버튼입니다.
headlines[]

string

필수 항목입니다. 광고에 표시되는 제목 목록입니다.
descriptions[]

string

필수 항목입니다. 광고에 표시되는 설명 목록입니다.
customParameters

map (key: string, value: string)

선택사항입니다. 추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
finalMobileUrl

string

선택사항입니다. 사용자가 휴대기기에서 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
finalUrlSuffix

string

선택사항입니다. 방문 페이지 URL에 추가할 접미사입니다.
businessName

string

필수 항목입니다. 광고에 표시되는 비즈니스 이름입니다.
marketingImages[]

object (ImageAsset)

광고에 표시되는 마케팅 이미지 목록입니다.
squareMarketingImages[]

object (ImageAsset)

광고에 표시되는 정사각형 마케팅 이미지 목록입니다.
portraitMarketingImages[]

object (ImageAsset)

광고에 표시되는 세로 모드 마케팅 이미지 목록입니다.
logoImages[]

object (ImageAsset)

광고에 표시되는 로고 이미지 목록입니다.

DemandGenCarouselAd

디맨드젠 캠페인 캐러셀 광고의 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
필드
finalUrl

string

필수 항목입니다. 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
headline

string

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

string

필수 항목입니다. 광고 설명입니다.
cards[]

object (CarouselCard)

필수 항목입니다. 광고에 표시되는 카드 목록입니다.
finalUrlSuffix

string

선택사항입니다. 방문 페이지 URL에 추가할 접미사입니다.
trackingUrl

string

출력 전용입니다. 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
userSpecifiedTrackingUrl

string

선택사항입니다. 사용자가 수동으로 지정한 추적 URL입니다.
businessName

string

필수 항목입니다. 광고에 표시되는 비즈니스 이름입니다.
customParameters

map (key: string, value: string)

선택사항입니다. 추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CarouselCard

디맨드젠 캠페인 캐러셀 카드에 대한 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
필드
finalUrl

string

필수 항목입니다. 사용자가 카드를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
finalMobileUrl

string

선택사항입니다. 사용자가 모바일 기기에서 카드를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
headline

string

필수 항목입니다. 카드의 광고 제목입니다.
callToAction

string

필수 항목입니다. 카드에 표시되는 클릭 유도 문구 버튼의 텍스트입니다.

10자(영문 기준) 이하여야 합니다.
marketingImage

object (ImageAsset)

선택사항입니다. 카드에 표시되는 마케팅 이미지입니다.
squareMarketingImage

object (ImageAsset)

선택사항입니다. 카드에 표시되는 정사각형 마케팅 이미지입니다.
portraitMarketingImage

object (ImageAsset)

선택사항입니다. 카드에 표시되는 세로 마케팅 이미지입니다.

DemandGenProductAd

디맨드젠 제품 광고의 세부정보입니다.

JSON 표현 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
필드
finalUrl

string

필수 항목입니다. 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.
headline

string

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

string

필수 항목입니다. 광고 설명입니다.
finalUrlSuffix

string

선택사항입니다. 방문 페이지 URL에 추가할 접미사입니다.
callToAction

enum (CallToAction)

필수 항목입니다. 광고에 표시되는 클릭 유도 문구 버튼입니다.

지원되는 값은 다음과 같습니다.

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

출력 전용입니다. 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.
userSpecifiedTrackingUrl

string

선택사항입니다. 사용자가 수동으로 지정한 추적 URL입니다.
businessName

string

필수 항목입니다. 광고에 표시되는 비즈니스 이름입니다.
customParameters

map (key: string, value: string)

선택사항입니다. 추적 URL에 추가할 맞춤 매개변수 및 해당 값입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
displayUrlBreadcrumb1

string

선택사항입니다. 표시 URL의 도메인 뒤에 오는 첫 번째 부분입니다.
displayUrlBreadcrumb2

string

선택사항입니다. 표시 URL에서 도메인 다음의 두 번째 부분입니다.

AdUrl

비콘을 포함하여 광고와 관련된 추가 URL입니다.

JSON 표현 
{
  "type": enum (AdUrlType),
  "url": string
}
필드
type

enum (AdUrlType)

광고 URL의 유형입니다.
url

string

URL 문자열 값입니다.

AdUrlType

가능한 광고 URL 유형입니다.

열거형
AD_URL_TYPE_UNSPECIFIED 알 수 없거나 지정되지 않았습니다.
AD_URL_TYPE_BEACON_IMPRESSION 광고 소재의 노출이 게재될 때 핑할 1x1 추적 픽셀입니다.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION 확장형 DCM 노출 비콘입니다. 게재 시에는 여러 비콘으로 확장됩니다.
AD_URL_TYPE_BEACON_CLICK 클릭 이벤트가 트리거될 때 핑할 추적 URL입니다.
AD_URL_TYPE_BEACON_SKIP 건너뛰기 이벤트가 트리거될 때 핑할 추적 URL입니다.

DcmTrackingInfo

DCM 추적에 대한 세부정보입니다.

JSON 표현 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
필드
placementId

string (int64 format)

필수 항목입니다. DCM 게재위치 ID입니다.
trackingAdId

string (int64 format)

필수 항목입니다. DCM 추적 광고 ID입니다.
creativeId

string (int64 format)

필수 항목입니다. DCM 광고 소재 ID입니다.

메서드

create

 광고 그룹 광고를 만듭니다.

delete

 광고 그룹 광고를 삭제합니다.

get

 광고 그룹 광고를 가져옵니다.

list

 광고 그룹 광고를 나열합니다.

patch

 광고 그룹 광고를 업데이트합니다.