- 리소스: AdGroupAd
 - AdPolicy
 - AdPolicyApprovalStatus
 - AdPolicyReviewStatus
 - AdPolicyTopicEntry
 - AdPolicyTopicEntryType
 - AdPolicyDecisionType
 - AdPolicyEnforcementMeans
 - AdPolicyTopicEvidence
 - TextList
 - WebsiteList
 - DestinationTextList
 - DestinationMismatch
 - AdPolicyTopicEvidenceDestinationMismatchUrlType
 - DestinationNotWorking
 - AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
 - AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
 - 상표
 - AdPolicyCriterionRestriction
 - LegalRemoval
 - Dmca
 - LocalLegal
 - AdPolicyTopicEvidenceLegalRemovalComplaintType
 - 위조품
 - RegionalRequirements
 - RegionalRequirementsEntry
 - AdPolicyTopicConstraint
 - AdPolicyCountryConstraintList
 - AdPolicyResellerConstraint
 - AdPolicyGlobalCertificateMissingConstraint
 - AdPolicyGlobalCertificateDomainMismatchConstraint
 - AdPolicyTopicAppealInfo
 - AdPolicyAppealType
 - DisplayVideoSourceAd
 - MastheadAd
 - YoutubeVideoDetails
 - VideoUnavailableReason
 - VideoAspectRatio
 - InStreamAd
 - CommonInStreamAttribute
 - ImageAsset
 - NonSkippableAd
 - BumperAd
 - AudioAd
 - VideoDiscoveryAd
 - 썸네일
 - VideoPerformanceAd
 - AdUrl
 - AdUrlType
 - 메서드
 
리소스: AdGroupAd
광고 그룹과 연결된 단일 광고입니다.
| JSON 표현 | 
|---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object (  | 
              
| 필드 | |
|---|---|
name | 
                
                   
 광고의 리소스 이름입니다.  | 
              
advertiserId | 
                
                   
 광고가 속한 광고주의 고유 ID입니다.  | 
              
adGroupAdId | 
                
                   
 광고의 고유 ID입니다. 시스템에서 할당합니다.  | 
              
adGroupId | 
                
                   
 광고가 속한 광고 그룹의 고유 ID입니다.  | 
              
displayName | 
                
                   
 광고의 표시 이름입니다. 최대 크기가 255바이트인 UTF-8로 인코딩되어야 합니다.  | 
              
adPolicy | 
                
                   
 광고의 정책 승인 상태입니다.  | 
              
entityStatus | 
                
                   
 광고의 항목 상태입니다.  | 
              
adUrls[] | 
                
                   
 광고에서 사용되는 URL 목록입니다.  | 
              
통합 필드  ad_details은 다음 중 하나일 수 있습니다. | 
              |
displayVideoSourceAd | 
                
                   
 Display & Video 360 광고 소재에서 가져온 광고의 세부정보입니다.  | 
              
mastheadAd | 
                
                   
 YouTube 홈 피드에 게재되는 광고의 세부정보입니다.  | 
              
inStreamAd | 
                
                   
 브랜드 인지도 또는 도달범위 마케팅 목표에 사용되는 5초 후에 건너뛸 수 있는 인스트림 광고의 세부정보입니다.  | 
              
nonSkippableAd | 
                
                   
 도달범위 마케팅 목표에 사용되는 6~15초 길이의 건너뛸 수 없는 짧은 인스트림 동영상 광고의 세부정보입니다.  | 
              
bumperAd | 
                
                   
 도달범위에 사용되며 길이가 6초 이하인 건너뛸 수 없는 짧은 동영상 광고의 세부정보입니다.  | 
              
audioAd | 
                
                   
 도달범위 마케팅 목표에 사용되는 오디오 광고의 세부정보입니다.  | 
              
videoDiscoverAd | 
                
                   
 디스커버리 위치에 표시되는 동영상을 홍보하는 광고의 세부정보입니다.  | 
              
videoPerformanceAd | 
                
                   
 비즈니스, 서비스 또는 제품에 대한 액션을 유도하기 위해 동영상 액션 캠페인에 사용되는 광고의 세부정보입니다.  | 
              
AdPolicy
광고 그룹 광고와 연결된 단일 광고 정책입니다.
| JSON 표현 | 
|---|
{ "adPolicyApprovalStatus": enum (  | 
              
| 필드 | |
|---|---|
adPolicyApprovalStatus | 
                
                   
 승인 결정을 나타내는 광고의 정책 승인 상태입니다.  | 
              
adPolicyReviewStatus | 
                
                   
 광고의 정책 검토 상태로, 현재 광고가 검토 프로세스의 어느 단계에 있는지를 나타냅니다.  | 
              
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 (  | 
              
| 필드 | |
|---|---|
policyTopic | 
                
                   
 정책 주제입니다. 예: '상표', '주류' 등  | 
              
policyLabel | 
                
                   
 정책의 현지화된 라벨 텍스트입니다. 예: '텍스트에 상표 포함', '알코올 포함' 등  | 
              
policyTopicDescription | 
                
                   
 정책 주제에 관한 간단한 요약 설명입니다.  | 
              
policyTopicType | 
                
                   
 광고 정책 주제와의 관계에 따라 광고 게재가 어떻게 영향을 받는지  | 
              
policyDecisionType | 
                
                   
 정책 결정의 소스입니다.  | 
              
policyEnforcementMeans | 
                
                   
 정책 검토에 사용되는 정책 시행 수단입니다.  | 
              
policyTopicEvidences[] | 
                
                   
 정책 결정에 사용된 증거입니다.  | 
              
policyTopicConstraints[] | 
                
                   
 정책 결정과 관련된 게재 제약 조건입니다.  | 
              
helpCenterLink | 
                
                   
 정책 주제의 광고 정책 고객센터 링크입니다.  | 
              
appealInfo | 
                
                   
 정책 결정에 대해 이의신청하는 방법에 관한 정보입니다.  | 
              
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. 정책 결정의 증거입니다. value은 다음 중 하나여야 합니다. | 
              |
textList | 
                
                   
 광고 텍스트에서 발견된 증거 목록입니다.  | 
              
websiteList | 
                
                   
 광고에 연결된 웹사이트 목록입니다.  | 
              
httpCode | 
                
                   
 최종 URL이 크롤링될 때 반환된 HTTP 코드입니다.  | 
              
languageCode | 
                
                   
 광고가 작성된 것으로 감지된 언어입니다. 이 필드는 'en-US'와 같은 IETF 언어 태그를 사용합니다.  | 
              
destinationTextList | 
                
                   
 정책 위반을 일으키는 광고 도착 페이지의 텍스트입니다.  | 
              
destinationMismatch | 
                
                   
 광고 도착 URL 간의 불일치  | 
              
destinationNotWorking | 
                
                   
 광고 도착 페이지와 관련된 HTTP 또는 DNS 오류에 관한 정보입니다.  | 
              
trademark | 
                
                   
 정책 위반을 야기한 상표 용어입니다.  | 
              
legalRemoval | 
                
                   
 정책 위반을 야기한 법률 관련 규정 시행입니다.  | 
              
counterfeit | 
                
                   
 정책 위반을 야기한 위조품 시정 조치입니다.  | 
              
regionalRequirements | 
                
                   
 정책 위반을 야기한 T&S 사전 시행  | 
              
TextList
정책을 위반한 텍스트의 일부 목록입니다.
| JSON 표현 | 
|---|
{ "texts": [ string ] }  | 
              
| 필드 | |
|---|---|
texts[] | 
                
                   
 정책 발견의 원인이 된 리소스의 텍스트 프래그먼트입니다.  | 
              
WebsiteList
정책을 위반한 웹사이트 목록입니다.
| JSON 표현 | 
|---|
{ "websites": [ string ] }  | 
              
| 필드 | |
|---|---|
websites[] | 
                
                   
 정책 발견을 야기한 웹사이트입니다.  | 
              
DestinationTextList
정책을 위반한 대상 텍스트 목록입니다.
| JSON 표현 | 
|---|
{ "destinationTexts": [ string ] }  | 
              
| 필드 | |
|---|---|
destinationTexts[] | 
                
                   
 정책 위반을 야기한 대상 텍스트입니다.  | 
              
DestinationMismatch
도착 URL 유형 간 불일치에 대한 세부정보입니다.
| JSON 표현 | 
|---|
{
  "uriTypes": [
    enum ( | 
              
| 필드 | |
|---|---|
uriTypes[] | 
                
                   
 일치하지 않는 URL 집합입니다. 목록에는 단일 또는 여러 URI 유형이 포함될 수 있습니다. 예 1: [ 예 2: [  | 
              
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 (  | 
              
| 필드 | |
|---|---|
expandedUri | 
                
                   
 작동하지 않는 전체 URL입니다.  | 
              
device | 
                
                   
 URL 방문 시 오류가 발생한 기기입니다.  | 
              
lastCheckedTime | 
                
                   
 URL로 이동할 때 오류가 마지막으로 표시된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면   | 
              
통합 필드 reason. HTTP 또는 DNS 오류입니다. reason은 다음 중 하나여야 합니다. | 
              |
dnsErrorType | 
                
                   
 DNS 오류의 유형입니다.  | 
              
httpErrorCode | 
                
                   
 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 ( | 
              
| 필드 | |
|---|---|
owner | 
                
                   
 상표 콘텐츠 소유자입니다.  | 
              
term | 
                
                   
 상표 용어입니다.  | 
              
countryRestrictions[] | 
                
                   
 정책 위반과 관련된 국가입니다.  | 
              
AdPolicyCriterionRestriction
국가 제한을 나타냅니다.
| JSON 표현 | 
|---|
{ "countryCriterionId": string, "countryLabel": string }  | 
              
| 필드 | |
|---|---|
countryCriterionId | 
                
                   
 국가 기준 ID입니다.  | 
              
countryLabel | 
                
                   
 국가의 현지화된 이름입니다. 비어 있을 수 있습니다.  | 
              
LegalRemoval
DMCA 또는 현지 법규에 따른 법적 규제 시행
| JSON 표현 | 
|---|
{ "complaintType": enum (  | 
              
| 필드 | |
|---|---|
complaintType | 
                
                   
 법적 삭제를 야기한 신고 유형입니다.  | 
              
countryRestrictions[] | 
                
                   
 법적 삭제로 인해 제한된 국가입니다.  | 
              
restrictedUris[] | 
                
                   
 법적 삭제로 인해 제한된 URL입니다.  | 
              
통합 필드 type. 법적 삭제 유형에 관한 세부정보입니다. type은 다음 중 하나여야 합니다. | 
              |
dmca | 
                
                   
 DMCA 규정 법적 삭제에 관한 세부정보입니다.  | 
              
localLegal | 
                
                   
 현지 법규에 따른 법적 삭제에 관한 세부정보입니다.  | 
              
DMCA
DMCA 관련 신고 세부정보입니다.
| JSON 표현 | 
|---|
{ "complainant": string }  | 
              
| 필드 | |
|---|---|
complainant | 
                
                   
 법적 불만사항을 제기한 법인입니다.  | 
              
LocalLegal
현지 법규 세부정보입니다.
| JSON 표현 | 
|---|
{ "lawType": string }  | 
              
| 필드 | |
|---|---|
lawType | 
                
                   
 법적 고지의 법률 유형입니다.  | 
              
AdPolicyTopicEvidenceLegalRemovalComplaintType
법적 삭제에 대한 가능한 신고 유형입니다.
| 열거형 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN | 
                지정되지 않았거나 알 수 없습니다. | 
COPYRIGHT | 
                저작권. DMCA에만 적용됩니다.  | 
              
COURT_ORDER | 
                법원 명령 현지 법률에만 적용됩니다.  | 
              
LOCAL_LEGAL | 
                현지 법적 규정 현지 법률에만 적용됩니다.  | 
              
위조품
정책 위반을 야기한 위조품 시정 조치에 대한 세부정보입니다.
| JSON 표현 | 
|---|
{ "owners": [ string ] }  | 
              
| 필드 | |
|---|---|
owners[] | 
                
                   
 신고를 제출한 콘텐츠 또는 제품 소유자입니다.  | 
              
RegionalRequirements
지역 요구사항을 해결하기 위한 정책에 대한 신뢰와 안전 (T&S) 사전 시행 이는 사전 예방적 T&S 시행이므로 규정 고지 대신 Google 소유 조사로 간주됩니다.
| JSON 표현 | 
|---|
{
  "regionalRequirementsEntries": [
    {
      object ( | 
              
| 필드 | |
|---|---|
regionalRequirementsEntries[] | 
                
                   
 지역별 요구사항 목록입니다.  | 
              
RegionalRequirementsEntry
정책 수준의 리전 법규 위반 세부정보입니다.
| JSON 표현 | 
|---|
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object ( | 
              
| 필드 | |
|---|---|
legalPolicy | 
                
                   
 위반된 법적 정책입니다.  | 
              
countryRestrictions[] | 
                
                   
 법적 정책으로 인해 제한된 국가입니다.  | 
              
AdPolicyTopicConstraint
광고 게재 제약 조건에 관한 세부정보입니다.
| JSON 표현 | 
|---|
{ "requestCertificateFormLink": string, // Union field  | 
              
| 필드 | |
|---|---|
requestCertificateFormLink | 
                
                   
 제약 조건의 인증서를 요청하는 양식 링크  | 
              
통합 필드 constraint. 게재 제약 조건입니다. constraint은 다음 중 하나여야 합니다. | 
              |
countryConstraint | 
                
                   
 광고를 게재할 수 없는 국가입니다.  | 
              
resellerConstraint | 
                
                   
 리셀러 제약 조건입니다.  | 
              
certificateMissingCountryList | 
                
                   
 게재에 인증이 필요한 국가입니다.  | 
              
certificateDomainMismatchCountryList | 
                
                   
 리소스의 도메인이 연결된 인증서로 보호되지 않는 국가입니다.  | 
              
globalCertificateMissing | 
                
                   
 모든 국가에서 광고를 게재하려면 인증서가 필요합니다.  | 
              
globalCertificateDomainMismatch | 
                
                   
 모든 국가에서 게재하려면 인증서가 필요하지만 기존 인증서가 광고의 도메인을 포함하지 않습니다.  | 
              
AdPolicyCountryConstraintList
정책 제약으로 인해 광고를 게재할 수 없는 국가의 목록입니다.
| JSON 표현 | 
|---|
{
  "countries": [
    {
      object ( | 
              
| 필드 | |
|---|---|
countries[] | 
                
                   
 광고를 게재할 수 없는 국가입니다.  | 
              
AdPolicyResellerConstraint
이 유형에는 필드가 없습니다.
리셀러 목적으로 웹사이트가 비승인되어 정책 주제가 제한되었습니다.
AdPolicyGlobalCertificateMissingConstraint
이 유형에는 필드가 없습니다.
모든 국가에서 광고를 게재하려면 인증서가 필요합니다.
AdPolicyGlobalCertificateDomainMismatchConstraint
이 유형에는 필드가 없습니다.
모든 국가에서 게재하려면 인증서가 필요하지만 기존 인증서가 광고의 도메인을 포함하지 않습니다.
AdPolicyTopicAppealInfo
정책 결정에 대해 이의신청하는 방법에 관한 정보
| JSON 표현 | 
|---|
{
  "appealType": enum ( | 
              
| 필드 | |
|---|---|
appealType | 
                
                   
 셀프 서비스 이의신청 또는 이의신청 양식을 통해 결정에 이의신청할 수 있는지 여부입니다.  | 
              
appealFormLink | 
                
                   
 
  | 
              
AdPolicyAppealType
가능한 이의신청 유형입니다.
| 열거형 | |
|---|---|
AD_POLICY_APPEAL_TYPE_UNKNOWN | 
                알 수 없거나 지정되지 않았습니다. | 
SELF_SERVICE_APPEAL | 
                셀프서비스 이의신청을 통해 결정에 이의를 제기할 수 있습니다. | 
APPEAL_FORM | 
                이의신청 양식을 사용하여 결정에 이의를 제기할 수 있습니다. | 
DisplayVideoSourceAd
DV360 광고 소재에서 가져온 광고입니다.
| JSON 표현 | 
|---|
{ "creativeId": string }  | 
              
| 필드 | |
|---|---|
creativeId | 
                
                   
 소스 광고 소재의 ID입니다.  | 
              
MastheadAd
마스트헤드 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{ "video": { object (  | 
              
| 필드 | |
|---|---|
video | 
                
                   
 광고에서 사용되는 YouTube 동영상입니다.  | 
              
headline | 
                
                   
 광고의 제목입니다.  | 
              
description | 
                
                   
 광고 설명입니다.  | 
              
videoAspectRatio | 
                
                   
 마스트헤드에서 자동 재생되는 YouTube 동영상의 가로세로 비율입니다.  | 
              
autoplayVideoStartMillisecond | 
                
                   
 동영상 재생이 시작되기까지의 시간(밀리초)입니다.  | 
              
autoplayVideoDuration | 
                
                   
 동영상이 자동 재생되는 시간입니다. 소수점 아래가 최대 9자리까지이고 '  | 
              
callToActionButtonLabel | 
                
                   
 클릭 유도 문구 버튼의 텍스트입니다.  | 
              
callToActionFinalUrl | 
                
                   
 클릭 유도 문구 버튼의 도착 URL입니다.  | 
              
callToActionTrackingUrl | 
                
                   
 클릭 유도 문구 버튼의 추적 URL입니다.  | 
              
showChannelArt | 
                
                   
 YouTube 페이지 상단에 표시되는 배경 또는 배너를 표시할지 여부입니다.  | 
              
companionYoutubeVideos[] | 
                
                   
 데스크톱에서 마스트헤드 광고 옆에 표시되는 동영상입니다. 두 개 이하로 지정해야 합니다.  | 
              
YoutubeVideoDetails
YouTube 동영상의 세부정보입니다.
| JSON 표현 | 
|---|
{
  "id": string,
  "unavailableReason": enum ( | 
              
| 필드 | |
|---|---|
id | 
                
                   
 YouTube 웹페이지에서 검색할 수 있는 YouTube 동영상 ID입니다.  | 
              
unavailableReason | 
                
                   
 동영상 데이터를 사용할 수 없는 이유입니다.  | 
              
VideoAspectRatio
YouTube 동영상의 가능한 가로세로 비율입니다.
| 열거형 | |
|---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED | 
                지정되지 않았거나 알 수 없습니다. | 
VIDEO_ASPECT_RATIO_WIDESCREEN | 
                동영상이 늘어나고 상단과 하단이 잘립니다. | 
VIDEO_ASPECT_RATIO_FIXED_16_9 | 
                동영상은 고정된 16:9 가로세로 비율을 사용합니다. | 
InStreamAd
인스트림 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{
  "commonInStreamAttribute": {
    object ( | 
              
| 필드 | |
|---|---|
commonInStreamAttribute | 
                
                   
 일반적인 광고 속성입니다.  | 
              
customParameters | 
                
                   
 추적 URL 템플릿에 맞춤 값을 전달하는 맞춤 매개변수입니다. 
  | 
              
CommonInStreamAttribute
인스트림 광고, 건너뛸 수 없는 광고, 범퍼 광고의 공통 속성입니다.
| JSON 표현 | 
|---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object (  | 
              
| 필드 | |
|---|---|
displayUrl | 
                
                   
 광고와 함께 표시되는 웹페이지 주소입니다.  | 
              
finalUrl | 
                
                   
 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.  | 
              
trackingUrl | 
                
                   
 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.  | 
              
actionButtonLabel | 
                
                   
 클릭 유도 문구 버튼의 텍스트입니다.  | 
              
actionHeadline | 
                
                   
 클릭 유도 문구 배너의 광고 제목입니다.  | 
              
video | 
                
                   
 광고의 YouTube 동영상입니다.  | 
              
companionBanner | 
                
                   
 동영상 광고 옆에 표시되는 이미지입니다.  | 
              
ImageAsset
이미지 확장 소재의 메타데이터입니다.
| JSON 표현 | 
|---|
{
  "mimeType": string,
  "fullSize": {
    object ( | 
              
| 필드 | |
|---|---|
mimeType | 
                
                   
 이미지 애셋의 MIME 유형입니다.  | 
              
fullSize | 
                
                   
 원래 크기의 이 이미지에 대한 메타데이터입니다.  | 
              
fileSize | 
                
                   
 이미지 애셋의 파일 크기(바이트)입니다.  | 
              
NonSkippableAd
건너뛸 수 없는 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{
  "commonInStreamAttribute": {
    object ( | 
              
| 필드 | |
|---|---|
commonInStreamAttribute | 
                
                   
 일반적인 광고 속성입니다.  | 
              
customParameters | 
                
                   
 추적 URL 템플릿에 맞춤 값을 전달하는 맞춤 매개변수입니다. 
  | 
              
BumperAd
범퍼 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{
  "commonInStreamAttribute": {
    object ( | 
              
| 필드 | |
|---|---|
commonInStreamAttribute | 
                
                   
 일반적인 광고 속성입니다.  | 
              
AudioAd
오디오 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object ( | 
              
| 필드 | |
|---|---|
displayUrl | 
                
                   
 광고와 함께 표시되는 웹페이지 주소입니다.  | 
              
finalUrl | 
                
                   
 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.  | 
              
trackingUrl | 
                
                   
 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.  | 
              
video | 
                
                   
 광고의 YouTube 동영상입니다.  | 
              
VideoDiscoveryAd
동영상 디스커버리 광고의 세부정보입니다.
| JSON 표현 | 
|---|
{ "headline": string, "description1": string, "description2": string, "video": { object (  | 
              
| 필드 | |
|---|---|
headline | 
                
                   
 광고의 제목입니다.  | 
              
description1 | 
                
                   
 광고의 첫 번째 텍스트 줄입니다.  | 
              
description2 | 
                
                   
 광고의 두 번째 텍스트 줄입니다.  | 
              
video | 
                
                   
 광고에서 홍보하는 YouTube 동영상입니다.  | 
              
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 (  | 
              
| 필드 | |
|---|---|
finalUrl | 
                
                   
 사용자가 광고를 클릭하면 연결되는 웹페이지의 URL 주소입니다.  | 
              
trackingUrl | 
                
                   
 추적 목적으로 백그라운드에서 로드되는 URL 주소입니다.  | 
              
actionButtonLabels[] | 
                
                   
 클릭 유도 문구 버튼에 표시되는 텍스트 애셋 목록입니다.  | 
              
headlines[] | 
                
                   
 클릭 유도문안 배너에 표시되는 광고 제목 목록입니다.  | 
              
longHeadlines[] | 
                
                   
 클릭 유도문안 배너에 표시되는 단독 광고 제목 목록입니다.  | 
              
descriptions[] | 
                
                   
 클릭 유도 문구 배너에 표시되는 설명 목록입니다.  | 
              
displayUrlBreadcrumb1 | 
                
                   
 표시 URL에서 도메인 뒤에 오는 첫 번째 부분입니다.  | 
              
displayUrlBreadcrumb2 | 
                
                   
 표시 URL에서 도메인 다음의 두 번째 부분입니다.  | 
              
domain | 
                
                   
 표시 URL의 도메인입니다.  | 
              
videos[] | 
                
                   
 이 광고에서 사용되는 YouTube 동영상 애셋 목록입니다.  | 
              
customParameters | 
                
                   
 추적 URL 템플릿에 맞춤 값을 전달하는 맞춤 매개변수입니다. 
  | 
              
companionBanners[] | 
                
                   
 이 광고에서 사용되는 컴패니언 배너 목록입니다.  | 
              
AdUrl
비콘을 포함하여 광고와 관련된 추가 URL입니다.
| JSON 표현 | 
|---|
{
  "type": enum ( | 
              
| 필드 | |
|---|---|
type | 
                
                   
 광고 URL의 유형입니다.  | 
              
url | 
                
                   
 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입니다. | 
메서드 | 
            |
|---|---|
                
 | 
              광고 그룹 광고를 가져옵니다. | 
                
 | 
              광고 그룹 광고를 나열합니다. |