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)
    }
  ],
  "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.
}
Kolom
name

string

Hanya output. Nama resource iklan.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki iklan tersebut.
adGroupAdId

string (int64 format)

Hanya output. ID unik iklan. Ditetapkan oleh sistem.
adGroupId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik grup iklan yang berisi iklan tersebut.
displayName

string

Wajib. Nama tampilan iklan.

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

object (AdPolicy)

Hanya output. Status persetujuan kebijakan iklan.
entityStatus

enum (EntityStatus)

Wajib. Status entitas iklan.
adUrls[]

object (AdUrl)

Hanya output. Daftar URL yang digunakan oleh iklan.
dcmTrackingInfo

object (DcmTrackingInfo)

Opsional. Info iklan pelacakan DCM. Hanya valid untuk iklan Peningkat Permintaan.

Untuk menghapus info iklan pelacakan DCM, kosongkan kolom ini.
Kolom union ad_details. Detail iklan. ad_details hanya dapat berupa salah satu dari berikut:
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

Hanya output. Detail iklan yang ditayangkan di feed Beranda YouTube.
inStreamAd

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

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

object (AudioAd)

Hanya output. Detail iklan audio yang digunakan untuk tujuan pemasaran jangkauan.
videoDiscoverAd

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

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

object (DemandGenVideoAd)

Detail iklan video Peningkat Permintaan.
demandGenImageAd

object (DemandGenImageAd)

Detail iklan gambar Peningkat Permintaan.
demandGenProductAd

object (DemandGenProductAd)

Detail iklan produk Peningkat Permintaan.

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 Mengirim ulang untuk mendapatkan persetujuan atau mengajukan banding atas keputusan kebijakan.
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)

Sarana 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 yang 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 situs ditolak 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 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),
  "videoAssetId": string
}
Kolom
id

string

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

enum (VideoUnavailableReason)

Alasan data video tidak tersedia.
videoAssetId

string (int64 format)

Wajib. ID aset video YouTube. Ini adalah adAssetId dari resource AdAsset.

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 diregangkan dan bagian atas serta bawah dipangkas.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video menggunakan rasio aspek 16:9 tetap.

InStreamAd

Detail untuk iklan dalam stream.

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

object (CommonInStreamAttribute)

Atribut iklan umum.
customParameters

map (key: string, value: string)

Parameter kustom dan nilai yang menyertainya untuk ditambahkan ke 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 dibuka 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,
  "assetId": string
}
Kolom
mimeType

string

Hanya output. Jenis MIME aset gambar.
fullSize

object (Dimensions)

Hanya output. Metadata untuk gambar ini dalam ukuran aslinya.
fileSize

string (int64 format)

Hanya output. Ukuran file aset gambar dalam byte.
assetId

string (int64 format)

Wajib. ID unik aset.

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 dan nilai yang menyertainya untuk ditambahkan ke 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 dibuka 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 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 dibuka 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 panjang 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 dan nilai yang menyertainya untuk ditambahkan ke URL pelacakan.

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

object (ImageAsset)

Daftar banner pendamping yang digunakan oleh iklan ini.

DemandGenVideoAd

Detail untuk iklan video Peningkat Permintaan.

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

string

Wajib. Alamat URL halaman web yang dibuka orang setelah mengklik iklan.
trackingUrl

string

Hanya output. Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
userSpecifiedTrackingUrl

string

Opsional. URL pelacakan yang ditentukan oleh pengguna secara manual.
callToAction

enum (CallToAction)

Wajib. Tombol pesan ajakan (CTA) yang ditampilkan di iklan.

Nilai yang didukung adalah:

  • 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

Wajib. Daftar judul yang ditampilkan di iklan.
longHeadlines[]

string

Wajib. Daftar judul panjang yang ditampilkan di iklan.
descriptions[]

string

Wajib. Daftar deskripsi yang ditampilkan di iklan.
displayUrlBreadcrumb1

string

Opsional. Bagian pertama setelah domain di URL yang ditampilkan.
displayUrlBreadcrumb2

string

Opsional. Bagian kedua setelah domain di URL yang ditampilkan.
videos[]

object (YoutubeVideoDetails)

Wajib. Daftar aset video YouTube yang digunakan oleh iklan ini.
customParameters

map (key: string, value: string)

Opsional. Parameter kustom dan nilai yang menyertainya untuk ditambahkan ke URL pelacakan.

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

object (ImageAsset)

Opsional. Banner pendamping yang digunakan oleh iklan ini.
finalMobileUrl

string

Opsional. Alamat URL halaman web yang dibuka orang setelah mengklik iklan di perangkat seluler.
finalUrlSuffix

string

Opsional. Sufiks yang akan ditambahkan ke URL halaman landing.
businessName

string

Wajib. Nama bisnis yang ditampilkan di iklan.

CallToAction

Kemungkinan nilai pesan ajakan (CTA) untuk iklan Produk/Video Peningkat Permintaan.

Enum
CALL_TO_ACTION_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
AUTOMATED Otomatis.
LEARN_MORE Pelajari lebih lanjut.
GET_QUOTE Dapatkan penawaran harga.
APPLY_NOW Ajukan permohonan sekarang.
SIGN_UP Daftar.
CONTACT_US Hubungi kami.
SUBSCRIBE Berlangganan.
DOWNLOAD Download.
BOOK_NOW Pesan sekarang.
SHOP_NOW Beli sekarang.
BUY_NOW Beli sekarang.
DONATE_NOW Beri donasi sekarang.
ORDER_NOW Pesan sekarang.
PLAY_NOW Mainkan sekarang.
SEE_MORE Lihat lainnya.
START_NOW Mulai sekarang.
VISIT_SITE Buka situs.
WATCH_NOW Tonton sekarang.

DemandGenImageAd

Detail untuk iklan gambar Peningkat Permintaan.

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

string

Wajib. Alamat URL halaman web yang dibuka orang setelah mengklik iklan.
trackingUrl

string

Hanya output. Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
userSpecifiedTrackingUrl

string

Opsional. URL pelacakan yang ditentukan oleh pengguna secara manual.
callToAction

string

Wajib. Tombol pesan ajakan (CTA) yang ditampilkan di iklan.
headlines[]

string

Wajib. Daftar judul yang ditampilkan di iklan.
descriptions[]

string

Wajib. Daftar deskripsi yang ditampilkan di iklan.
customParameters

map (key: string, value: string)

Opsional. Parameter kustom dan nilai yang menyertainya untuk ditambahkan ke URL pelacakan.

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

string

Opsional. Alamat URL halaman web yang dibuka orang setelah mengklik iklan di perangkat seluler.
finalUrlSuffix

string

Opsional. Sufiks yang akan ditambahkan ke URL halaman landing.
businessName

string

Wajib. Nama bisnis yang ditampilkan di iklan.
marketingImages[]

object (ImageAsset)

Daftar gambar pemasaran yang ditampilkan di iklan.
squareMarketingImages[]

object (ImageAsset)

Daftar gambar pemasaran persegi yang ditampilkan di iklan.
portraitMarketingImages[]

object (ImageAsset)

Daftar gambar pemasaran potret yang ditampilkan di iklan.
logoImages[]

object (ImageAsset)

Daftar gambar logo yang ditampilkan di iklan.

DemandGenCarouselAd

Detail untuk iklan carousel Peningkat Permintaan.

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

string

Wajib. Alamat URL halaman web yang dibuka orang setelah mengklik iklan.
headline

string

Wajib. Judul iklan.
description

string

Wajib. Deskripsi iklan.
cards[]

object (CarouselCard)

Wajib. Daftar kartu yang ditampilkan di iklan.
finalUrlSuffix

string

Opsional. Sufiks yang akan ditambahkan ke URL halaman landing.
trackingUrl

string

Hanya output. Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
userSpecifiedTrackingUrl

string

Opsional. URL pelacakan yang ditentukan oleh pengguna secara manual.
businessName

string

Wajib. Nama bisnis yang ditampilkan di iklan.
customParameters

map (key: string, value: string)

Opsional. Parameter kustom dan nilai yang menyertainya untuk ditambahkan ke URL pelacakan.

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

CarouselCard

Detail untuk kartu carousel Peningkat Permintaan.

Representasi JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Kolom
finalUrl

string

Wajib. Alamat URL halaman web yang dibuka orang setelah mengklik kartu.
finalMobileUrl

string

Opsional. Alamat URL halaman web yang dibuka orang setelah mengklik kartu di perangkat seluler.
headline

string

Wajib. Judul kartu.
callToAction

string

Wajib. Teks pada tombol pesan ajakan (CTA) yang ditampilkan di kartu.

Harus menggunakan 10 karakter atau kurang.
marketingImage

object (ImageAsset)

Opsional. Gambar pemasaran yang ditampilkan di kartu.
squareMarketingImage

object (ImageAsset)

Opsional. Gambar pemasaran persegi yang ditampilkan di kartu.
portraitMarketingImage

object (ImageAsset)

Opsional. Gambar pemasaran potret yang ditampilkan di kartu.

DemandGenProductAd

Detail untuk iklan produk Peningkat Permintaan.

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

string

Wajib. Alamat URL halaman web yang dibuka orang setelah mengklik iklan.
headline

string

Wajib. Judul iklan.
description

string

Wajib. Deskripsi iklan.
finalUrlSuffix

string

Opsional. Sufiks yang akan ditambahkan ke URL halaman landing.
callToAction

enum (CallToAction)

Wajib. Tombol pesan ajakan (CTA) yang ditampilkan di iklan.

Nilai yang didukung adalah:

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

string

Hanya output. Alamat URL dimuat di latar belakang untuk tujuan pelacakan.
userSpecifiedTrackingUrl

string

Opsional. URL pelacakan yang ditentukan oleh pengguna secara manual.
businessName

string

Wajib. Nama bisnis yang ditampilkan di iklan.
customParameters

map (key: string, value: string)

Opsional. Parameter kustom dan nilai yang menyertainya untuk ditambahkan ke URL pelacakan.

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

string

Opsional. Bagian pertama setelah domain di URL yang ditampilkan.
displayUrlBreadcrumb2

string

Opsional. Bagian kedua setelah domain di URL yang ditampilkan.

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 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 beacon.
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.

DcmTrackingInfo

Detail tentang pelacakan DCM.

Representasi JSON 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Kolom
placementId

string (int64 format)

Wajib. ID penempatan DCM.
trackingAdId

string (int64 format)

Wajib. ID iklan pelacakan DCM.
creativeId

string (int64 format)

Wajib. ID materi iklan DCM.

Metode

create

 Membuat iklan grup iklan.

delete

 Menghapus iklan grup iklan.

get

 Mendapatkan iklan grup iklan.

list

 Mencantumkan iklan grup iklan.

patch

 Memperbarui iklan grup iklan.