Dengan menggunakan Video Stitcher API, Anda membuat sesi live setiap kali memulai pemutaran live stream yang iklannya ditayangkan oleh Google Ad Manager digabungkan secara dinamis selama jeda iklan. Respons menentukan URL pemutaran dan konfigurasi sesi live.
Dokumen ini menjelaskan cara membuat dan mengelola sesi live. Untuk detail selengkapnya, lihat dokumentasi REST.
Sebelum memulai
- Buat konfigurasi live. Untuk integrasi dengan Google Ad Manager, pastikan objek
gamLiveConfig
ditetapkan. - Jika Anda menentukan slate, pastikan objek
gamSlate
ditetapkan di slate yang Anda daftarkan.
Membuat sesi live
Untuk membuat sesi live menggunakan API secara langsung, gunakan
metode projects.locations.liveSessions.create
.
Kolom liveConfig
adalah satu-satunya kolom yang wajib diisi dalam isi JSON. Anda dapat menetapkan
atau mengganti parameter opsional berikut per sesi live (seperti yang ditunjukkan dalam
contoh REST berikut):
manifestOptions
: menentukan render video yang dibuat dalam manifes video yang digabungkan dan urutan render; lihat dokumentasi opsi manifesadTracking
: pilih pelacakan iklan sisi klien atau pelacakan iklan sisi server; tindakan ini akan mengganti nilai dalam konfigurasi live untuk sesitargetingParameters
: tag iklan Google Ad Manager dapat berisi parameter penargetan yang dapat diperbarui per sesi; berikan pemetaan di kolom ini (misalnya, untuk mengganti makro[my_key]
dengan stringmy_value
, lihat contoh REST)
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_NUMBER
: nomor project Google Cloud Anda yang terletak di kolom Project number di halaman IAM SettingsLOCATION
: lokasi tempat membuat sesi; gunakan salah satu region yang didukungMenampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
LIVE_CONFIG_ID
: ID yang ditentukan pengguna untuk konfigurasi aktif
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Video Stitcher API menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Video Stitcher API.
Untuk melakukan autentikasi ke Video Stitcher API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Video Stitcher API menghasilkan ID sesi unik untuk setiap permintaan. Sesi akan berakhir jika playUri
tidak diminta dalam 5 menit terakhir.
Anda dapat menggunakan STREAM_ID
yang ditampilkan untuk
memeriksa sesi live.
Memeriksa sesi live yang diaktifkan oleh Google Ad Manager
Untuk melihat detail tag iklan untuk sesi, gunakan
Pemantauan aktivitas streaming di Ad Manager untuk
melihat detail tentang permintaan iklan. Anda dapat menggunakan STREAM_ID
untuk men-debug sesi streaming. Untuk menemukan STREAM_ID
untuk sesi live, lihat Mendapatkan sesi.