Memanggil API dari project Google Cloud

1. Sebelum memulai

Codelab ini menunjukkan cara membuat project Google Cloud, lalu memanggil Google Cloud API dari project tersebut.

Prasyarat

• Kemampuan untuk menggunakan Google Cloud Console.

Yang akan Anda pelajari

• Cara membuat project Google Cloud.
• Cara menyiapkan akun penagihan.
• Cara menyiapkan Cloud Shell.
• Cara mengaktifkan API.
• Cara memberi otorisasi API dengan kunci API.
• Cara memberi otorisasi API dengan akun layanan.

Yang Anda butuhkan

• Akun Google, seperti Akun Gmail atau akun Google Workspace.
• Akses ke akun Penagihan Cloud atau kartu kredit yang akan digunakan untuk mendaftar ke program Uji Coba Gratis.

2. Memulai persiapan

Bagian ini menampilkan cara membuat project Google Cloud, menyiapkan akun penagihan, dan menyiapkan Cloud Shell.

Membuat project Google Cloud dan menyiapkan akun penagihan

Catatan: Jika belum memiliki akun Gmail atau akun Google Workspace, Anda harus membuatnya terlebih dahulu.

1. Login ke Cloud Console dan pilih atau buat project.

Peringatan: Jika menggunakan kembali project dan menyelesaikan codelab ini, Anda dapat mengizinkan beberapa pengguna mengakses resource dalam project tersebut jika resource tidak dinonaktifkan setelah selesai.

Ingat project ID, yang ditampilkan di kolom Project name. ID ini adalah nama unik di semua project Google Cloud (nama di atas telah digunakan), dan selanjutnya disebut dalam codelab ini sebagai PROJECT_ID.

Catatan: Jika menggunakan akun Gmail, Anda dapat menyetel lokasi default ke No organization. Jika Anda menggunakan akun Google Workspace, pilih lokasi yang sesuai untuk organisasi Anda.

2. Selanjutnya, aktifkan penagihan di Konsol Cloud untuk menggunakan resource Google Cloud.

Meskipun codelab ini tidak memerlukan banyak biaya, jika ada, ikuti petunjuk di bagian Membersihkan untuk menonaktifkan resource dan menghindari biaya di luar codelab ini. Perhatikan bahwa pengguna baru Google Cloud memenuhi syarat untuk mendapatkan uji coba gratis senilai US$300.

Menyiapkan Cloud Shell

Dalam codelab ini, Anda akan menggunakan Cloud Shell, yakni lingkungan command line yang berjalan di Google Cloud. Cloud Shell adalah virtual machine berbasis Debian yang dimuat dengan semua alat pengembangan yang Anda perlukan. Layanan ini menawarkan direktori beranda tetap sebesar 5 GB, yang sangat meningkatkan performa dan autentikasi jaringan. Artinya, yang Anda butuhkan untuk codelab ini hanyalah browser.

Untuk mengaktifkan Cloud Shell dari Cloud Console:

1. Klik Activate Cloud Shell.

Mungkin perlu waktu beberapa saat untuk melakukan penyediaan dan terhubung ke lingkungan.

Setelah terhubung ke Cloud Shell, Anda akan melihat bahwa Anda sudah diautentikasi dan project sudah ditetapkan ke PROJECT_ID Anda.

2. Membuat daftar akun berkredensial:

gcloud auth list

Anda akan melihat output ini:

Credentialed accounts:
 - <MY_ACCOUNT>@<MY_DOMAIN>.com (active)

Catatan: Alat CLI gcloud sudah terinstal di Cloud Shell, dan membantu Anda membuat serta mengelola resource Google Cloud. Untuk mengetahui informasi selengkapnya, baca ringkasan alat gcloud.

3. Untuk melihat daftar project Anda, masukkan perintah ini.

gcloud config list project

Anda akan melihat output ini:

[core]
project = <PROJECT_ID>

Jika project belum ditetapkan karena alasan tertentu, jalankan perintah ini untuk menyiapkan project.

gcloud config set project <PROJECT_ID>

PROJECT_ID adalah ID yang Anda gunakan pada langkah-langkah penyiapan. Anda juga dapat mencarinya di dasbor Konsol Cloud:

Cloud Shell juga menetapkan beberapa variabel lingkungan secara default, yang mungkin berguna saat Anda menjalankan perintah di masa mendatang.

4. Untuk melihat project ID Anda, masukkan perintah berikut.

echo $GOOGLE_CLOUD_PROJECT

Anda akan melihat output berikut:

<PROJECT_ID>

5. Terakhir, tetapkan zona dan konfigurasi project default.

gcloud config set compute/zone us-central1-f

Anda dapat memilih berbagai zona yang berbeda. Untuk mengetahui informasi selengkapnya, lihat Region dan zona.

Catatan: Saat Anda menjalankan alat CLI gcloud di komputer, setelan konfigurasi akan berlaku di seluruh sesi. Namun, dalam Cloud Shell, Anda perlu mengonfigurasi setelan ini untuk setiap sesi atau koneksi ulang baru.

3. Memanggil API dari project

Codelab ini menunjukkan cara menggunakan API contoh (Natural Language API) untuk menemukan entity (seperti orang, tempat, dan peristiwa) dalam teks, dan cara memperkirakan sentimen (tingkat preferensi) dari teks tersebut. Anda akan mempelajari cara:

• Mengaktifkan Google Cloud API.
• Dapatkan otorisasi untuk API dengan kunci API dan akun layanan.
• Panggil API dengan curl dan library klien.

Mengaktifkan API

1. Pilih API & Services dari menu utama di Konsol Cloud.

2. Pilih + ENABLE APIS AND SERVICES dari bagian atas layar.

3. Pada tahap ini, Anda dapat memfilter dan menjelajahi API, atau langsung membuka API dengan kotak Penelusuran. Telusuri Natural Language, lalu pilih Cloud Natural Language API.

4. Klik COBA API INI.

Jika tombol TRY INI API tidak ditampilkan, klik salah satu Metode yang tercantum untuk mencoba metode tersebut.

Membuat Kunci API

Karena Anda menggunakan curl untuk mengirim permintaan ke Natural Language API, Anda harus membuat kunci API untuk meneruskan URL permintaan.

1. Di Konsol Cloud, pilih Navigation menu > API & Layanan > Kredensial.

2. Klik BUAT KREDENSIAL, lalu pilih kunci API:

3. Salin kunci API yang dibuat, lalu klik Close.

Menggunakan kunci API untuk memanggil API

1. Pada command line Cloud Shell, ekspor kunci API Anda.

export API_KEY=<YOUR_API_KEY>

Ganti <YOUR_API_KEY> dengan kunci yang Anda buat sebelumnya.

2. Buat permintaan untuk API di Cloud Shell Editor atau dengan editor Linux, seperti Vim atau Emacs. Anda dapat menemukan detail parameter ini di Method: documents.analyzeEntities. Simpan output dalam file bernama request.json:

{
  "document":{
    "type":"PLAIN_TEXT",
    "content":"Google, headquartered in Mountain View (1600 Amphitheatre Pkwy, Mountain View, CA 940430), unveiled the new Android phone for $799 at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones."
  },
  "encodingType":"UTF8"
}

3. Panggil API dengan informasi permintaan.

curl "https://language.googleapis.com/v1/documents:analyzeEntities?key=${API_KEY}" \
  -s -X POST -H "Content-Type: application/json" --data-binary @request.json

4. Jalankan kembali perintah dan alihkan output ke file dan periksa hasilnya. Detail output file JSON juga ada di Method: documents.analyzeEntities.
5. Untuk mengubah teks yang akan dianalisis di file request.json, ganti nilai content dengan teks pilihan Anda.

4. Memberi otorisasi dengan akun layanan

Akun layanan sering kali lebih disukai daripada kunci API karena menyediakan autentikasi dan otorisasi. Anda dapat menganggap akun layanan sebagai alamat email untuk aplikasi Anda.

1. Kembali ke bagian Credentials di APIs & Layanan.
2. Pilih Create Credentials, tetapi untuk kali ini, pilih Service Account.

3. Berikan Nama akun layanan yang menjelaskan tujuannya, seperti "Natural Language Service Account". Sistem menyarankan ID. Anda juga dapat menambahkan deskripsi. Setelah mempelajari akun layanan lebih lanjut, Anda memberi akun layanan akses ke project dan memberi pengguna akses ke akun layanan. Namun, untuk saat ini, cukup klik Selesai untuk membuat akun layanan.
4. Untuk membuat pasangan kunci yang akan digunakan akun layanan, klik untuk mengedit akun layanan.

Detail akun layanan Anda akan ditampilkan.

5. Salin alamat email akun layanan dan kembali ke Cloud Shell.
6. Di Cloud Shell, buat pasangan kunci untuk akun layanan Anda dan tetapkan variabel lingkungan untuk diarahkan ke akun tersebut:

gcloud iam service-accounts keys create ~/key.json \
  --iam-account <your service account email>
export GOOGLE_APPLICATION_CREDENTIALS="/home/$USER/key.json"

Google Cloud menggunakan variabel lingkungan ini untuk menemukan kredensial, sehingga tidak perlu disertakan dalam panggilan API.

7. Sekarang Anda dapat memanggil API dengan perintah:

gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'." 

Hasilnya harus sama seperti sebelumnya.

Banyak API memiliki library klien yang ekstensif untuk mengekstrak detail ini. Untuk mempelajari library klien lebih lanjut, lihat Library Klien Cloud. Anda juga dapat membaca dokumentasi API yang digunakan untuk melihat library klien apa yang tersedia untuk mereka.

5. Pembersihan

Memiliki kunci API yang tidak dibatasi untuk project merupakan praktik yang buruk. Jika seseorang mendapatkan akses ke sandi, orang tersebut dapat menggunakannya tanpa memerlukan autentikasi lebih lanjut.

Untuk menghapus kunci API ini:

1. Klik Navigation menu > API & Layanan > Kredensial.
2. Di bagian API Keys, pilih kunci yang akan dihapus, lalu klik Delete.
3. Daripada khawatir Kunci Pribadi Akun Layanan Anda tidak dilindungi, di bagian Service Accounts, pilih akun layanan yang akan dihapus, lalu klik Delete.

6. Selamat

Selamat! Anda telah mempelajari cara membuat project Google Cloud dan cara memanggil API dari dalam project.