Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Gmail ke Gemini Enterprise.
Sebelum memulai
Login ke konsol Google Cloud dengan akun yang sama dengan yang Anda gunakan untuk instance Google Workspace yang ingin Anda hubungkan. Gemini Enterprise menggunakan ID pelanggan Google Workspace Anda untuk terhubung ke Gmail. Akun Google Pribadi (akun konsumen yang berakhiran
@gmail.com) tidak memiliki ID pelanggan dan tidak didukung.Untuk menerapkan kontrol akses sumber data dan mengamankan data di Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas Anda.
Aktifkan fitur smart: Di akun Google Workspace Anda, aktifkan Fitur smart di Google Workspace dan Fitur smart di produk Google Google lainnya. Untuk mengetahui detailnya, lihat Mengaktifkan atau menonaktifkan fitur smart Google Workspace.
Mengizinkan aplikasi OAuth (Khusus Administrator): Penyimpanan data Gmail menggunakan aplikasi OAuth yang dikelola GoogleGoogle untuk mengakses data Anda. Jika organisasi Anda membatasi akses aplikasi OAuth, administrator Google Workspace Anda harus menambahkan aplikasi ini ke daftar yang diizinkan organisasi Anda. Untuk mengetahui detailnya, lihat Menambahkan aplikasi OAuth yang dikelola Googleke daftar yang diizinkan.
Buat penyimpanan data Gmail
Untuk membuat penyimpanan data Gmail, lakukan langkah-langkah berikut:
Di konsol Google Google Cloud , buka halaman Gemini Enterprise.
Pilih atau buat project Google Cloud .
Di menu navigasi, klik Penyimpanan data.
Klik + Buat penyimpanan data.
Di Sumber, telusuri Google Mail, lalu klik Pilih.
Di bagian Tindakan, pilih tindakan dari daftar untuk mengaktifkannya bagi konektor Gmail.
Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
Klik Lanjutkan.
Di bagian Configuration:
- Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
- Di kolom Nama konektor data, masukkan nama untuk konektor Anda.
- Jika Anda memilih
usataueusebagai lokasi, konfigurasi Setelan enkripsi:- Pilih Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
- Jika Anda memilih kunci Cloud KMS:
- Di daftar Key management type, pilih jenis yang sesuai.
- Di daftar Kunci Cloud KMS, pilih kunci.
Opsional: Di kolom Tag, masukkan ID yang stabil untuk penyimpanan data. ID ini digunakan di berbagai versi konektor dan menjadi tidak dapat diubah setelah penyimpanan data dibuat, jadi pilih nilai yang tidak perlu Anda ubah nanti.
Opsional: Di bagian kebijakan Sensitive Data Protection, lampirkan kebijakan Sensitive Data Protection yang ada untuk memeriksa dan melakukan de-identifikasi data yang diambil Gemini Enterprise melalui penyimpanan data ini. Jika organisasi Anda tidak memerlukan kebijakan Perlindungan Data Sensitif, Anda dapat melewati langkah ini.
Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.
Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Saat status penyimpanan data berubah dari Membuat menjadi Aktif, konektor Gmail siap digunakan.
Setelah membuat penyimpanan data, buat aplikasi dan hubungkan ke penyimpanan data Gmail sebelum menjalankan kueri.
Eksekusi Kueri
Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi penggunaan penyimpanan data gabungan.
Setelah Anda mengizinkan Gmail dan mengirimkan kueri penelusuran ke Gemini Enterprise:
- Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke Gmail API.
- Gemini Enterprise menggabungkan hasil dengan hasil dari sumber data terhubung lainnya dan menampilkan hasil penelusuran yang komprehensif.
Pesan error dan pemecahan masalah
Tabel berikut menjelaskan pesan error umum yang mungkin Anda temui saat bekerja dengan konektor Gmail, yang mencakup kemungkinan kode error HTTP dan langkah-langkah pemecahan masalah yang disarankan.
| Kode error | Pesan error | Deskripsi | Pemecahan masalah |
|---|---|---|---|
| 403 (Permission Denied) | Penelusuran menggunakan kredensial akun layanan tidak didukung untuk penyimpanan data Google Workspace. | Mesin yang ditelusuri memiliki penyimpanan data Google Workspace, dan kredensial yang diteruskan adalah akun layanan. Penelusuran menggunakan kredensial akun layanan di penyimpanan data Google Workspace tidak didukung. | Panggil penelusuran menggunakan kredensial pengguna, atau hapus penyimpanan data Google Workspace dari mesin. |
| 403 (Permission Denied) | Akun konsumen tidak didukung untuk penyimpanan data Google Workspace. | Penelusuran dipanggil menggunakan kredensial akun konsumen (@gmail.com), yang tidak didukung untuk penyimpanan data Google Workspace. | Hapus penyimpanan data Google Workspace dari mesin atau gunakan Akun Google terkelola. |
| 403 (Permission Denied) | ID pelanggan tidak cocok untuk penyimpanan data | Penelusuran hanya diizinkan untuk pengguna yang tergabung dalam organisasi yang sama dengan penyimpanan data Google Workspace. | Hapus penyimpanan data Google Workspace dari mesin atau hubungi dukungan jika pengguna dan penyimpanan data Google Workspace seharusnya berada di organisasi yang berbeda. |
| 403 (Permission Denied) | Akses Workspace untuk Ruang Agen dinonaktifkan oleh administrator organisasi. | Administrator Google Workspace telah menonaktifkan akses ke data Google Workspace untuk Gemini Enterprise. | Hubungi administrator Google Workspace Anda untuk mengaktifkan akses. |
Langkah berikutnya
- Untuk menyediakan antarmuka pengguna dalam membuat kueri data Gmail Anda, buat aplikasi dan hubungkan ke penyimpanan data Gmail.
- Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
- Untuk mengaktifkan pemberitahuan untuk penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.
- Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.