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)
    }
  ],

  // 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)
  }
  // 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 목록입니다.

통합 필드 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)

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

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)
}
필드
id

string

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

unavailableReason

enum (VideoUnavailableReason)

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

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
}
필드
mimeType

string

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

fullSize

object (Dimensions)

원래 크기의 이 이미지에 대한 메타데이터입니다.

fileSize

string (int64 format)

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

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)

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

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입니다.

메서드

get

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

list

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