Mengonfigurasi OAuth untuk Google Chat

Halaman ini menjelaskan cara mengonfigurasi OAuth untuk menghubungkan Google Chat ke Gemini Enterprise sebagai penyimpanan data.

Menyiapkan autentikasi dan izin untuk Google Chat

Untuk mengaktifkan tindakan Google Chat, administrator Google Cloud harus melakukan langkah-langkah berikut untuk mengaktifkan Google Chat API dan menyiapkan autentikasi.

Mengaktifkan Google Chat API

Di project konsol Google Cloud , aktifkan Google Chat API.

Mengonfigurasi aplikasi

1. Setelah mengaktifkan API, buka tab Configuration dan siapkan detail aplikasi Anda sebagai berikut:

   • Nama aplikasi: Masukkan nama untuk aplikasi (misalnya, Gemini Enterprise). Pengguna akan melihat nama ini saat aplikasi Anda mengirim pesan.
   • URL Avatar: Berikan URL untuk ikon Gemini Enterprise. Ikon ini akan muncul di samping nama aplikasi dalam rangkaian pesan chat.
   • Deskripsi: Masukkan deskripsi (misalnya, Google Chat app for Gemini Enterprise).

2. Di bagian Status aplikasi, pastikan statusnya disetel ke AKTIF.

   Catatan: Jika Status aplikasi adalah DINONAKTIFKAN, permintaan ke Google Chat REST API menggunakan nomor project ini akan ditolak.

3. Klik Simpan.

Membuat aplikasi OAuth dan menambahkan cakupan

Jika Anda tidak memiliki aplikasi OAuth, ikuti langkah-langkah berikut. Jika Anda sudah memiliki aplikasi OAuth, lanjutkan ke Buat kredensial klien OAuth.

1. Buka Google Auth Platform > Ringkasan.

   Buka Auth Platform

2. Klik Mulai.

3. Masukkan nama untuk aplikasi OAuth Anda.

4. Di bagian Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna aplikasi Anda jika ada pertanyaan tentang izin mereka.

5. Di bagian Audiens, pilih jenis pengguna untuk aplikasi Anda:

   • Eksternal: Pilih Eksternal jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace Anda. Hal ini membuat aplikasi tersedia secara publik untuk semua pengguna yang memiliki akun Google . Jika Anda memilih Eksternal, tambahkan pengguna uji:
     1. Klik Audiens.
     2. Di bagian Pengguna pengujian, klik Tambahkan pengguna.
     3. Masukkan alamat email Anda dan pengguna uji resmi lainnya, lalu klik Simpan.
   • Internal: Pilih Internal jika aplikasi dibatasi untuk anggota organisasi Google Cloud tertentu, sehingga hanya anggota organisasi Google Workspace yang dapat mengaksesnya.

6. Klik Berikutnya.

7. Di bagian Informasi Kontak, masukkan alamat email yang dapat digunakan untuk memberi tahu Anda tentang perubahan apa pun pada project Anda.

8. Klik Berikutnya.

9. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API. Jika Anda setuju, pilih Saya menyetujui Layanan Google API: Kebijakan Data Pengguna.

10. Klik Lanjutkan.

11. Klik Create.

Setelah membuat aplikasi, Anda dapat memperbarui setelan Layar Izin OAuth di Branding dan Audiens.

Menambahkan cakupan

Untuk menambahkan cakupan minimum yang diperlukan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka Menu .
2. Pilih Akses Data dari menu navigasi.
3. Klik Tambahkan atau Hapus Cakupan.
4. Di bagian Tambahkan cakupan secara manual, tempel cakupan berikut untuk Google Chat berdasarkan persyaratan Anda:

Mode koneksi	Cakupan	Tujuan
Penelusuran gabungan	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly	Izin minimum yang diperlukan untuk menelusuri dan mengambil konten. Memungkinkan penyimpanan data mencantumkan ruang dan membaca pesan.
Penelusuran gabungan dan Tindakan	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly
	https://www.googleapis.com/auth/chat.spaces.create	Pembuatan ruang: Cakupan minimum yang diperlukan untuk membuat ruang chat.
	https://www.googleapis.com/auth/chat.messages.create	Pengiriman pesan: Cakupan minimum yang diperlukan untuk membalas rangkaian pesan chat.

5. Klik Tambahkan ke tabel, lalu klik Perbarui.

6. Klik Simpan.

Catatan: Jika Anda hanya perlu menelusuri penyimpanan data dan tidak akan melakukan tindakan lain, batasi cakupan ke https://www.googleapis.com/auth/chat.spaces.readonly dan https://www.googleapis.com/auth/chat.messages.readonly. Untuk melakukan tindakan, Anda memerlukan cakupan tambahan yang ditentukan dalam Tindakan yang didukung.

Membuat kredensial klien OAuth

Prosedur ini menjelaskan cara membuat ID klien OAuth baru untuk Google Cloud tindakan. Jika sudah memiliki client ID OAuth untuk Google Cloud tindakan, Anda dapat menggunakan client ID dan secret tersebut untuk tindakan Google Chat, bukan membuat yang baru.

1. Buka Google Auth Platform / Clients.

2. Klik Buat klien.

3. Untuk Jenis aplikasi, pilih Aplikasi web.

4. Di kolom Name, masukkan nama untuk kredensial.

5. Lewati Authorized JavaScript origins.

6. Di bagian URI pengalihan yang diberi otorisasi, klik Tambahkan URI dan masukkan URI berikut: https://vertexaisearch.cloud.google.com/oauth-redirect

7. Klik Create. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0. Buka klien yang baru saja Anda buat dan salin informasi berikut:

   • Client ID
   • Rahasia klien