Package google.ads.drx.video.v1

Indeks

Layanan NotifikasiJeda

Layanan API yang memungkinkan penayang membuat Jeda Iklan dalam live stream.

CreateAdBreak

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

API untuk membuat Jeda Iklan dalam live stream.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Membuat DaftarJeda Iklan

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

API untuk mencantumkan Jeda Iklan dalam live stream.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

LayananPenyerapanKonten Video

Layanan API untuk penyerapan konten yang memungkinkan pembuatan atau pembaruan konten video dan metadata terkaitnya di Google Ad Manager.

PerbaruiKontenVideo

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API untuk membuat konten baru atau memperbarui metadatanya jika konten sudah ada di Ad Manager. Menampilkan konten jika berhasil atau google.rpc.Code jika gagal.

Contoh permintaan terlihat seperti ini:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Jeda Iklan

Metadata jeda iklan yang digunakan untuk menentukan keputusan jeda iklan dalam peristiwa video live.

Kolom
name

string

Hanya output. Nama resource Jeda Iklan. Kolom ini akan memiliki format "networks//assets//adBreaks/".

network_code adalah kode jaringan di Google Ad Manager yang mencakup konten ini.

asset_key adalah kunci Peristiwa Live Stream di Kelola Iklan Google tempat Jeda Iklan telah dibuat.

ad_break_id adalah kunci Jeda Iklan. HANYA OUTPUT.
expected_duration

Duration

Wajib diisi. Durasi jeda yang diharapkan.
custom_params

string

Pasangan nilai kunci yang akan disertakan dalam permintaan iklan untuk jeda ini bagi penargetan kriteria khusus di Ad Manager. Contoh: 'key1=value&key2=value2,value22'
scte_35_cue_out

string

Data yang dienkode base 64 dari isyarat scte35 akan dikeluarkan. Dapat menyertakan perintah splice_insert() atau time_signal(). Contoh: - dengan time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - dengan splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAN
pod_template_name

string

Nama template pod Google Ad Manager.
break_state

BreakState

Status Jeda Iklan saat ini.

Kerusakan

Status Jeda Iklan.

Enumerasi
BREAK_STATE_UNSPECIFIED Status Jeda Iklan tidak diketahui.
BREAK_STATE_DECISIONED Pengambilan keputusan Jeda Iklan dimulai, tetapi belum ditayangkan kepada pengguna.
BREAK_STATE_COMPLETE Jeda Iklan ditayangkan kepada pengguna.

FormatTeks

Format file teks tertutup yang digunakan.

Enumerasi
CLOSED_CAPTION_FORMAT_UNSPECIFIED Format subtitel tidak ditentukan.
TTML application/ttaf+xml
WEB_VTT teks/vtt

InfoTeksTertutup

Metadata untuk satu file teks tertutup.

Kolom
language_code

string

Kode bahasa IETF BCP-47 yang mewakili bahasa yang digunakan untuk file teks tertutup.
closed_caption_format

ClosedCaptionFormat

Format file teks tertutup.
url

string

URL ke file teks tertutup.

CreateAdBreakRequest

Meminta AdBreakNotificationService.CreateAdBreak.

Kolom
parent

string

Kolom ini mengidentifikasi LiveStreamEvent yang harus dikaitkan ke jeda iklan ini menggunakan kunci aset live stream. Harus memiliki format "networks/{network_code}/assets/{asset_code}"
custom_parent

string

Kolom ini mengidentifikasi LiveStreamEvent yang harus dikaitkan dengan jeda iklan ini menggunakan kunci aset kustom. Harus memiliki format "networks/{network_code}/customAssets/{asset_code}"
content

string

Ini adalah cara alternatif untuk mengidentifikasi LiveStreamEvent jika dikaitkan dengan konten dalam GAM. Harus memiliki format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
ad_break

AdBreak

Wajib diisi. Jeda iklan sebenarnya.
ad_break_id

string

Ini adalah ad_break_id yang dapat diberikan pengguna melalui permintaan.

InfoPenyisipanIklan Dinamis

Informasi yang berkaitan dengan Penyisipan Iklan Dinamis.

Kolom
video_ingest_url_info

VideoIngestUrlInfo

Link ke file m3u8 master yang digunakan untuk pengondisian dan pembuatan playlist.
media_update_time

Timestamp

Waktu file video yang dirujuk di video_ingest_url_info terakhir diubah.
closed_caption_url_info[]

ClosedCaptionUrlInfo

URL ke file subtitel.
fw_caid

string

ID aset kustom Freewheel yang digunakan untuk penargetan iklan.

GracenoteMetadata

Metadata Gracenote untuk konten.

Kolom
gracenote_id

string

Wajib diisi. Merujuk ke ID Gracenote untuk konten. Harus memiliki salah satu awalan yang valid berikut: 1. 'EP' - episode dari serial 2. 'MV' - film 3. 'SP' - acara olahraga
gracenote_series_id

string

Opsional. Kolom ini merujuk ke ID seri Gracenote. Harus diawali dengan 'SH'.

PermintaanDaftarIklan

Meminta AdBreakNotificationService.ListAdBreaks.

Kolom
parent

string

Opsional. Kolom ini mengidentifikasi LiveStreamEvent yang harus dikaitkan ke jeda iklan ini menggunakan kunci aset live stream. Harus memiliki format "networks/{network_code}/assets/{asset_code}"
custom_parent

string

Opsional. Kolom ini mengidentifikasi LiveStreamEvent yang harus dikaitkan dengan jeda iklan ini menggunakan kunci aset kustom. Harus memiliki format "networks/{network_code}/customAssets/{asset_code}"
content

string

Opsional. Ini adalah cara alternatif untuk mengidentifikasi LiveStreamEvent jika dikaitkan dengan konten dalam GAM. Harus memiliki format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"
page_size

int32

Opsional. Jumlah maksimum jeda iklan yang akan ditampilkan. Layanan dapat menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 10 jeda iklan akan ditampilkan. Nilai maksimum adalah 100; nilai di atas 100 akan dikonversi menjadi 100.
page_token

string

Opsional. Token halaman, diterima dari panggilan ListAdBreaks sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat penomoran halaman, semua parameter lain yang diberikan ke ListAdBreaks harus cocok dengan panggilan yang memberikan token halaman.

ResponsDaftarIklan

Respons untuk AdBreakNotificationService.ListAdBreaks.

Kolom
ad_breaks[]

AdBreak

Hanya output. Daftar Jeda Iklan yang cocok dengan LiveStreamEvent yang diminta.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

Metadata

Metadata kustom konten.

Kolom
key_values

map<string, Value>

Mengidentifikasi metadata kustom konten sebagai pasangan nilai kunci. Hanya string atau daftar string yang diterima untuk nilai.

NamaKontenVideo Bersindikasi

Daftar nama semua konten bersindikasi.

Kolom
syndicated_video_content[]

string

Kolom berulang untuk nama konten bersindikasi. File tersebut harus memiliki format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" dan harus berasal dari jaringan yang sama dengan konten yang berisi kolom ini.

UpdateVideoContentRequest

Permintaan untuk [VideoContentPenyerapanService.UpdateVideoContentRequest][].

Kolom
video_content

VideoContent

Wajib diisi. Metadata konten.

Konten Video

Metadata konten.

Kolom
name

string

Hanya output. Nama resource konten video. Kolom ini memiliki format: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code adalah kode jaringan di Google Ad Manager yang mencakup konten ini.

content_source_id adalah ID sumber konten di Google Ad Manager yang seharusnya digunakan untuk konten ini.

cms_content_id adalah ID konten CMS di Google Ad Manager, yang dibentuk sebagai bagian permintaan iklan untuk mengidentifikasi iklan mana yang dapat ditayangkan oleh Ad Manager pada video yang sesuai. Nilai ini dapat berupa angka atau alfanumerik.
status

VideoContentStatus

Status konten. Jika ini dihilangkan, nilai default akan aktif.
title

string

Wajib diisi. Judul konten.
update_time

Timestamp

Wajib diisi. Waktu perubahan terakhir pada konten.
publish_time

Timestamp

Waktu publikasi konten. Kolom ini wajib diisi, jika video dirancang untuk disertakan dalam Aturan Iklan yang menentukan waktu mulai dan berakhir.
duration

Duration

Durasi konten. Durasi didukung hingga ke tingkat milidetik.
cue_points[]

Duration

Mengidentifikasi titik tanda. Titik tanda adalah titik tempat iklan dapat disisipkan di video. Titik tanda didukung hingga tingkat milidetik. Kolom ini wajib diisi, jika video berisi jeda iklan mid-roll.
thumbnail_url

string

URL thumbnail konten.
metadata

Metadata

Mengidentifikasi metadata kustom konten.
gracenote_metadata

GracenoteMetadata

Metadata terkait konten masa tenggang.
syndication_metadata

VideoContentSyndicationInfo

Metadata terkait sindikasi konten.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Metadata terkait Penyisipan Iklan Dinamis konten.

StatusKontenVideo

Opsi status untuk menayangkan atau tidak menayangkan iklan yang ditargetkan untuk konten.

Enumerasi
ACTIVE Iklan bertarget konten akan ditayangkan.
BLOCKED Tidak akan ada iklan yang ditayangkan pada konten ini jika statusnya BLOCKED.
DELETED Konten akan diarsipkan di Ad Manager. Jika Ad Manager menerima permintaan iklan untuk konten yang ditandai sebagai DIHAPUS, iklan internal, atau iklan yang ditargetkan ke unit inventaris atau kriteria penargetan lainnya tetap dapat ditayangkan pada konten tersebut. Untuk memblokir iklan, tetapkan status ke BLOCKED.

InfoKontenSindikasiVideo

Metadata untuk menentukan hubungan antara konten kanonis dan konten bersindikasi.

Kolom
Kolom union syndication. VideoContentSyndiationMetadata hanya boleh berisi salah satu dari hal berikut. syndication hanya dapat berupa salah satu dari berikut:
canonical_video_content

string

Nama konten kanonis. File harus memiliki format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" dan harus berasal dari jaringan yang sama dengan konten yang berisi kolom ini.
syndicated_video_content_names

SyndicatedVideoContentNames

Kumpulan konten bersindikasi

Format Video

Format tempat konten video dapat dienkode.

Enumerasi
VIDEO_FORMAT_UNSPECIFIED Format video tidak ditentukan.
HLS application/x-mpegURL
DASH application/dash+xml

InfoIngestUrlInfo

Metadata yang menentukan link ke file m3u8 yang digunakan untuk pengondisian dan pembuatan playlist.

Kolom
video_format

VideoFormat

Format video.
video_preconditioned

VideoPreconditioned

Untuk menunjukkan apakah konten sudah dikondisikan untuk iklan mid-roll atau tidak, artinya segmen Anda telah dipisah saat jeda iklan.
url

string

Link ke file m3u8.

Prasyarat Video

Status konten video yang dikondisikan.

Enumerasi
NO Belum dikondisikan.
YES Video telah dikondisikan/disambungkan.