Package google.ads.drx.video.v1

Indeks

VideoContentIngestionService

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

UpdateVideoContent

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:

{
   "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 mendapatkan informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ClosedCaptionFormat

Format file teks tertutup yang mungkin ada.

Enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED Format teks tertutup tidak ditentukan.
TTML application/ttaf+xml
WEB_VTT text/vtt

ClosedCaptionUrlInfo

Metadata untuk satu file teks tertutup.

Kolom
language_code

string

Kode bahasa IETF BCP-47 yang merepresentasikan bahasa yang digunakan dalam file teks tertutup.
closed_caption_format

ClosedCaptionFormat

Format file teks tertutup.
url

string

URL ke file teks tertutup.

DynamicAdInsertionInfo

Informasi terkait 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 kali diubah.
closed_caption_url_info[]

ClosedCaptionUrlInfo

URL ke file teks tertutup/subtitel.
fw_caid

string

ID aset kustom Freewheel yang digunakan untuk penargetan iklan.

GracenoteMetadata

Metadata Gracenote untuk konten.

Kolom
gracenote_id

string

Wajib. Mengacu pada 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 pada ID seri Gracenote. Harus diawali dengan 'SH'.

Metadata

Metadata kustom konten.

Kolom
key_values

map<string, Value>

Mengidentifikasi metadata kustom konten sebagai key-value pair. Hanya string atau daftar string yang diterima untuk nilai.

SyndicatedVideoContentNames

Daftar nama semua konten tersindikasi.

Kolom
syndicated_video_content[]

string

Kolom berulang dari nama konten tersindikasi. Formatnya harus "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" dan harus termasuk dalam jaringan yang sama dengan konten yang berisi kolom ini.

UpdateVideoContentRequest

Permintaan untuk [VideoContentIngestionService.UpdateVideoContentRequest][].

Kolom
video_content

VideoContent

Wajib. 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 memiliki konten ini.

content_source_id adalah ID sumber konten di Google Ad Manager yang menjadi tujuan 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 numerik atau alfanumerik.
status

VideoContentStatus

Status konten. Jika tidak disertakan, nilai defaultnya adalah aktif.
title

string

Wajib. Judul konten.
update_time

Timestamp

Wajib. Waktu terakhir konten diubah.
publish_time

Timestamp

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

Duration

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

Duration

Mengidentifikasi titik tanda. Titik tanda adalah penempatan waktu saat iklan disisipkan dalam 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 Gracenote dari konten.
syndication_metadata

VideoContentSyndicationInfo

Metadata terkait sindikasi konten.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Metadata terkait Penyisipan Iklan Dinamis dari konten.

VideoContentStatus

Opsi status untuk menayangkan atau tidak menayangkan iklan bertarget untuk konten.

Enum
ACTIVE Iklan yang ditargetkan ke Konten akan ditayangkan.
BLOCKED Tidak ada iklan yang akan ditayangkan pada konten ini jika statusnya adalah DIBLOKIR.
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 masih dapat ditayangkan di konten tersebut. Untuk memblokir iklan, tetapkan status ke DIBLOKIR.

VideoContentSyndicationInfo

Metadata untuk menentukan hubungan antara konten kanonis dan konten tersindikasi.

Kolom
Kolom union syndication. VideoContentSyndicationMetadata hanya dapat berisi salah satu dari berikut. syndication hanya dapat berupa salah satu dari berikut:
canonical_video_content

string

Nama konten kanonis. Formatnya harus "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" dan harus termasuk dalam jaringan yang sama dengan konten yang berisi kolom ini.
syndicated_video_content_names

SyndicatedVideoContentNames

Kumpulan konten bersindikasi

VideoFormat

Format yang digunakan untuk mengenkode konten video.

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

VideoIngestUrlInfo

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 sudah dipisah saat jeda iklan.
url

string

Link ke file m3u8.

VideoPreconditioned

Status dikondisikan dari konten video.

Enum
NO Belum dikondisikan.
YES Video telah dikondisikan/dibagi.