Ringkasan

Penyimpanan data Microsoft Outlook untuk Gemini Enterprise memungkinkan Anda menelusuri dan melakukan tindakan pada email, kalender, kontak, dan file Microsoft 365 (workbook Excel, dokumen Word, dan presentasi PowerPoint) yang disimpan di OneDrive dan SharePoint.

Catatan: Saat menggunakan penelusuran gabungan atau konektor gabungan, string kueri Anda akan dikirim ke semua backend penelusuran pihak ketiga yang diaktifkan. String kueri yang dikirim ke sistem pihak ketiga mungkin berisi bagian dari data dalam permintaan penelusuran dan histori percakapan Anda. Sistem pihak ketiga dapat menautkan kueri dengan identitas Anda. Setelah data berada di sistem pihak ketiga, data tersebut tunduk pada Persyaratan Layanan dan kebijakan privasi sistem tersebut, bukan Persyaratan Layanan Google Cloud.

Versi Microsoft Outlook yang didukung

Penyimpanan data Microsoft Outlook mendukung Microsoft Graph API v1.0 dengan integrasi IDP.

Tindakan yang didukung

Jika penyimpanan data Microsoft Outlook diaktifkan, pengguna akhir dapat menggunakan perintah bahasa alami di Gemini Enterprise untuk melakukan tindakan berikut.

Tindakan	Deskripsi
Buat kontak	Membuat kontak baru di Microsoft Outlook.
Buat acara	Membuat acara baru.
Download lampiran	Mendownload lampiran dari pesan email Microsoft Outlook.
Kirim email	Mengirim pesan email. Hal ini termasuk mengirim email dengan lampiran.
Tambahkan lampiran	Menambahkan satu atau beberapa lampiran ke draf pesan email yang ada.
Buat pesan	Membuat pesan email draf baru di kotak surat pengguna yang login.
Meneruskan email	Meneruskan pesan email yang ada ke satu atau beberapa penerima.
Pindahkan email	Memindahkan pesan email ke folder email lain di kotak surat pengguna yang login.
Balas pesan	Mengirim balasan ke pesan email yang ada di kotak surat pengguna yang login.
Perbarui pesan	Memperbarui pesan email draf yang ada di kotak surat pengguna yang login.
Perbarui kontak	Memperbarui kontak yang ada di Microsoft Outlook.
Perbarui acara	Memperbarui acara yang ada.
Membaca data Excel	Mencantumkan workbook, membaca worksheet, tabel, dan baris dari file Excel (.xlsx) yang disimpan di OneDrive atau SharePoint.
Mengedit data Excel	Menambahkan dan memperbarui baris, membuat worksheet dan tabel, serta menambahkan kolom kunci dalam file Excel (.xlsx) yang disimpan di OneDrive atau SharePoint.
Membuat dokumen Word	Membuat dokumen Word (.docx) baru di OneDrive pengguna.
Mengonversi dokumen Word ke PDF	Mengonversi dokumen Word (.docx) yang disimpan di OneDrive atau SharePoint ke PDF.
Membuat presentasi PowerPoint	Membuat presentasi PowerPoint (.pptx) baru di OneDrive pengguna.
Mengonversi PowerPoint ke PDF	Mengonversi presentasi PowerPoint (.pptx) yang disimpan di OneDrive atau SharePoint ke PDF.
Buat kalender	Membuat kalender baru untuk pengguna yang login.
Perbarui kalender	Memperbarui kalender yang ada untuk pengguna yang login.
RSVP ke acara	Merespons (menerima, menolak, atau menerima sementara) undangan acara kalender.

Catatan:

• Tindakan hanya baca tambahan juga tersedia.
• Ukuran file maksimum untuk upload dan download file di Gemini Enterprise adalah 25 MB.
• Tindakan Excel, Word, dan PowerPoint memerlukan izin Microsoft Graph API tambahan pada file OneDrive atau SharePoint yang sedang dikerjakan pengguna. Untuk mengetahui detailnya, lihat [Izin yang diperlukan](#required-permissions).

Izin yang diperlukan

Tabel berikut menguraikan izin yang diperlukan untuk penelusuran dan tindakan Microsoft Outlook.

Mode koneksi	Izin	Tujuan
Penelusuran gabungan	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Didelegasikan) Mengizinkan penyimpanan data membaca kotak surat pengguna yang login, email dari kotak surat bersama, acara kalender, dan kontak.
Penyerapan data	Calendars.Read	(Aplikasi) Mengizinkan penyimpanan data membaca acara dari semua kalender.
	Calendars.ReadBasic.All	(Aplikasi) Mengizinkan penyimpanan data membaca acara dari semua kalender, kecuali untuk properti seperti isi, lampiran, dan ekstensi.
	Contacts.Read	(Aplikasi) Mengizinkan penyimpanan data membaca semua kontak di semua kotak surat.
	Mail.Read	(Aplikasi) Mengizinkan penyimpanan data membaca email di semua kotak surat.
	Mail.ReadBasic	(Aplikasi) Memungkinkan penyimpanan data membaca properti email dasar di semua kotak surat. Mencakup semua properti kecuali body, previewBody, attachments, dan properti yang diperluas.
	Mail.ReadBasic.All	(Aplikasi) Memungkinkan penyimpanan data membaca properti email dasar di semua kotak surat. Mencakup semua properti kecuali body, previewBody, attachments, dan properti yang diperluas.
	User.Read	(Didelegasikan) Mengizinkan penyimpanan data membaca profil pengguna yang login.
	User.Read.All	(Aplikasi) Mengizinkan penyimpanan data membaca kumpulan lengkap properti profil, laporan, dan pengelola pengguna lain di organisasi Anda.
	User.ReadBasic.All	(Aplikasi) Mengizinkan penyimpanan data membaca kumpulan properti profil dasar pengguna lain di organisasi Anda.
Tindakan	Mail.Send	(Didelegasikan) Mengizinkan penyimpanan data mengirim email sebagai pengguna di organisasi.
	Mail.ReadWrite	(Didelegasikan) Mengizinkan penyimpanan data membuat, membaca, memperbarui, memindahkan, dan menghapus pesan, serta menambahkan lampiran ke pesan. Diperlukan untuk tindakan **Tambahkan lampiran**, **Buat pesan**, **Perbarui pesan**, dan **Pindahkan email**.
	Calendars.ReadWrite	(Didelegasikan) Mengizinkan penyimpanan data membuat, membaca, memperbarui, dan menghapus acara di kalender pengguna.
	Contacts.ReadWrite	(Didelegasikan) Mengizinkan penyimpanan data membuat, membaca, memperbarui, dan menghapus kontak pengguna.
	User.Read	(Didelegasikan) Mengizinkan penyimpanan data membaca profil pengguna yang login.
Produktivitas file (Excel, Word, PowerPoint)	Files.Read.All	(Didelegasikan) Hanya memadai untuk alat yang membaca metadata file atau mendownload konten file: mencantumkan workbook Excel, membaca metadata workbook Excel, dan mengonversi dokumen Word (.docx) atau PowerPoint (.pptx) ke PDF. Membaca semua file yang dapat diakses pengguna, termasuk file yang disimpan di situs SharePoint yang dapat diakses pengguna. Tidak memadai untuk operasi konten workbook Excel (lihat baris berikutnya).
	Files.ReadWrite.All	(Didelegasikan) Diperlukan untuk semua operasi konten workbook Excel (baca dan tulis), termasuk mendapatkan worksheet, mendapatkan tabel, mendapatkan baris, mendapatkan baris, membuat worksheet dan tabel, menambahkan dan memperbarui baris, serta menambahkan kolom kunci. Sesuai dengan referensi API Microsoft Graph untuk endpoint ini (misalnya, worksheet-list, table-list, tablerow-list), izin yang didelegasikan yang diterima adalah Files.ReadWrite. Files.ReadWrite.All memberikan kemampuan yang sama di semua drive yang dapat diakses pengguna (OneDrive pribadi dan semua library dokumen SharePoint yang dapat diakses pengguna). Juga diperlukan untuk membuat dokumen Word dan PowerPoint di OneDrive pengguna.
	User.Read	(Didelegasikan) Diperlukan untuk menyelesaikan lokasi OneDrive pengguna yang login untuk operasi file.
Tasks (daftar tugas dan tugas Outlook)	Tasks.Read	(Didelegasikan) Diperlukan untuk operasi baca pada daftar tugas dan tugas Outlook pengguna yang login (daftar tugas, daftar tugas, dapatkan tugas).
	Tasks.ReadWrite	(Didelegasikan) Diperlukan untuk operasi tulis: membuat, memperbarui, dan menghapus tugas di daftar tugas Outlook pengguna yang login.
Pengguna dan direktori (pencacahan yang didelegasikan)	User.ReadBasic.All	(Didelegasikan) Diperlukan untuk alat yang menghitung atau mencari profil pengguna lain dalam organisasi (Dapatkan Pengguna, Cantumkan Pengguna, dan alat yang beroperasi di kotak surat atau kalender pengguna lain).

Catatan: Tindakan produktivitas file di atas mengharuskan admin tenant pengguna memberikan izin Microsoft Graph API yang sesuai pada pendaftaran aplikasi OAuth. Jika izin ini tidak diberikan, permintaan ke alat Excel, Word, dan PowerPoint akan gagal dengan error HTTP 403 accessDenied. Direkomendasikan: berikan Files.ReadWrite.All, yang mencakup setiap alat produktivitas file. Jika Anda hanya memerlukan konversi PDF Word atau PowerPoint dan listingan/metadata workbook Excel (tanpa akses sheet, tabel, atau baris), Files.Read.All saja sudah cukup. Untuk operasi berbasis driveItem (konversi PDF Word/PowerPoint, mencantumkan workbook Excel, membaca metadata workbook Excel), Microsoft Graph juga mendokumentasikan Sites.Read.All atau Sites.ReadWrite.All sebagai alternatif yang diterima (lihat driveItem-get dan driveItem-get-content-format). Lihat Mengonfigurasi Microsoft Outlook dan menetapkan izin yang diperlukan untuk mengetahui langkah-langkah penyiapan.

Catatan: Jika Tasks.Read atau Tasks.ReadWrite tidak ada, alat tugas Outlook akan gagal dengan HTTP 403 notAllowed. Tidak adanya User.ReadBasic.All (didelegasikan) menyebabkan alat pencarian pengguna gagal dengan HTTP 403 Authorization_RequestDenied. Tenant yang memerlukan akses pengguna dengan hak istimewa lebih tinggi dapat mengganti User.Read.All atau Directory.Read.All dengan User.ReadBasic.All.

Untuk mengetahui informasi tentang cara menambahkan izin untuk Microsoft Outlook, lihat Mengonfigurasi Microsoft Outlook dan menetapkan izin yang diperlukan.

Batas kapasitas untuk penyerapan data

Batas volume permintaan adalah 10.000 permintaan API per periode 10 menit. Batas kapasitas ini hanya berlaku untuk penyimpanan data Microsoft Outlook jika Anda memilih untuk menggunakan penyerapan sebagai mode koneksi.

Batasan

Bagian ini menguraikan masalah umum dan batasan yang dapat memengaruhi penggunaan penyimpanan data Microsoft Outlook.

• Saat membuat aplikasi baru atau menambahkan penyimpanan data ke aplikasi yang sudah ada, sebaiknya kaitkan hanya satu penyimpanan data dengan tindakan yang termasuk dalam satu jenis konektor.

• Penerapan perimeter Kontrol Layanan VPC pada penyimpanan data Microsoft Outlook yang ada tidak didukung. Untuk menerapkan Kontrol Layanan VPC, Anda harus menghapus dan membuat ulang penyimpanan data. Untuk mengetahui informasi selengkapnya tentang Kontrol Layanan VPC dan cara menggunakan tindakan setelah mengaktifkan Kontrol Layanan VPC, lihat Mengamankan aplikasi Anda dengan Kontrol Layanan VPC.

• Penyimpanan data Microsoft Outlook hanya didukung di lokasi global, us, dan eu.

• Penyimpanan data Microsoft Outlook dapat memproses satu transaksi per detik, per node, dan membatasi transaksi apa pun di luar batas ini.

• Kemampuan penyimpanan data Microsoft Outlook untuk mencoba ulang saat terjadi error batas kapasitas terlampaui bergantung pada penerimaan nilai retry-after dari Microsoft Graph API, yang hanya disediakan untuk penyimpanan data Outlook. Jumlah default upaya percobaan ulang adalah tiga.

• Throughput penyimpanan data Microsoft Outlook dibatasi oleh batasan panggilan API yang diberlakukan oleh Microsoft Graph. Batasan berlaku untuk setiap kombinasi ID aplikasi dan kotak surat—yaitu, aplikasi tertentu yang mengakses kotak surat pengguna atau grup tertentu. Melebihi batas untuk satu kotak surat tidak memengaruhi kemampuan aplikasi untuk mengakses kotak surat lain.

• Penyimpanan data Microsoft Outlook dipetakan satu per satu dengan satu ID Tenant Azure. Solusi ini tidak dapat mencakup beberapa tenant Microsoft 365 yang terisolasi dalam Organisasi Multi-Tenant (MTO). Anda harus membuat penyimpanan data khusus untuk setiap tenant yang berbeda.

• Kotak surat harus dimigrasikan sepenuhnya ke Exchange Online. Kotak surat yang dihosting secara lokal di lingkungan Hybrid Exchange tidak dapat diakses melalui Microsoft Graph API. Upaya untuk mengkueri kotak surat ini atau kotak surat lintas tenant dapat mengakibatkan error MailboxNotEnabledForRESTAPI.

• Penyimpanan data Microsoft Outlook dapat memproses satu transaksi per detik per node dan membatasi transaksi apa pun di luar batas ini.

Langkah berikutnya

• Untuk membuat dan mengonfigurasi penyimpanan data dengan Microsoft Outlook, lihat Menyiapkan penyimpanan data Microsoft Outlook.