Mempersiapkan aplikasi klien Anda agar berfungsi dengan Google Ad Manager

Mengumpulkan informasi yang diperlukan untuk permohonan klien Anda

Anda harus memiliki informasi berikut yang diperlukan Google Ad Manager untuk membuat sesi live stream:

KolomDeskripsi
projectNumberNomor project Google Cloud yang digunakan untuk membuat sesi yang mengaktifkan Ad Manager; atau, Anda dapat menggunakan project ID.
region Region tempat konfigurasi live didaftarkan.
liveConfigIdID konfigurasi live yang digunakan untuk mendaftarkan peristiwa live stream dengan Video Stitcher API. Berikut ini menunjukkan format untuk nama resource konfigurasi lengkap:

projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
ID konfigurasi adalah bagian terakhir dari nama lengkap (LIVE_CONFIG_ID). Perlu diingat bahwa lokasi konfigurasi harus berada di lokasi yang sama dengan tempat Anda membuat sesi.
customAssetKeyKunci aset kustom yang dibuat selama pendaftaran konfigurasi live; IMA SDK memerlukan nilai ini untuk membuat streaming.
networkCodeID numerik untuk jaringan Ad Manager Anda.
OAuth tokenToken OAuth berumur singkat untuk akun layanan dengan peran Video Stitcher User. Lihat Membuat token OAuth yang berumur pendek.

Tabel 1. Informasi yang diperlukan untuk sesi live stream yang mengaktifkan Ad Manager

Membuat token OAuth yang memiliki masa aktif singkat untuk pengujian

Untuk membuat token OAuth berumur singkat yang terkait dengan akun layanan dengan peran Video Stitcher User, ikuti langkah-langkah berikut:

  1. Ganti PATH_TO_YOUR_SERVICE_KEY dengan jalur ke file JSON yang telah Anda download ke komputer lokal.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
    
  2. Ambil token pemilik OAuth 2.0 dari akun layanan:
    gcloud auth print-access-token
    

Karena ini adalah token berumur singkat, Anda harus membuatnya lagi secara berkala dengan perintah gcloud auth print-access-token dan mengirim token baru ke aplikasi klien Anda. Lihat bagian berikut untuk mengetahui informasi selengkapnya tentang cara mem-build layanan produksi untuk menyediakan token yang memiliki masa aktif singkat.

Membuat layanan untuk memberikan informasi ke aplikasi klien Anda

Buat layanan yang dapat memberikan informasi yang diperlukan untuk diteruskan ke klien. Jika aplikasi meminta informasi dari layanan Anda mengenai cara memutar live stream, layanan harus menampilkan informasi yang dijelaskan dalam Tabel 1.

Secara khusus, layanan tersebut harus dapat menyediakan token OAuth untuk aplikasi klien dengan cara yang aman. Konfigurasi layanan ini menggunakan dua akun layanan, salah satunya meniru identitas yang lain. Satu akun layanan memiliki peran Service Token Creator dan membuat token OAuth untuk akun layanan yang memiliki peran Video Stitcher User. Misalnya:

  • Akun layanan 1: Ini adalah akun layanan pemanggil. Akun ini memiliki izin Service Token Creator di akun layanan 2 dan meniru akun layanan 2 untuk aplikasi klien.
  • Akun layanan 2: Ini adalah akun layanan yang memiliki hak istimewa yang memiliki peran Pengguna Penggabung Video untuk membuat sesi.

Untuk mengetahui informasi tentang cara menyediakan token OAuth dari layanan Anda, termasuk contoh kode library klien, lihat Membuat token akses berumur pendek.