Ringkasan

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

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.
Mendownload lampiran	Mendownload lampiran dari pesan email Microsoft Outlook.
Kirim email	Mengirim pesan email. Hal ini termasuk mengirim email dengan lampiran.
Perbarui kontak	Memperbarui kontak yang ada di Microsoft Outlook.
Perbarui acara	Memperbarui acara yang ada.
Membaca data Excel	Mencantumkan workbook, membaca lembar kerja, tabel, dan baris dari file Excel (.xlsx) yang disimpan di OneDrive atau SharePoint.
Mengedit data Excel	Menambahkan dan memperbarui baris, membuat lembar kerja dan tabel, serta menambahkan kolom utama 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 menjadi 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 menjadi PDF.

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	(Delegasi) 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 peristiwa semua kalender, kecuali untuk properti seperti tubuh, 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 serangkaian properti profil dasar pengguna lain di organisasi Anda.
Tindakan	Mail.Send	(Delegasi) Mengizinkan penyimpanan data mengirim email sebagai pengguna di organisasi.
	Calendars.ReadWrite	(Delegasi) Mengizinkan penyimpanan data membuat, membaca, memperbarui, dan menghapus acara di kalender pengguna.
	Contacts.ReadWrite	(Delegasi) Mengizinkan penyimpanan data untuk 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	(Delegasi) Hanya cukup untuk alat yang membaca metadata file atau mendownload konten file: mencantumkan buku kerja Excel, membaca metadata buku kerja 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 cukup untuk operasi konten buku kerja Excel (lihat baris berikutnya).
	Files.ReadWrite.All	(Delegasi) Diperlukan untuk semua operasi konten workbook Excel (baca dan tulis), termasuk mendapatkan lembar kerja, mendapatkan tabel, mendapatkan baris, mendapatkan baris, membuat lembar kerja dan tabel, menambahkan dan memperbarui baris, serta menambahkan kolom kunci. Sesuai referensi Microsoft Graph API 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	(Delegasi) Diperlukan untuk menyelesaikan lokasi OneDrive pengguna yang login untuk operasi file.
Tugas (Daftar tugas dan tugas Outlook)	Tasks.Read	(Delegasi) Diperlukan untuk operasi baca pada daftar tugas dan tugas Outlook pengguna yang login (mencantumkan daftar tugas, mencantumkan tugas, mendapatkan 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 mencantumkan 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 accessDenied HTTP 403. Direkomendasikan: berikan Files.ReadWrite.All, yang mencakup setiap alat produktivitas file. Jika Anda hanya memerlukan konversi PDF Word atau PowerPoint dan pencantuman/metadata workbook Excel (tanpa akses lembar kerja, tabel, atau baris), Files.Read.All saja sudah cukup. Untuk operasi berbasis driveItem (konversi PDF Word/PowerPoint, mencantumkan buku kerja Excel, membaca metadata buku kerja Excel), Microsoft Graph juga mendokumentasikan Sites.Read.All atau Sites.ReadWrite.All sebagai alternatif yang dapat diterima (lihat driveItem-get dan driveItem-get-content-format). Lihat Mengonfigurasi Microsoft Outlook dan menetapkan izin yang diperlukan untuk mengetahui langkah-langkah penyiapan.

Catatan: Tasks.Read atau Tasks.ReadWrite yang tidak ada menyebabkan alat tugas Outlook gagal dengan notAllowed HTTP 403. Tidak adanya User.ReadBasic.All (yang didelegasikan) menyebabkan alat pencarian pengguna gagal dengan HTTP 403 Authorization_RequestDenied. Tenant yang memerlukan akses pengguna dengan hak istimewa yang 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 frekuensi ini berlaku secara eksklusif untuk penyimpanan data Microsoft Outlook saat Anda memilih menggunakan penyerapan sebagai mode koneksi.

Batasan

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

• Saat membuat aplikasi baru atau menambahkan penyimpanan data ke aplikasi yang sudah ada, sebaiknya hanya kaitkan 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 yang melebihi batas ini.

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

• Throughput penyimpanan data Microsoft Outlook dibatasi oleh batasan panggilan API yang diterapkan oleh Microsoft Graph. Batas 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-ke-satu dengan satu ID Tenant Azure. Fitur 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 membuat kueri kotak surat lintas tenant atau kotak surat ini dapat menyebabkan error MailboxNotEnabledForRESTAPI.

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

Langkah berikutnya

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