Menyiapkan aplikasi klien Anda untuk bekerja dengan Google Ad Manager

Mengumpulkan informasi yang diperlukan untuk aplikasi klien Anda

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

KolomDeskripsi
projectNumberNomor project Google Cloud (PROJECT_NUMBER) yang digunakan untuk membuat sesi yang mengaktifkan Ad Manager; atau, Anda dapat menggunakan project ID.
region Lokasi (LOCATION) tempat konfigurasi aktif didaftarkan.
liveConfigIdID konfigurasi live yang digunakan untuk mendaftarkan peristiwa live stream ke 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). Perhatikan bahwa lokasi konfigurasi harus berada di lokasi yang sama dengan tempat Anda membuat sesi.
customAssetKeyKunci aset kustom (CUSTOM_ASSET_KEY) yang dibuat selama pendaftaran konfigurasi live; IMA SDK memerlukan nilai ini untuk membuat streaming.
networkCodeID numerik (NETWORK_CODE) untuk jaringan Ad Manager Anda.
oAuthTokenToken OAuth berumur pendek untuk akun layanan dengan peran Video Stitcher User. Lihat Membuat token OAuth dengan jangka waktu singkat.

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

Membuat token OAuth berjangka pendek untuk pengujian

Untuk membuat token OAuth jangka pendek 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 Anda download ke komputer lokal.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. Ambil token pembawa OAuth 2.0 dari akun layanan:
    gcloud auth print-access-token

Karena ini adalah token berumur pendek, Anda perlu membuatnya lagi secara berkala dengan perintah gcloud auth print-access-token dan mengirim token baru ke aplikasi klien. Lihat bagian berikut untuk informasi selengkapnya tentang cara mem-build layanan produksi untuk menyediakan token jangka pendek.

Membuat layanan untuk memberikan informasi ke aplikasi klien Anda

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

Secara khusus, layanan harus dapat menyediakan token OAuth ke aplikasi klien dengan aman. Konfigurasikan layanan ini menggunakan dua akun layanan, satu akun meniru akun lainnya. 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 identitas akun layanan 2 ke aplikasi klien.
  • Akun layanan 2: Ini adalah akun layanan yang memiliki hak istimewa dan memiliki peran Pengguna Video Stitcher untuk membuat sesi.

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