Sebelum memulai

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

Menyiapkan project Google Cloud

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

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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. Make sure that billing is enabled for your Google Cloud project.

4. Aktifkan API Video Stitcher and Live Stream.

   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 berikut ke akun layanan: Video Stitcher Admin, Live Stream Editor, Storage Admin.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih peran.

      Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.

      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. Make sure that billing is enabled for your Google Cloud project.

10. Aktifkan API Video Stitcher and Live Stream.

    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 berikut ke akun layanan: Video Stitcher Admin, Live Stream Editor, Storage Admin.

       Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih peran.

       Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.

       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. Install the Google Cloud CLI.

15. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.
16. Gunakan alat gcloud untuk menguji lingkungan autentikasi Anda. Pastikan perintah berikut menghasilkan string teks tanpa error:

    gcloud auth application-default print-access-token

Mengaktifkan 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 download 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.

Menautkan akun layanan ke akun Ad Manager

Setelah akun layanan dibuat, Anda harus menautkan akun layanan tersebut ke akun Ad Manager Anda. Hal ini memungkinkan Video Stitcher API membuat peristiwa live stream untuk 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. Isi formulir, termasuk alamat email akun layanan yang dibuat sebelumnya.
6. Pilih peran, yang harus menyertakan izin Mengelola konten video dengan penyisipan iklan dinamis dari Penggabung Video Google Cloud. Anda harus membuat peran khusus bernama Pengelola Live Stream khusus untuk pengelolaan akun layanan ini. Peran khusus harus memiliki setidaknya izin berikut:
   • Mengelola konten video dengan penyisipan iklan dinamis dari Video Stitcher Google Cloud
   • Melihat materi iklan (diperlukan oleh izin sebelumnya)
   • Melihat konten, paket, dan metadata video
   • Melihat sumber konten
7. Klik Simpan dan konfirmasi penambahan akun layanan.

Buat akun layanan dengan izin saja untuk membuat sesi

Karena token OAuth akan diteruskan ke aplikasi klien, buat akun layanan terpisah dengan hanya izin untuk membuat sesi. Dengan demikian, token OAuth yang bocor tidak dapat membahayakan resource Anda, seperti kunci CDN dan peristiwa live stream.

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 berikut ke akun layanan: Video Stitcher User.

   Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih peran.

   Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.

   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.