Sebelum Memulai (v4beta1)

Ringkasan

Sebelum dapat mulai menggunakan Cloud Talent Solution (CTS), Anda harus mengaktifkan API di Google Cloud Platform (GCP) Console. Langkah-langkah di bawah ini akan memandu Anda melakukan tindakan berikut:

  • Aktifkan CTS pada project GCP.
    1. Pastikan penagihan diaktifkan untuk CTS.
    2. Setujui Persyaratan & Ketentuan Pencatatan Data.
    3. Buat dan/atau tetapkan satu atau beberapa akun layanan ke Cloud Talent Solution.
    4. Download kunci kredensial akun layanan.
  • Tetapkan variabel lingkungan autentikasi Anda.

Penyiapan GCP Console

  1. Buka GCP Console. Buka menu drop-down di bagian atas halaman dan pilih project GCP yang ingin Anda kaitkan dengan Cloud Talent Solution. Jika sebelumnya Anda telah membuat satu atau beberapa project, project tersebut akan muncul dalam daftar di menu pop-up. Anda dapat memilih project yang sudah ada (tanda centang akan muncul di samping project yang dipilih) atau membuat project baru dengan mengklik NEW PROJECT. Untuk mengetahui detail lebih lanjut tentang cara membuat project GCP, lihat dokumentasi.

  2. Jika membuat project baru, Anda akan diminta untuk menautkan akun penagihan ke project ini. Jika menggunakan project yang sudah ada, pastikan Anda telah mengaktifkan penagihan. Anda dapat mengakses informasi penagihan project kapan saja dengan membuka menu navigasi utama (ikon tiga garis di sudut kiri atas) dan mengklik opsi Billing:

  3. Setelah memilih project GCP dan menautkannya ke akun penagihan, Anda dapat mengaktifkan Cloud Talent Solution API. Buka menu navigasi utama dan scroll ke bawah ke bagian Kecerdasan Buatan. Klik Talent Solution dan pilih Overview dari menu yang muncul:

  4. Jika ingin mencoba API terlebih dahulu tanpa menautkannya ke project, Anda dapat memilih opsi TRY THIS API. Lihat dokumentasi Job Search API Explorer untuk mengetahui informasi selengkapnya tentang cara menggunakan fitur ini. Agar dapat mengaktifkan Cloud Talent Solution API untuk digunakan dengan project GCP Anda, klik AKTIFKAN:

  5. Halaman logging data akan muncul. Anda harus menyetujui persyaratan & ketentuan untuk mendapatkan akses penuh ke fitur CTS. Jika memilih untuk tidak menyetujui persyaratan ini, Anda hanya dapat menggunakan permintaan API penghapusan. Klik AKTIFKAN:

  6. Sekarang Anda akan diminta untuk menautkan satu atau beberapa akun layanan ke CTS API. Jika Anda menggunakan project yang sudah memiliki akun layanan yang terkait, akun tersebut akan muncul dalam daftar di halaman ini. Klik HUBUNGKAN di samping akun yang ingin ditautkan ke CTS API. Setelah melakukannya, Anda dapat langsung ke langkah 8 untuk memastikan bahwa Anda telah mendownload kredensial JSON atau P12 untuk akun tersebut.

    Jika project Anda belum memiliki akun layanan, Anda akan diminta untuk membuatnya. Ketik nama pilihan Anda di kotak Service account name. Input Anda akan otomatis diisi di kotak Service account ID. Kotak Service account description bersifat opsional, tetapi direkomendasikan jika Anda berencana mengaitkan beberapa akun layanan dengan project Anda. Masukkan deskripsi singkat akun layanan ke dalam kotak ini, lalu klik BUAT.

  7. Halaman berikutnya memungkinkan Anda menetapkan peran ke akun layanan baru. Lihat halaman izin IAM CTS untuk mengetahui detail selengkapnya tentang peran yang tersedia dan izin yang diizinkan untuk setiap peran. Klik menu drop-down Select a role dan scroll ke bawah ke Cloud Talent Solution. Anda dapat memilih peran untuk akun layanan ini dari opsi di kolom sebelah kanan:

  8. Halaman berikutnya memberi Anda opsi untuk menyelesaikan beberapa tugas. Tindakan ini tidak wajib, tetapi sangat direkomendasikan. Anda dapat memberikan akses ke akun layanan yang baru saja dibuat kepada setiap pengguna dengan memasukkan alamat email mereka. Anda juga dapat membuat kunci pribadi untuk akun layanan. Anda harus menggunakan kunci pribadi selama proses autentikasi saat menggunakan API. Jika memilih untuk tidak melakukan tindakan ini sekarang, Anda dapat membuat kunci dan menambahkan/mengubah setiap informasi pengguna kapan saja dengan mengakses akun layanan melalui opsi IAM di menu navigasi utama.

    Klik BUAT KUNCI:

    Pilih format yang diinginkan dari menu pop-up dan klik BUAT:

    File kredensial JSON atau P12 baru akan otomatis didownload. Simpan file ini di lokasi tertentu dan catat jalur filenya. Anda harus mengarahkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke file ini saat melalui proses autentikasi. Ini adalah langkah penting untuk mengautentikasi permintaan ke Cloud Talent Solution.

    Setelah file kredensial didownload, klik SELESAI:

  9. Akun layanan Anda sekarang akan muncul di halaman Hubungkan akun layanan. Klik HUBUNGKAN untuk menautkannya ke CTS API:

  10. Akun sekarang terhubung, dan Anda siap untuk mulai mengintegrasikan Cloud Talent Solution ke dalam sistem Anda:

Menetapkan variabel lingkungan autentikasi

Berikan kredensial autentikasi ke kode aplikasi Anda dengan menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jika Anda ingin variabel diterapkan ke sesi shell berikutnya, tetapkan variabel dalam file startup shell, misalnya dalam file ~/.bashrc atau ~/.profile.

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"

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.

Untuk mengetahui informasi lebih lanjut, lihat dokumentasi autentikasi GCP.

Langkah selanjutnya

Instal library klien atau lihat panduan memulai pembuatan lowongan dan perusahaan untuk mulai melakukan panggilan API.