Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API.
Panduan memulai Google Workspace menggunakan library klien API untuk menangani beberapa detail tentang alur otentikasi dan otorisasi. Sebaiknya Anda menggunakan library klien untuk aplikasi Anda sendiri. Panduan memulai ini menggunakan pendekatan otentikasi yang disederhanakan yang sesuai untuk pengujian lingkungan fleksibel App Engine. Untuk lingkungan produksi, sebaiknya pelajari tentang autentikasi dan otorisasi sebelum memilih kredensial akses yang sesuai untuk aplikasi Anda.
Buat Skrip Google Apps yang membuat permintaan ke Google Chat API.
Tujuan
- Konfigurasi lingkungan.
- Buat dan konfigurasi skrip.
- Jalankan skrip.
Prasyarat
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
Mengonfigurasi project Cloud
Jika menggunakan project Google Cloud baru untuk menyelesaikan panduan memulai ini, Anda harus mengkonfigurasinya dan menambahkan Anda sebagai pengguna uji coba. Jika Anda sudah menyelesaikan langkah-langkah ini untuk project Cloud Anda, lanjutkan ke bagian berikutnya.
Buka project Cloud Anda di konsol Google Cloud
Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:
- Di konsol Google Cloud, buka halaman Select a project.
- Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.
Mengaktifkan Chat API
Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di konsol Google Cloud, aktifkan Google Chat API.
Mengonfigurasi layar izin OAuth
- Di konsol Google Cloud, buka Menu > API & Layanan > Layar izin OAuth.
- Untuk Jenis pengguna, pilih Internal, lalu klik Buat.
- Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.
Untuk saat ini, Anda dapat melewati penambahan cakupan, lalu mengklik Simpan dan Lanjutkan. Pada masa mendatang, jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal, lalu menambahkan cakupan otorisasi yang dibutuhkan aplikasi Anda.
- Tinjau ringkasan pendaftaran aplikasi Anda. Untuk melakukan perubahan, klik Edit. Jika aplikasi pendaftaran tampak tidak bermasalah, klik Kembali ke Dasbor.
Mengonfigurasi aplikasi Google Chat
Untuk memanggil Google Chat API, Anda harus mengonfigurasi Aplikasi Google Chat. Untuk permintaan tulis apa pun, Google Chat mengatribusikan aplikasi Google Chat di UI menggunakan informasi berikut.
Di konsol Google Cloud, buka halaman Configuration Chat API:
Di bagian Application info, masukkan informasi berikut:
- Di kolom App name, masukkan
Chat API quickstart app
. - Di kolom Avatar URL, masukkan
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Di kolom Description, masukkan
Quickstart for calling the Chat API
.
- Di kolom App name, masukkan
Di bagian Interactive Features, klik Enable interaktif feature alihkan ke posisi nonaktif untuk menonaktifkan fitur interaktif bagi Aplikasi Chat.
Klik Simpan.
Membuat skrip
- Buat skrip baru dengan membuka script.google.com/create.
- Ganti konten editor skrip dengan kode berikut:
- Klik Simpan .
- Klik Project tanpa judul, ketik Panduan memulai, lalu klik Ganti nama.
Mengonfigurasi skrip
Salin nomor project Cloud
- Di konsol Google Cloud, buka Menu > IAM & Admin > Setelan.
- Di kolom Project number, salin nilainya.
Tautkan project Google Cloud Anda
- Buka project Apps Script.
- Klik Project Settings .
- Pada Google Cloud Platform (GCP) Project, klik Change project.
- Di GCP project number, tempel nomor project Google Cloud.
- Klik Set project.
Mengaktifkan Google Chat API
- Buka project Apps Script.
- Klik Project Settings .
- Di bagian Setelan umum, aktifkan Tampilkan "appsscript.json" file manifes di editor.
- Klik Editor
appscript.json
, dan ganti konten dengan kode berikut:
, pilih
file
Menjalankan contoh
Di editor Apps Script, klik Run.
Saat pertama kali menjalankan contoh, Anda akan diminta untuk mengizinkan akses:
- Klik Tinjau izin.
- Pilih akun.
- Klik Izinkan.
Log eksekusi skrip akan muncul di bagian bawah jendela.