REST Resource: advertisers.adGroupAds

Resource: AdGroupAd

Satu iklan yang dikaitkan dengan grup iklan.

Representasi 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.
}
Kolom
name

string

Nama resource iklan.
advertiserId

string (int64 format)

ID unik pengiklan yang memiliki iklan tersebut.
adGroupAdId

string (int64 format)

ID unik iklan. Ditetapkan oleh sistem.
adGroupId

string (int64 format)

ID unik grup iklan yang berisi iklan.

.
displayName

string

Nama tampilan iklan.

Harus berenkode UTF-8 dengan ukuran maksimum 255 byte.
adPolicy

object (AdPolicy)

Status persetujuan kebijakan iklan.
entityStatus

enum (EntityStatus)

Status entitas iklan.
adUrls[]

object (AdUrl)

Daftar URL yang digunakan oleh iklan.

Kolom union ad_details. Detail iklan.

ad_details hanya dapat berupa salah satu dari hal berikut:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Detail iklan yang bersumber dari materi iklan Display & Video 360.
mastheadAd

object (MastheadAd)

Detail iklan yang ditayangkan di feed Beranda YouTube.
inStreamAd

object (InStreamAd)

Detail iklan in-stream yang dapat dilewati setelah 5 detik, digunakan untuk tujuan pemasaran brand awareness atau jangkauan.
nonSkippableAd

object (NonSkippableAd)

Detail iklan video in-stream pendek yang tidak dapat dilewati, antara 6 dan 15 detik, yang digunakan untuk tujuan pemasaran jangkauan.
bumperAd

object (BumperAd)

Detail iklan video pendek yang tidak dapat dilewati, berdurasi 6 detik atau kurang, yang digunakan untuk jangkauan.
audioAd

object (AudioAd)

Detail iklan audio yang digunakan untuk tujuan pemasaran jangkauan.
videoDiscoverAd

object (VideoDiscoveryAd)

Detail iklan yang mempromosikan video yang ditampilkan di tempat penemuan.
videoPerformanceAd

object (VideoPerformanceAd)

Detail iklan yang digunakan dalam kampanye tindakan video untuk mendorong tindakan terkait bisnis, layanan, atau produk.

AdPolicy

Kebijakan satu iklan yang terkait dengan iklan grup iklan.

Representasi JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Kolom
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Status persetujuan kebijakan iklan, yang menunjukkan keputusan persetujuan.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Status peninjauan kebijakan iklan, yang menunjukkan posisi iklan saat ini dalam proses peninjauan.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Entri untuk setiap topik kebijakan yang diidentifikasi terkait dengan iklan. Setiap entri mencakup topik, tingkat pembatasan, dan panduan tentang cara memperbaiki masalah kebijakan.

AdPolicyApprovalStatus

Kemungkinan status persetujuan kebijakan iklan.

Enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN Tidak diketahui atau tidak ditentukan.
DISAPPROVED Tidak akan ditayangkan.
APPROVED_LIMITED Akan ditayangkan dengan batasan.
APPROVED Akan ditayangkan tanpa batasan.
AREA_OF_INTEREST_ONLY Tidak akan ditayangkan di negara target, tetapi dapat ditayangkan untuk pengguna yang menelusuri informasi tentang negara target.

AdPolicyReviewStatus

Kemungkinan status peninjauan kebijakan iklan.

Enum
AD_POLICY_REVIEW_STATUS_UNKNOWN Tidak diketahui atau tidak ditentukan.
REVIEW_IN_PROGRESS Saat ini sedang dalam peninjauan.
REVIEWED Peninjauan utama selesai. Peninjauan lainnya mungkin masih dalam proses.
UNDER_APPEAL Dikirim ulang untuk mendapatkan persetujuan atau keputusan kebijakan telah diajukan banding.
ELIGIBLE_MAY_SERVE Dianggap memenuhi syarat dan mungkin ditayangkan. Peninjauan lebih lanjut masih dapat dilakukan.

AdPolicyTopicEntry

Entri yang menjelaskan bagaimana iklan telah diidentifikasi terkait dengan kebijakan iklan.

Representasi 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)
  }
}
Kolom
policyTopic

string

Topik kebijakan.

Contohnya mencakup "MEREK DAGANG", "ALKOHOL", dll.
policyLabel

string

Teks label yang dilokalkan untuk kebijakan.

Contohnya mencakup "Merek dagang dalam teks", "Berisi Alkohol", dll.
policyTopicDescription

string

Deskripsi ringkasan singkat tentang topik kebijakan.
policyTopicType

enum (AdPolicyTopicEntryType)

Cara penayangan iklan akan terpengaruh karena terkait dengan topik kebijakan iklan.
policyDecisionType

enum (AdPolicyDecisionType)

Sumber keputusan kebijakan.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Penegakan kebijakan yang digunakan dalam peninjauan kebijakan.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Bukti yang digunakan dalam keputusan kebijakan.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Batasan penayangan yang relevan dengan keputusan kebijakan.
appealInfo

object (AdPolicyTopicAppealInfo)

Informasi tentang cara mengajukan banding atas keputusan kebijakan.

AdPolicyTopicEntryType

Kemungkinan dampak penayangan dari topik kebijakan iklan.

Enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Tidak diketahui atau tidak ditentukan.
PROHIBITED Resource tidak akan ditayangkan.
FULLY_LIMITED Aset tidak akan ditayangkan di semua negara target.
LIMITED Sumber daya tidak dapat ditayangkan di beberapa negara.
DESCRIPTIVE Resource dapat ditayangkan.
BROADENING Resource dapat ditayangkan, dan mungkin ditayangkan di luar cakupan normal.
AREA_OF_INTEREST_ONLY Resource dibatasi untuk semua negara target, tetapi dapat ditayangkan untuk pengguna yang menelusuri informasi tentang negara target.

AdPolicyDecisionType

Kemungkinan sumber keputusan kebijakan.

Enum
AD_POLICY_DECISION_TYPE_UNKNOWN Tidak diketahui atau tidak ditentukan.
PURSUANT_TO_NOTICE Keputusan ini berasal dari pemberitahuan hukum, perintah pengadilan, atau keluhan pemilik konten merek dagang, dll.
GOOGLE_INVESTIGATION Keputusan ini berasal dari investigasi yang dilakukan Google.

AdPolicyEnforcementMeans

Kemungkinan cara penegakan kebijakan yang digunakan dalam peninjauan kebijakan.

Enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Tidak diketahui atau tidak ditentukan.
AUTOMATED Proses penegakan kebijakan sepenuhnya otomatis.
HUMAN_REVIEW Manusia terlibat sebagian atau sepenuhnya dalam proses penegakan keputusan.

AdPolicyTopicEvidence

Informasi bukti yang digunakan dalam keputusan kebijakan.

Representasi 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.
}
Kolom
Kolom union value. Bukti untuk keputusan kebijakan. value hanya dapat berupa salah satu dari berikut:
textList

object (TextList)

Daftar bukti yang ditemukan dalam teks iklan.
websiteList

object (WebsiteList)

Daftar situs yang ditautkan dengan iklan.
httpCode

integer

Kode HTTP yang ditampilkan saat URL final di-crawl.
languageCode

string

Bahasa yang terdeteksi digunakan untuk menulis iklan.

Kolom ini menggunakan tag bahasa IETF, seperti "en-US".
destinationTextList

object (DestinationTextList)

Teks di tujuan iklan yang menyebabkan pelanggaran kebijakan.
destinationMismatch

object (DestinationMismatch)

URL tujuan iklan tidak cocok.
destinationNotWorking

object (DestinationNotWorking)

Informasi tentang error HTTP atau DNS yang terkait dengan tujuan iklan.
trademark

object (Trademark)

Istilah merek dagang yang menyebabkan pelanggaran kebijakan.
legalRemoval

object (LegalRemoval)

Penegakan peraturan terkait hukum yang menyebabkan pelanggaran kebijakan.
counterfeit

object (Counterfeit)

Penegakan produk palsu yang menyebabkan pelanggaran kebijakan.
regionalRequirements

object (RegionalRequirements)

Penegakan proaktif T&S yang menyebabkan pelanggaran kebijakan.

TextList

Daftar fragmen teks yang melanggar kebijakan.

Representasi JSON 
{
  "texts": [
    string
  ]
}
Kolom
texts[]

string

Fragmen teks dari resource yang menyebabkan temuan kebijakan.

WebsiteList

Daftar situs yang melanggar kebijakan.

Representasi JSON 
{
  "websites": [
    string
  ]
}
Kolom
websites[]

string

Situs yang menyebabkan temuan kebijakan.

DestinationTextList

Daftar teks tujuan yang melanggar kebijakan.

Representasi JSON 
{
  "destinationTexts": [
    string
  ]
}
Kolom
destinationTexts[]

string

Teks tujuan yang menyebabkan temuan kebijakan.

DestinationMismatch

Detail tentang ketidakcocokan antara jenis URL tujuan.

Representasi JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Kolom
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Kumpulan URL yang tidak cocok. Daftar dapat menyertakan satu atau beberapa jenis URI.

Contoh 1: [DISPLAY_URL, FINAL_URL] berarti URL yang ditampilkan iklan tidak cocok dengan URL final iklan.

Contoh 2: [FINAL_URL] berarti URL final iklan tidak cocok dengan URL yang di-crawl, yang juga dianggap sebagai ketidakcocokan tujuan.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Kemungkinan jenis URL.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Tidak ditentukan atau tidak diketahui.
DISPLAY_URL URL yang ditampilkan.
FINAL_URL URL final.
FINAL_MOBILE_URL URL seluler final.
TRACKING_URL URL pelacakan.
MOBILE_TRACKING_URL URL pelacakan seluler.

DestinationNotWorking

Detail tentang error HTTP atau DNS yang terkait dengan tujuan iklan.

Representasi 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.
}
Kolom
expandedUri

string

URL lengkap yang tidak berfungsi.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Perangkat yang mengalami error saat membuka URL.
lastCheckedTime

string (Timestamp format)

Terakhir kali error terlihat saat membuka URL.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
Kolom union reason. Error HTTP atau DNS. reason hanya dapat berupa salah satu dari berikut:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Jenis error DNS.
httpErrorCode

string (int64 format)

Kode error HTTP.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Kemungkinan jenis error DNS.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Tidak ditentukan atau tidak diketahui.
HOSTNAME_NOT_FOUND Nama host tidak ditemukan di DNS saat mengambil halaman landing.
GOOGLE_CRAWLER_DNS_ISSUE Google tidak dapat meng-crawl halaman landing saat berkomunikasi dengan DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Kemungkinan perangkat yang melihat error saat mengunjungi URL.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Tidak ditentukan atau tidak diketahui.
DESKTOP Perangkat desktop.
ANDROID Perangkat Android.
IOS Perangkat iOS.

Merek Dagang

Istilah merek dagang yang menyebabkan pelanggaran kebijakan.

Representasi JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Kolom
owner

string

Pemilik konten merek dagang.
term

string

Istilah merek dagang.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Negara tempat pelanggaran kebijakan relevan.

AdPolicyCriterionRestriction

Merepresentasikan pembatasan negara.

Representasi JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Kolom
countryCriterionId

string (int64 format)

ID kriteria negara.
countryLabel

string

Nama negara yang dilokalkan. Mungkin kosong.

LegalRemoval

Penegakan peraturan terkait hukum, baik dari DMCA maupun peraturan hukum setempat.

Representasi 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.
}
Kolom
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Jenis keluhan yang menyebabkan penghapusan karena alasan hukum.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Negara yang dibatasi karena penghapusan karena alasan hukum.
restrictedUris[]

string

URL dibatasi karena penghapusan karena alasan hukum.
Kolom union type. Detail tentang jenis penghapusan karena alasan hukum. type hanya dapat berupa salah satu dari berikut:
dmca

object (Dmca)

Detail tentang penghapusan karena alasan hukum berdasarkan peraturan DMCA.

Dmca

Detail keluhan DMCA.

Representasi JSON 
{
  "complainant": string
}
Kolom
complainant

string

Entitas yang membuat keluhan hukum.

LocalLegal

Detail peraturan hukum setempat.

Representasi JSON 
{
  "lawType": string
}
Kolom
lawType

string

Jenis hukum untuk pemberitahuan hukum.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Kemungkinan jenis keluhan untuk penghapusan karena alasan hukum.

Enum
COPYRIGHT

Hak cipta.

Hanya berlaku untuk DMCA.
COURT_ORDER

Perintah pengadilan.

Hanya berlaku untuk hukum setempat.

Pemalsuan

Detail tentang penegakan produk palsu yang menyebabkan pelanggaran kebijakan.

Representasi JSON 
{
  "owners": [
    string
  ]
}
Kolom
owners[]

string

Pemilik konten atau produk yang mengajukan keluhan.

RegionalRequirements

Penegakan proaktif Trust & Safety (T&S) untuk kebijakan yang dimaksudkan untuk memenuhi persyaratan regional. Hal ini dianggap sebagai penyelidikan yang dilakukan oleh Google, bukan pemberitahuan peraturan karena merupakan penegakan T&S yang proaktif.

Representasi JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Kolom
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Daftar persyaratan regional.

RegionalRequirementsEntry

Detail pelanggaran hukum regional tingkat kebijakan.

Representasi JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Kolom
legalPolicy

string

Kebijakan hukum yang dilanggar.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Negara yang dibatasi karena kebijakan hukum.

AdPolicyTopicConstraint

Detail tentang batasan penayangan iklan.

Representasi 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.
}
Kolom
Kolom union constraint. Batasan penayangan. constraint hanya dapat berupa salah satu dari berikut:
countryConstraint

object (AdPolicyCountryConstraintList)

Negara tempat iklan tidak dapat ditayangkan.
resellerConstraint

object (AdPolicyResellerConstraint)

Batasan reseller.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Negara tempat sertifikat diperlukan untuk penayangan.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Negara tempat domain resource tidak tercakup oleh sertifikat yang terkait dengannya.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Sertifikat diperlukan untuk menayangkan iklan di negara mana pun.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Sertifikat diperlukan untuk menayangkan iklan di negara mana pun dan sertifikat yang ada tidak mencakup domain iklan.

AdPolicyCountryConstraintList

Daftar negara tempat iklan tidak dapat ditayangkan karena batasan kebijakan.

Representasi JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Kolom
countries[]

object (AdPolicyCriterionRestriction)

Negara tempat iklan tidak dapat ditayangkan.

AdPolicyResellerConstraint

Jenis ini tidak memiliki kolom.

Topik kebijakan dibatasi karena penolakan situs untuk tujuan reseller.

AdPolicyGlobalCertificateMissingConstraint

Jenis ini tidak memiliki kolom.

Sertifikat diperlukan untuk menayangkan iklan di negara mana pun.

AdPolicyGlobalCertificateDomainMismatchConstraint

Jenis ini tidak memiliki kolom.

Sertifikat diperlukan untuk menayangkan iklan di negara mana pun dan sertifikat yang ada tidak mencakup domain iklan.

AdPolicyTopicAppealInfo

Informasi tentang cara mengajukan banding atas keputusan kebijakan.

Representasi JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Kolom
appealType

enum (AdPolicyAppealType)

Apakah keputusan tersebut dapat diajukan banding melalui banding layanan mandiri atau formulir permohonan banding.

AdPolicyAppealType

Kemungkinan jenis banding.

Enum
AD_POLICY_APPEAL_TYPE_UNKNOWN Tidak diketahui atau tidak ditentukan.
SELF_SERVICE_APPEAL Keputusan tersebut dapat diajukan banding melalui banding layanan mandiri.
APPEAL_FORM Keputusan tersebut dapat diajukan banding menggunakan formulir permohonan banding.

DisplayVideoSourceAd

Iklan yang bersumber dari materi iklan DV360.

Representasi JSON 
{
  "creativeId": string
}
Kolom
creativeId

string (int64 format)

ID materi iklan sumber.

MastheadAd

Detail untuk Iklan Masthead.

Representasi 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)
    }
  ]
}
Kolom
video

object (YoutubeVideoDetails)

Video YouTube yang digunakan oleh iklan.
headline

string

Judul iklan.
description

string

Deskripsi iklan.
videoAspectRatio

enum (VideoAspectRatio)

Rasio aspek video YouTube yang diputar otomatis di Masthead.
autoplayVideoStartMillisecond

string (int64 format)

Jumlah waktu dalam milidetik setelah video akan mulai diputar.
autoplayVideoDuration

string (Duration format)

Durasi waktu video akan diputar otomatis.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
callToActionButtonLabel

string

Teks pada tombol pesan ajakan (CTA).
callToActionFinalUrl

string

URL tujuan untuk tombol pesan ajakan (CTA).
callToActionTrackingUrl

string

URL pelacakan untuk tombol pesan ajakan (CTA).
showChannelArt

boolean

Apakah akan menampilkan latar belakang atau banner yang muncul di bagian atas halaman YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Video yang muncul di samping Iklan Masthead di desktop. Tidak boleh lebih dari dua.

YoutubeVideoDetails

Detail video YouTube.

Representasi JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Kolom
id

string

ID video YouTube yang dapat ditelusuri di halaman web YouTube.
unavailableReason

enum (VideoUnavailableReason)

Alasan data video tidak tersedia.

VideoUnavailableReason

Kemungkinan alasan mengapa video tidak tersedia.

Enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Tidak diketahui atau tidak ditentukan.
VIDEO_UNAVAILABLE_REASON_PRIVATE Video disetel ke pribadi.
VIDEO_UNAVAILABLE_REASON_DELETED Video dihapus.

VideoAspectRatio

Kemungkinan rasio aspek untuk video YouTube.

Enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
VIDEO_ASPECT_RATIO_WIDESCREEN Video direntangkan dan bagian atas serta bawah dipangkas.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video menggunakan rasio aspek 16:9 tetap.

InStreamAd

Detail untuk iklan in-stream.

Representasi JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Kolom
commonInStreamAttribute

object (CommonInStreamAttribute)

Atribut iklan umum.
customParameters

map (key: string, value: string)

Parameter kustom untuk meneruskan nilai kustom ke template URL pelacakan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Atribut umum untuk iklan in-stream, yang tidak dapat dilewati, dan bumper.

Representasi JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Kolom
displayUrl

string

Alamat halaman web yang muncul bersama iklan.
finalUrl

string

Alamat URL halaman web yang dituju orang setelah mengklik iklan.
trackingUrl

string

Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
actionButtonLabel

string

Teks pada tombol pesan ajakan (CTA).
actionHeadline

string

Judul banner pesan ajakan (CTA).
video

object (YoutubeVideoDetails)

Video YouTube iklan.
companionBanner

object (ImageAsset)

Gambar yang ditampilkan di samping iklan video.

ImageAsset

Metadata aset gambar.

Representasi JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Kolom
mimeType

string

Jenis MIME aset gambar.
fullSize

object (Dimensions)

Metadata untuk gambar ini dalam ukuran aslinya.
fileSize

string (int64 format)

Ukuran file aset gambar dalam byte.

NonSkippableAd

Detail untuk iklan yang tidak dapat dilewati.

Representasi JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Kolom
commonInStreamAttribute

object (CommonInStreamAttribute)

Atribut iklan umum.
customParameters

map (key: string, value: string)

Parameter kustom untuk meneruskan nilai kustom ke template URL pelacakan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Detail untuk iklan bumper.

Representasi JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Kolom
commonInStreamAttribute

object (CommonInStreamAttribute)

Atribut iklan umum.

AudioAd

Detail untuk iklan audio.

Representasi JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Kolom
displayUrl

string

Alamat halaman web yang muncul bersama iklan.
finalUrl

string

Alamat URL halaman web yang dituju orang setelah mengklik iklan.
trackingUrl

string

Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
video

object (YoutubeVideoDetails)

Video YouTube iklan.

VideoDiscoveryAd

Detail untuk iklan video discovery.

Representasi JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Kolom
headline

string

Judul iklan.
description1

string

Baris teks pertama untuk iklan.
description2

string

Baris teks kedua untuk iklan.
video

object (YoutubeVideoDetails)

Video YouTube yang dipromosikan iklan.
thumbnail

enum (Thumbnail)

Gambar thumbnail yang digunakan dalam iklan.

Thumbnail

Kemungkinan opsi thumbnail di Iklan Video Discovery.

Enum
THUMBNAIL_UNSPECIFIED Tidak diketahui atau tidak ditentukan.
THUMBNAIL_DEFAULT Thumbnail default dapat dibuat secara otomatis atau diupload oleh pengguna.
THUMBNAIL_1 Thumbnail 1, dibuat dari video.
THUMBNAIL_2 Thumbnail 2, dibuat dari video.
THUMBNAIL_3 Thumbnail 3, dibuat dari video.

VideoPerformanceAd

Detail untuk iklan performa video.

Representasi 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)
    }
  ]
}
Kolom
finalUrl

string

Alamat URL halaman web yang dituju orang setelah mengklik iklan.
trackingUrl

string

Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
actionButtonLabels[]

string

Daftar aset teks yang ditampilkan di tombol pesan ajakan (CTA).
headlines[]

string

Daftar judul yang ditampilkan di banner pesan ajakan (CTA).
longHeadlines[]

string

Daftar judul tunggal yang ditampilkan di banner pesan ajakan (CTA).
descriptions[]

string

Daftar deskripsi yang ditampilkan di banner pesan ajakan (CTA).
displayUrlBreadcrumb1

string

Bagian pertama setelah domain di URL yang ditampilkan.
displayUrlBreadcrumb2

string

Bagian kedua setelah domain di URL yang ditampilkan.
domain

string

Domain URL yang ditampilkan.
videos[]

object (YoutubeVideoDetails)

Daftar aset video YouTube yang digunakan oleh iklan ini.
customParameters

map (key: string, value: string)

Parameter kustom untuk meneruskan nilai kustom ke template URL pelacakan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

Daftar banner pengiring yang digunakan oleh iklan ini.

AdUrl

URL tambahan yang terkait dengan iklan, termasuk beacon.

Representasi JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
Kolom
type

enum (AdUrlType)

Jenis URL Iklan.
url

string

Nilai string URL.

AdUrlType

Kemungkinan jenis URL iklan.

Enum
AD_URL_TYPE_UNSPECIFIED Tidak diketahui atau tidak ditentukan.
AD_URL_TYPE_BEACON_IMPRESSION Piksel pelacakan 1x1 untuk mengirim ping saat tayangan iklan materi iklan ditayangkan.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Beacon tayangan iklan DCM yang dapat diperluas. Pada waktu penayangan, kode ini diperluas menjadi beberapa suar.
AD_URL_TYPE_BEACON_CLICK URL pelacakan untuk melakukan ping saat peristiwa klik dipicu.
AD_URL_TYPE_BEACON_SKIP URL pelacakan untuk melakukan ping saat peristiwa lewati dipicu.

Metode

get

 Mendapatkan iklan grup iklan.

list

 Mencantumkan iklan grup iklan.