Package google.ads.dai.v1

Indeks

• PartnerDiscoveryService (antarmuka)
• CreateCreativeOperationMetadata (pesan)
• CreateCreativeRequest (pesan)
• Creative (pesan)
• DeleteCreativeRequest (pesan)
• DynamicCreativeInfo (pesan)
• FailureReason (pesan)
• FailureReason.Reason (enum)
• GetCreativeRequest (pesan)
• IngestionStatus (pesan)
• IngestionStatus.State (enum)
• MediaFile (pesan)
• MediaFile.Delivery (enum)

PartnerDiscoveryService

Mengelola proses transfer DAI dan upload materi iklan ke YouTube.

CreateCreative
rpc CreateCreative(CreateCreativeRequest) returns (Operation) Membuat Materi Iklan. Menampilkan Materi Iklan di kolom response jika berhasil diselesaikan, atau google.rpc.Code jika gagal. Menampilkan CreateCreativeOperationMetadata termasuk status penyerapan di kolom metadata.

DeleteCreative
rpc DeleteCreative(DeleteCreativeRequest) returns (Empty) Menghapus Materi Iklan.

GetCreative
rpc GetCreative(GetCreativeRequest) returns (Creative) Mendapatkan Materi Iklan.

CreateCreativeOperationMetadata

Metadata untuk operasi yang berjalan lama yang ditampilkan oleh CreateCreative. Dipresentasikan sebagai metadata.

Kolom
creative_url	string URL materi iklan yang digunakan untuk proses transfer. Ini adalah URL mezzanine atau URL rendering media yang dipilih, yang dipilih berdasarkan properti yang diberikan dalam permintaan.
gv_registry_id	string ID unik untuk materi iklan video, jika proses transfer berhasil. Nama resource Materi iklan adalah materi iklan/gv_registry_id.
create_time	Timestamp Waktu pembuatan permintaan transfer.
youtube_status	IngestionStatus Status transfer YouTube saat ini.

CreateCreativeRequest

Meminta PartnerDiscoveryService.CreateCreative.

Kolom
creative	Creative Materi iklan yang akan ditransfer.
dynamic_creative_info	DynamicCreativeInfo Informasi tentang materi iklan dinamis. Wajib diisi jika materi iklan yang akan ditransfer bersifat dinamis.

Materi iklan

Referensi materi iklan. Tampilkan sebagai response setelah menyelesaikan PartnerDiscoveryService.CreateCreative.

Kolom
name	string Hanya output. Nama unik (ID Video Google) dari resource Materi Iklan, dalam format creatives/id.
advertiser	string Nama pengiklan yang ditampilkan dalam materi iklan ini.
ad_system	string Wajib. Nama sistem iklan yang membuat permintaan transfer.
ad_title	string Judul iklan.
ad_description	string Deskripsi iklan.
mezzanines[]	MediaFile URL file mezzanine iklan dan propertinya. Setidaknya salah satu dari mezannines atau media_files harus ada.
media_files[]	MediaFile URL file media iklan dan propertinya. Setidaknya salah satu dari mezannines atau media_files harus ada.
network_code	string Opsional. Kode jaringan Google Ad Manager penayang yang menjadi tujuan materi iklan. Wajib diisi jika materi iklan bersifat dinamis dan memiliki DynamicCreativeInfo yang diisi di CreateCreativeRequest.

DeleteCreativeRequest

Meminta PartnerDiscoveryService.DeleteCreative.

Kolom
name	string ID Google Video materi iklan yang akan dihapus.

DynamicCreativeInfo

Informasi yang diperlukan agar materi iklan dinamis dapat melakukan pemrosesan VCL.

Kolom
dynamic_group_id	string ID yang mewakili iklan video inti materi iklan. Semua materi iklan dinamis dalam ID grup dinamis yang sama dapat dianggap memiliki konten yang sama, tetapi dengan aspek dinamis yang berbeda untuk materi iklan.
active_duration	Duration Durasi saat materi iklan ini dianggap aktif dan digunakan. Setelah waktu ini, materi iklan akan dijadwalkan untuk dihapus di repositori materi iklan video. Durasi akan dibatasi hingga 180 hari. Jika kolom ini tidak ditentukan, waktu durasi default 30 hari akan diterapkan.

FailureReason

Alasan kegagalan transfer materi iklan.

Kolom
reason	Reason Deskripsi kegagalan transfer materi iklan.
code	int32 Kode status kegagalan HTTP jika alasannya adalah DOWNLOAD_ERROR.

Alasan

Kemungkinan alasan kegagalan transfer materi iklan.

Enum
REASON_UNSPECIFIED	Nilai default.
DOWNLOAD_ERROR	Download HTTP gagal.
INTERNAL_ERROR	Error internal.
INVALID_MEDIA	Media tidak valid.

GetCreativeRequest

Meminta PartnerDiscoveryService.GetCreative.

Kolom
name	string ID Video Google materi iklan.

IngestionStatus

Status transfer permintaan Buat Materi Iklan.

Kolom
state	State Status transfer materi iklan video saat ini.
failure_reason	FailureReason Alasan materi iklan gagal diserap, jika penyerapan gagal.
update_time	Timestamp Waktu tugas transfer terakhir diperbarui.

Negara Bagian

Status penyerapan.

Enum
STATE_UNSPECIFIED	Nilai default.
PROCESSING	Materi iklan video masih diproses.
SUCCESS	Pemrosesan materi iklan video berhasil diselesaikan.
FAILURE	Materi iklan video gagal diserap, lihat FailureReason.

MediaFile

Properti yang terkait dengan file media tertentu.

Kolom
uri	string Wajib. URL unik ke file media materi iklan.
delivery	Delivery Wajib. Jenis penayangan materi iklan.
height	int32 Tinggi native file video, dalam piksel.
width	int32 Lebar native file video, dalam piksel.
mime_type	string Wajib. Jenis MIME untuk penampung file. Jenis MIME populer mencakup “video/x-flv” untuk Flash Video dan “video/mp4” untuk MP4.
min_bitrate	int32 Kecepatan bit minimum file media. Untuk video pemuatan progresif, nilai ini harus berupa kecepatan bit rata-rata.
max_bitrate	int32 Kecepatan bit maksimum file media. Untuk video pemuatan progresif, nilai ini harus berupa kecepatan bit rata-rata.

Pengiriman

Jenis penayangan.

Enum
DELIVERY_UNSPECIFIED	Nilai pengiriman default.
DELIVERY_PROGRESSIVE	Pengiriman video progresif.
DELIVERY_STREAMING	Pengiriman video streaming.