Sebelum memulai

Halaman ini menunjukkan cara menyiapkan project Google Cloud dan mengonfigurasi layanan untuk mengakses project.

Menyiapkan project Google Cloud

Dengan mengikuti langkah-langkah ini untuk menyiapkan project Google Cloud.

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan Video Stitcher API.

   Mengaktifkan API

5. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

   3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

   4. Klik Buat dan lanjutkan.

   5. Berikan peran Video Stitcher Admin ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Video Stitcher Admin.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

      Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

6. Membuat kunci akun layanan:

   1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
   2. Klik Kunci.
   3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
   4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
   5. Klik Close.

7. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan variabel kembali.

   Contoh: Linux atau macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

   Contoh:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Contoh: Windows

   Untuk PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

   Contoh:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Untuk command prompt:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

8. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

9. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

10. Aktifkan Video Stitcher API.

    Mengaktifkan API

11. Buat akun layanan:

    1. Di konsol Google Cloud, buka halaman Buat akun layanan.

       Buka Create service account
    2. Pilih project Anda.

    3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

       Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

    4. Klik Buat dan lanjutkan.

    5. Berikan peran Video Stitcher Admin ke akun layanan.

       Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Video Stitcher Admin.

       Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
    6. Klik Lanjutkan.

    7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

       Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

12. Membuat kunci akun layanan:

    1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
    2. Klik Kunci.
    3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
    4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
    5. Klik Close.

13. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan variabel kembali.

    Contoh: Linux atau macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

    Contoh:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Contoh: Windows

    Untuk PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

    Contoh:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Untuk command prompt:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Ganti KEY_PATH dengan jalur file JSON yang berisi kredensial Anda.

14. Menginstal Google Cloud CLI.

15. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init

    Catatan: Anda dapat menjalankan gcloud CLI di konsol Google Cloud tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol Google Cloud, gunakan Cloud Shell.
16. Gunakan gcloud CLI untuk menguji lingkungan autentikasi Anda. Pastikan perintah berikut menghasilkan output string teks tanpa error:

    gcloud auth application-default print-access-token

Aktifkan akun layanan

1. Di terminal Anda, tetapkan project aktif untuk perintah gcloud. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

2. Aktifkan akun layanan. Ganti PATH_TO_YOUR_SERVICE_KEY dengan jalur ke file JSON yang Anda unduh ke komputer lokal Anda.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY

Anda akan menggunakan akun layanan ini untuk mengizinkan akses dan memanggil Video Stitcher API.

Membuat akun layanan dengan izin hanya untuk membuat sesi

Karena token OAuth akan diteruskan ke aplikasi klien, buat akun layanan terpisah dengan hanya izin untuk membuat sesi; Jadi, token OAuth yang bocor tidak dapat membahayakan resource Anda, seperti konfigurasi VOD/live atau kunci CDN.

Buat akun layanan:

1. Di konsol Google Cloud, buka halaman Buat akun layanan.

   Buka Create service account
2. Pilih project Anda.

3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

   Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

4. Klik Buat dan lanjutkan.

5. Berikan peran Video Stitcher User ke akun layanan.

   Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Video Stitcher User.

   Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
6. Klik Lanjutkan.

7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

   Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

Membuat kunci akun layanan:

1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
2. Klik Kunci.
3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
5. Klik Close.

Penyiapan livestream

Jika Anda menyisipkan iklan ke live stream, ikuti langkah-langkah di bagian ini (atau lihat langkah-langkah untuk VOD).

Menautkan akun layanan ke akun Ad Manager

Setelah akun layanan dibuat, Anda harus menautkan akun layanan tersebut ke akun Ad Manager. Hal ini memungkinkan Video Stitcher API untuk membuat acara live stream atas nama Anda. Untuk melakukannya, ikuti langkah-langkah untuk memberikan akses ke akun layanan Anda:

1. Login ke Google Ad Manager (GAM).
2. Klik Admin > Setelan Global.
3. Pastikan akses API diaktifkan.
4. Klik Add a service account user.
5. Lengkapi formulir, termasuk alamat email akun layanan yang dibuat sebelumnya.
6. Pilih peran, yang harus menyertakan opsi Kelola konten video dengan iklan dinamis penyisipan dari Google Cloud Video Stitcher. Anda seharusnya membuat peran khusus bernama Pengelola Live Stream khusus untuk pengelolaan layanan ini menggunakan akun layanan. Peran khusus harus memiliki setidaknya izin berikut:
   • Mengelola konten video dengan penyisipan iklan dinamis dari Google Cloud Video Stitcher
   • Melihat materi iklan (diperlukan oleh izin sebelumnya)
   • Melihat konten video, paket, dan metadata
   • Melihat sumber konten
7. Klik Save dan konfirmasi penambahan akun layanan.

Buat livestream

Anda dapat menggunakan salah satu Panduan memulai Live Stream API untuk menyiapkan livestream. Livestream HLS dan MPEG-DASH didukung (lihat persyaratan manifes sumber). Prosedur ini bersifat opsional; Anda dapat menggunakan {i>livestream <i} yang sudah Anda miliki.

Panduan memulai Live Stream API menggunakan Kredensial Default Aplikasi untuk autentikasi, tetapi Anda dapat menggunakan akun layanan yang sudah disiapkan. Sebagai opsi ini, pastikan akun layanan memiliki peran Editor Live Stream.

Pastikan livestream tetap aktif; tidak mengikuti langkah-langkah di Kosongkan sampai livestream selesai.

Persyaratan manifes sumber

Video Stitcher API mendaftarkan konfigurasi ke Ad Manager dengan menguraikan manifes sumber. Manifes sumber harus memiliki karakteristik tertentu tergantung pada format.

HLS

• Format penampung dapat berupa:
  • MPEG-TS gabungan
  • MPEG-TS yang tidak digabungkan
  • FMP4 yang tidak digabungkan
• Setidaknya satu rendisi dalam manifes dengan berikut ini (dengan benar telah diisi):
  • codec
  • {i>bandwidth<i}

MPEG-DASH

• MPD@type ditetapkan ke dinamis (@type="dynamic")
• MPD@profiles menyertakan profil Live ISO urn:mpeg:dash:profile:isoff-live:2011
• Harus beberapa periode dengan setiap periode berisi satu atau beberapa periode Adaptasi Set
• Setiap Kumpulan Adaptasi berisi satu atau beberapa Pernyataan
• Representasi berisi atau mewarisi SegmentTemplate dengan elemen $Number$ atau ID $Time$
• @segmentAlignment ditetapkan ke benar (true) untuk semua Kumpulan Adaptasi
• Pernyataan tidak boleh kosong

Penyiapan streaming VOD

Jika Anda menyisipkan iklan ke streaming VOD, ikuti langkah-langkah di bagian ini (atau lihat langkah-langkah untuk melakukan livestream).

Membuat file sumber VOD

Alur kerja ini memerlukan file manifes MPEG-DASH (MPD), atau HTTP Live File manifes streaming (HLS) (M3U8), dan file segmen terkait. Anda dapat gunakan file VOD yang sudah ada atau Anda dapat membuat file sumber VOD menggunakan Transcoder API.