Penyimpanan data Google Drive untuk Gemini Enterprise memungkinkan Anda menelusuri dan melakukan tindakan pada data Google Drive, termasuk file dan folder.
Tindakan yang didukung
Jika penyimpanan data Google Drive diaktifkan, pengguna akhir dapat menggunakan perintah bahasa alami di Gemini Enterprise untuk melakukan tindakan berikut.
Tindakan berikut membaca data Google Drive dan diaktifkan secara default:
| Tindakan | Deskripsi |
|---|---|
| Mendownload konten file | Mendownload konten file Google Drive. |
| Mendapatkan nilai sel | Membaca nilai sel dari spreadsheet Google Spreadsheet. |
| Mendapatkan metadata file | Mengambil metadata untuk file Google Drive. |
| Mendapatkan izin file | Mencantumkan izin pada file Google Drive. |
| Mendapatkan spreadsheet | Membaca konten dan metadata spreadsheet Google Spreadsheet. |
| Membuat daftar file terbaru | Mencantumkan file terbaru di Google Drive. |
| Mencantumkan drive bersama | Mencantumkan drive bersama di Google Drive. |
| Membaca dokumen | Membaca konten dokumen Google Dokumen. |
| Membaca konten file | Membaca konten file Google Drive. |
| Membaca presentasi | Membaca konten presentasi Google Slide. |
| Menelusuri file | Menelusuri file Google Drive yang cocok dengan kueri. |
Tindakan berikut mengubah data Google Drive dan dinonaktifkan secara default hingga administrator mengaktifkannya:
| Tindakan | Deskripsi |
|---|---|
| Salin file | Menyalin file di Google Drive. |
| Buat file | Membuat file baru di Google Drive. |
| Menyisipkan dimensi | Menyisipkan baris atau kolom ke dalam spreadsheet Google Spreadsheet. |
| Bagikan file | Membagikan file Google Drive kepada satu atau beberapa pengguna. |
| Membuang file ke sampah | Memindahkan file Google Drive ke sampah. |
| Memperbarui nilai sel | Menulis nilai sel ke spreadsheet Google Spreadsheet. |
| Perbarui file | Memperbarui file Google Drive yang ada. |
| Memperbarui formula | Menulis formula ke spreadsheet Google Spreadsheet. |
Tindakan dijalankan dengan izin pengguna yang memberikan otorisasi pada konektor. Pengguna hanya dapat membaca dan mengubah data yang sudah dapat mereka baca dan ubah di Google Drive.
Cakupan yang diperlukan
Aplikasi OAuth yang dikelola Googlememinta cakupan OAuth berikut. Pengguna memberikan cakupan ini saat mereka mengizinkan konektor:
| Cakupan | Tujuan |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
Menelusuri dan mengambil konten Google Drive. Memungkinkan penyimpanan data mencantumkan file dan folder, melihat metadata, mencantumkan izin, dan membaca konten file. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Membaca metadata file Google Drive. |
https://www.googleapis.com/auth/drive.file |
Membuat dan memperbarui file yang dibuka atau dibuat pengguna dengan konektor. |
https://www.googleapis.com/auth/drive.appdata |
Menyimpan data khusus aplikasi di Google Drive. |
https://www.googleapis.com/auth/drive |
Melakukan tindakan tulis pada file Google Drive (misalnya, menyalin, membagikan, membuang, dan memperbarui). |
Batasan
- Penyimpanan data Google Drive hanya didukung di lokasi
global,us, daneu.
Jika Anda menggunakan kontrol keamanan, perhatikan batasannya terkait data di Google Drive, seperti yang dibahas dalam tabel berikut:
Kontrol keamanan Perhatikan hal berikut Residensi Data (DRZ) Gemini Enterprise hanya menjamin residensi data di Google Cloud. Untuk mengetahui informasi tentang residensi data dan Google Drive, lihat panduan dan dokumentasi kepatuhan Google Workspace, termasuk Region data untuk Google Workspace. Tinjau juga contoh seperti Memilih region tempat data disimpan dan Kedaulatan digital. Kunci enkripsi yang dikelola pelanggan (CMEK) Kunci Anda hanya mengenkripsi data dalam Google Cloud. Kontrol Cloud Key Management Service tidak berlaku untuk data yang disimpan di Google Drive. Transparansi Akses Transparansi Akses mencatat tindakan yang dilakukan oleh personel Google di project Google Cloud . Anda juga perlu meninjau log Transparansi Akses yang dibuat oleh Google Workspace. Untuk mengetahui informasi selengkapnya, lihat Peristiwa log Transparansi Akses dalam dokumentasi Bantuan Admin Google Workspace.
Masalah penelusuran umum
Jika penelusuran Anda tidak menampilkan file yang Anda cari atau jika aplikasi web Gemini Enterprise melaporkan bahwa tidak ada file Google Drive yang cocok yang ditemukan, periksa masalah dan solusi berikut.
Akses Gemini Enterprise ke data Google Workspace dinonaktifkan
Gejala: Aplikasi web Gemini Enterprise melaporkan bahwa tidak ada file Google Drive yang cocok yang ditemukan, atau permintaan penelusuran yang dikirim melalui Search API menampilkan error (atau peringatan) 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin.. Anda juga dapat memeriksa log error penyimpanan data di Cloud Logging; lihat Memecahkan masalah penyimpanan data Gemini Enterprise.
Masalah: Setelan Izinkan Gemini Enterprise mengakses data Google Workspace dinonaktifkan di konsol Admin Google untuk organisasi Google Workspace pengguna.
Solusi: Minta administrator Google Workspace untuk organisasi pengguna agar mengaktifkan Izinkan Gemini Enterprise mengakses data Google Workspace. Dalam penyiapan lintas organisasi, administrator di setiap organisasi Google Workspace yang penggunanya mengkueri Google Drive harus mengaktifkan setelan ini.
Pengguna dan penyimpanan data berasal dari organisasi Google Workspace yang berbeda
Gejala: Pengguna yang login dari organisasi Google Workspace yang berbeda
dengan project Google Cloud tidak menerima hasil Google Drive di
aplikasi web Gemini Enterprise, atau permintaan yang dikirim melalui Search
API menampilkan error 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
.... Untuk memeriksa error 403 di log, lihat Mengakses log error konektor Gemini Enterprise dengan Cloud Logging.
Masalah: Secara default, Gemini Enterprise hanya mengizinkan pengguna menelusuri penyimpanan data Google Drive jika ID pelanggan Google Workspace pengguna cocok dengan organisasi penyimpanan data Google Drive dan Google Cloud project.
Solusi: Selesaikan penyiapan lintas organisasi:
- Hubungi Cloud Customer Care untuk menambahkan ID pelanggan setiap organisasi Google Workspace yang penggunanya mengakses Gemini Enterprise ke daftar yang diizinkan untuk project Google Cloud Anda.
- Minta administrator Google Workspace di setiap organisasi Google Workspace mengaktifkan Izinkan Gemini Enterprise mengakses data Google Workspace.
- Jika pengguna perlu menemukan dokumen yang dimiliki di luar organisasi mereka sendiri, aktifkan Sertakan dokumen lintas domain di Kelola fitur aplikasi web.
Kata kunci di luar batas ekstraksi teks 1 MB tidak dapat ditelusuri
Gejala: Menelusuri kata kunci yang muncul di bagian akhir file berukuran besar tidak akan menampilkan file tersebut.
Masalah: Google Drive hanya mengekstrak 1 MB data teks dan pemformatan dari file Anda agar dapat ditelusuri. Kata kunci yang melebihi batas indeks 1 MB tidak dapat ditelusuri.
Solusi: Telusuri menggunakan istilah yang muncul dalam 1 MB pertama file, atau bagi dokumen besar menjadi file yang lebih kecil.
File yang melebihi batas ukuran atau halaman PDF tidak akan diindeks
Gejala: File besar atau PDF panjang tertentu tidak muncul di hasil penelusuran.
Masalah: File yang melebihi batas ukuran atau halaman Google Drive tidak diindeks dan tidak akan muncul di hasil penelusuran:
- Untuk sebagian besar jenis file, ukuran file tidak boleh melebihi 10 MB, dengan pengecualian berikut:
- File XLSX: hingga 20 MB.
- File PDF: hingga 30 MB.
- File teks: hingga 100 MB.
- Pengenalan karakter optik (OCR) dalam file PDF dibatasi hingga 80 halaman. Google Drive tidak mengindeks PDF yang berukuran lebih dari 50 MB atau 80 halaman.
Solusi: Kurangi ukuran file atau bagi file dan PDF yang melebihi batas pengindeksan ini.
Langkah berikutnya
- Untuk membuat dan mengonfigurasi penyimpanan data dengan Google Drive, lihat Menyiapkan penyimpanan data Google Drive.