Menyiapkan penyimpanan data Gmail

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. Vertex AI Search menggunakan ID pelanggan Google Workspace Anda untuk terhubung ke Gmail.

  • Untuk menerapkan kontrol akses sumber data dan mengamankan data di Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas Anda.

  • Sebelum Anda menambahkan tindakan ke penyimpanan data Gmail, administrator Google Cloud harus terlebih dahulu menyelesaikan langkah-langkah di bagian Menyiapkan autentikasi dan izin untuk Gmail untuk mengonfigurasi autentikasi OAuth 2.0 guna memberi Anda ID klien dan rahasia klien serta menyiapkan izin minimum.

Buat penyimpanan data Gmail

Untuk membuat penyimpanan data Gmail, lakukan langkah-langkah berikut:

  1. Di konsol Google Google Cloud , buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Pilih atau buat project Google Cloud .

  3. Di menu navigasi, klik Penyimpanan data.

  4. Klik + Create data store.

  5. Di bagian Sumber, telusuri Gmail, lalu klik Pilih.

  6. Di bagian Tindakan:

    1. Masukkan Client ID dan Client Secret yang diperoleh dari aplikasi OAuth 2.0, lalu klik Verify Auth.

      Untuk mengetahui informasi tentang cara mendapatkan client ID dan client secret, lihat Membuat kredensial klien OAuth. Untuk cakupan yang diperlukan untuk penelusuran dan tindakan, lihat Cakupan yang diperlukan.

    2. Opsional: Perluas Setelan lanjutan dan masukkan Nama layanan, nama resource layanan Anda yang dibuat di Service Directory. Kolom ini wajib diisi jika Kontrol Layanan VPC diaktifkan.

    3. Pilih tindakan dari daftar untuk mengaktifkannya bagi konektor Gmail.

    Untuk melihat daftar tindakan, lihat Melihat tindakan.

  7. Klik Lanjutkan.

  8. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih US atau EU sebagai lokasi, konfigurasikan 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.
      Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  9. Klik Lanjutkan.

  10. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  11. 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 mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirim 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