Menyiapkan penyimpanan data Gmail

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Gmail ke Gemini Enterprise.

Sebelum memulai

  • Login ke Google Cloud konsol dengan akun yang sama 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.

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

Membuat penyimpanan data Gmail

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

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

    Gemini Enterprise

  2. Pilih atau buat a Google Cloud project.

  3. Di menu navigasi, klik Data stores.

  4. Klik + Buat penyimpanan data.

  5. Di Source, telusuri Gmail, lalu klik Select.

  6. Di bagian Actions:

    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 rahasia klien, lihat Membuat kredensial klien OAuth. Untuk mengetahui cakupan yang diperlukan untuk penelusuran dan tindakan, lihat Cakupan yang diperlukan.

    2. Opsional: Luaskan Advanced settings dan masukkan Service name, 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 mengelola daftar tindakan, lihat Mengelola tindakan.

  7. Klik Continue.

  8. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Data connector name, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Encryption settings:
      • Pilih Google-managed encryption key atau Cloud KMS key.
      • Jika Anda memilih Cloud KMS key:
        • Di daftar Key management type, pilih jenis yang sesuai.
        • Di daftar Cloud KMS key, pilih kunci.
      Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  9. Klik Continue.

  10. Di bagian Billing, pilih General pricing atau Configurable pricing. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  11. Klik Create. Gemini Enterprise 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 penggunaan penyimpanan data gabungan.

Setelah Anda mengotorisasi 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 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 Google Workspace data stores. Mesin yang ditelusuri memiliki penyimpanan data Google Workspace, dan the credentials 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) Customer ID tidak cocok untuk penyimpanan data Penelusuran hanya diizinkan untuk pengguna yang tergabung dalam organisasi yang sama dengan Google Workspace data stores. Hapus penyimpanan data Google Workspace dari mesin atau hubungi dukungan jika pengguna dan penyimpanan data Google Workspace dimaksudkan untuk berada dalam organisasi yang berbeda.
403 (Permission Denied) Akses Workspace untuk Agent Space 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