Agar kode aplikasi dapat menggunakan Video Intelligence API, Anda harus menyiapkan kredensial yang tepat agar aplikasi dapat mengautentikasi identitasnya ke layanan dan mendapatkan otorisasi untuk menjalankan tugas. (Mekanisme terkait kredensial ini dikenal sebagai skema auth.)
Autentikasi dan otorisasi Google Cloud API (umumnya dikelompokkan sebagai "auth") biasanya dilakukan menggunakan akun layanan. Akun layanan memungkinkan kode Anda mengirim kredensial aplikasi langsung ke Video Intelligence API. Akun layanan, seperti akun pengguna, diwakili oleh alamat email. Tidak seperti akun pengguna, akun layanan hanya dikaitkan dengan aplikasi.
Mengaktifkan API
Sebelum dapat melakukan autentikasi, Anda harus mengaktifkan Video Intelligence API terlebih dahulu.
- 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.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Enable the Cloud Video Intelligence API.
-
Buat akun layanan:
-
Di konsol Google Cloud, buka halaman Buat akun layanan.
Buka Create service account - Pilih project Anda.
-
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. - Klik Buat dan lanjutkan.
-
Klik Selesai untuk menyelesaikan pembuatan akun layanan.
Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.
-
-
Membuat kunci akun layanan:
- Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
- Klik Kunci.
- Klik Tambahkan kunci, lalu klik Buat kunci baru.
- Klik Create. File kunci JSON akan didownload ke komputer Anda.
- Klik Close.
-
Tetapkan variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALSke 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. - Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Enable the Cloud Video Intelligence API.
-
Buat akun layanan:
-
Di konsol Google Cloud, buka halaman Buat akun layanan.
Buka Create service account - Pilih project Anda.
-
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. - Klik Buat dan lanjutkan.
-
Klik Selesai untuk menyelesaikan pembuatan akun layanan.
Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.
-
-
Membuat kunci akun layanan:
- Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
- Klik Kunci.
- Klik Tambahkan kunci, lalu klik Buat kunci baru.
- Klik Create. File kunci JSON akan didownload ke komputer Anda.
- Klik Close.
-
Tetapkan variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALSke 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. - Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
Membuat akun layanan di konsol Google Cloud
Untuk membuat akun layanan menggunakan Google Cloud Console, lakukan hal berikut:
Dari halaman Credentials Google Cloud Console, pilih Create credentials > Service account key.
Selanjutnya, di bagian Akun layanan, pilih Akun layanan baru.
Di kotak Nama akun layanan, masukkan nama untuk akun layanan Anda. Nama ini digunakan sebagai nama default untuk ID akun layanan (di sebelah kiri "@" pada alamat ID akun layanan yang dihasilkan), tetapi Anda dapat mengubah nama ID akun layanan ini. Nama-nama ini bersifat arbitrer; Anda hanya perlu mengingatnya.
Di bagian Key type, pilih JSON untuk sebagian besar project baru.
Klik Create.
Konsol Google Cloud kemudian membuat kunci JSON (sebagai file teks .json), meminta Anda untuk mendownload file ke komputer, dan menampilkan kotak dialog Service account created.
Kunci JSON yang dibuat akan serupa dengan contoh kunci JSON berikut:
{
"type": "service_account",
"project_id": "PROJECT_ID",
"private_key_id": "SOME_NUMBER",
"private_key": "-----BEGIN PRIVATE KEY-----\nPRIVATE_KEY\n-----END PRIVATE KEY-----\n",
"client_email": "SERVICE_ACCOUNT_EMAIL",
"client_id": "...",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://accounts.google.com/o/oauth2/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/SERVICE_ACCOUNT_EMAIL"
}
Simpan file JSON ini dengan aman, karena berisi kunci pribadi Anda (dan file ini adalah satu-satunya salinan kunci tersebut). Anda harus melihat file kunci akun layanan ini dalam kode Anda saat mengirim permintaan anotasi ke Video Intelligence API.
Mengautentikasi dengan Kredensial Default Aplikasi
Cara termudah bagi aplikasi untuk mengautentikasi ke Video Intelligence API
adalah dengan
menggunakan
Kredensial Default Aplikasi (ADC).
Layanan yang menggunakan ADC akan menelusuri kredensial terlebih dahulu dalam
variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS. Kecuali jika Anda secara khusus memerlukan ADC untuk menggunakan kredensial lain (misalnya, kredensial pengguna), Anda harus menetapkan variabel lingkungan ini agar mengarah ke file kunci akun layanan (file .json yang didownload saat membuat kunci akun layanan.
$ export GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_SERVICE_ACCOUNT_FILE