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 diakhiri dengan
@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.
Aktifkan fitur cerdas: Di akun Google Workspace Anda, aktifkan Fitur cerdas di Google Workspace dan Fitur cerdas di produk Google Google lainnya. Untuk mengetahui detailnya, lihat Mengaktifkan atau menonaktifkan fitur cerdas Google Workspace.
Mengizinkan aplikasi OAuth (Khusus Administrator): Penyimpanan data Gmail menggunakan aplikasi OAuth yang dikelola Googleuntuk 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 Mengizinkan aplikasi OAuth yang dikelola Google.
Membuat 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 Source, telusuri Google Mail, lalu klik Select.
Di bagian Actions, 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 Data connector name, masukkan nama untuk konektor Anda.
- Jika Anda memilih
usataueusebagai lokasi, konfigurasikan Setelan enkripsi:- Pilih Google-managed encryption key atau Cloud KMS key.
- Jika Anda memilih Cloud KMS key:
- Dalam daftar Key management type, pilih jenis yang sesuai.
- Di daftar Cloud KMS key, pilih kunci.
Opsional: Di kolom Tag, masukkan ID 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 Sensitive Data Protection policy, lampirkan Sensitive Data Protection content policy yang ada untuk memeriksa dan memblokir data sensitif yang diambil Gemini Enterprise melalui penyimpanan data ini. Untuk mengetahui informasi selengkapnya, lihat Melindungi data sensitif di sumber. Jika organisasi Anda tidak memerlukan kebijakan konten Sensitive Data Protection, 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 Creating menjadi Active, 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 dari penggunaan penyimpanan data gabungan.
Setelah Anda mengizinkan Gmail dan mengirim kueri penelusuran ke Gemini Enterprise:
- Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke Gmail API.
- Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung dan menampilkan hasil penelusuran yang komprehensif.
Pesan error dan pemecahan masalah
Tabel berikut menjelaskan pesan error umum yang mungkin Anda temui saat menggunakan 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 kredensial 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 penyimpanan data pengguna dan Google Workspace dimaksudkan untuk 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 untuk mengkueri data Gmail Anda, buat aplikasi dan hubungkan ke penyimpanan data Gmail.
- Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
- Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.
- Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.