Konektor Microsoft 365 untuk Gemini Enterprise memungkinkan Anda menelusuri dan menindaklanjuti data di seluruh Microsoft 365 dari satu konektor: situs SharePoint, file OneDrive, email Outlook, kalender Outlook, kontak, dan Microsoft Teams. Konektor menjangkau semua platform ini melalui Microsoft Graph API.
Karena satu konektor mencakup setiap platform Microsoft 365, Anda tidak perlu membuat penyimpanan data terpisah untuk SharePoint, OneDrive, Outlook, dan Teams.
Konektor ini mendukung dua metode autentikasi OAuth 2.0:
- OAuth yang dikelolaGoogle(default): Konektor menggunakan aplikasi Microsoft Entra yang dikelola oleh Google . Anda tidak mendaftarkan aplikasi Anda sendiri atau memberikan client ID dan rahasia klien.
- Menggunakan aplikasi Anda sendiri: Daftarkan aplikasi Microsoft Entra Anda sendiri, dan berikan ID tenant, client ID, dan rahasia kliennya saat Anda menyiapkan penyimpanan data.
Untuk mengetahui informasi selengkapnya, lihat Konfigurasi Microsoft 365.
Tindakan yang didukung
Jika konektor Microsoft 365 diaktifkan, pengguna akhir dapat menggunakan perintah bahasa alami di Gemini Enterprise untuk melakukan tindakan berikut. Tindakan dikelompokkan menurut produk Microsoft 365 yang terpengaruh, yang sesuai dengan pengelompokannya saat Anda memilih tindakan di konsolGoogle Cloud . Untuk setiap tindakan, tabel menunjukkan apakah tindakan tersebut hanya membaca data atau juga melakukan perubahan, dan izin Microsoft Graph yang didelegasikan yang diperlukan. Untuk mengetahui cara izin diminta dan diberikan, lihat Izin.
Pengguna dan grup
| Tindakan | Jenis | Deskripsi | Izin yang diperlukan |
|---|---|---|---|
| Menambahkan anggota grup | Tulis | Menambahkan pengguna sebagai anggota grup. | GroupMember.ReadWrite.All |
| Menambahkan pemilik grup | Tulis | Menambahkan pengguna sebagai pemilik grup. | Group.ReadWrite.All |
| Buat grup | Tulis | Membuat grup Microsoft 365 baru. | Group.ReadWrite.All |
| Dapatkan profil saya | Hanya baca | Mengambil profil pengguna yang login, termasuk alamat email yang digunakan untuk akun Microsoft-nya. | User.Read |
| Mendapatkan profil pengguna | Hanya baca | Mengambil profil pengguna di direktori. | User.ReadBasic.All |
| Mendapatkan profil kerja pengguna | Hanya baca | Mengambil jabatan, departemen, kantor, nomor telepon, pengelola, dan bawahan langsung pengguna. | User.Read.All |
| Membuat daftar anggota grup | Hanya baca | Mencantumkan anggota langsung grup dalam direktori. | Group.ReadBasic.AllUser.ReadBasic.All |
| Membuat daftar pemilik grup | Hanya baca | Mencantumkan pemilik grup dalam direktori. | GroupMember.Read.AllUser.ReadBasic.All |
| Membuat daftar grup | Hanya baca | Menemukan grup di direktori berdasarkan nama dan menampilkan ID setiap grup. | Group.ReadBasic.All |
| Menemukan orang di direktori | Hanya baca | Menemukan orang di direktori organisasi berdasarkan nama atau alamat email. | User.ReadBasic.All |
| Mengupdate grup | Tulis | Memperbarui nama, deskripsi, atau visibilitas grup. | Group.ReadWrite.All |
SharePoint dan OneDrive
| Tindakan | Jenis | Deskripsi | Izin yang diperlukan |
|---|---|---|---|
| Mendapatkan rentang Excel | Hanya baca | Membaca nilai sel dalam blok sel di sheet, termasuk sel di luar tabel. | Files.Read.All |
| Mendapatkan baris tabel Excel | Hanya baca | Membaca satu baris tabel di workbook Excel, dengan header kolom tabel. | Files.Read.All |
| Mendapatkan baris tabel Excel | Hanya baca | Membaca baris data tabel di workbook Excel, dengan header kolom tabel. | Files.Read.All |
| Mencantumkan tabel Excel | Hanya baca | Mencantumkan tabel yang diformat dalam workbook Excel dan lembar kerja tempat setiap tabel berada. | Files.Read.All |
| Mendapatkan properti workbook Excel | Hanya baca | Membaca properti file buku kerja Excel: nama, ukuran, URL, dan orang yang terakhir mengubahnya. | Files.Read.All |
| Mendapatkan lembar kerja Excel | Hanya baca | Membaca satu lembar kerja workbook Excel dan cakupan data di dalamnya. | Files.Read.All |
| Menampilkan daftar lembar kerja Excel | Hanya baca | Mencantumkan lembar kerja di workbook Excel, dalam urutan tab. | Files.Read.All |
| Menampilkan daftar workbook Excel | Hanya baca | Menemukan workbook Excel di situs OneDrive dan SharePoint yang dapat diakses pengguna. | Sites.Read.AllFiles.Read.All |
| Check in dokumen | Tulis | Melakukan check in dokumen, melepaskan kunci editnya, dan membuatnya tersedia untuk orang lain. | Files.ReadWrite.All |
| Check out dokumen | Tulis | Melakukan check out dokumen, menguncinya untuk pengeditan eksklusif. | Files.ReadWrite.All |
| Salin file | Tulis | Menyalin file ke lokasi baru. | Files.ReadWrite.All |
| Salin folder | Tulis | Menyalin folder ke lokasi baru. | Files.ReadWrite.All |
| Buat file | Tulis | Membuat file baru dengan nama tertentu di dalam folder. Jangan pernah menimpa file yang ada; gunakan Ganti konten file untuk melakukannya. | Files.ReadWrite.All |
| Buat folder | Tulis | Membuat folder baru di dalam folder yang sudah ada. | Files.ReadWrite.All |
| Buat link berbagi | Tulis | Membuat link yang dapat dibagikan ke file atau folder. | Files.ReadWrite.All |
| Hapus checkout | Tulis | Membatalkan check-out dokumen dan menghapus perubahan yang tertunda. | Files.ReadWrite.All |
| Mendapatkan file atau folder berdasarkan URL | Hanya baca | Menemukan file atau folder yang ditunjuk oleh link SharePoint atau OneDrive, sehingga dapat dibaca atau ditindaklanjuti. | Files.Read.All |
| Mendownload konten file | Hanya baca | Mendownload konten mentah file yang disimpan di drive. | Files.Read.All |
| Dapatkan OneDrive saya | Hanya baca | Mendapatkan OneDrive milik pengguna yang login, sehingga file dapat disimpan atau dicantumkan di tingkat teratasnya, dan melaporkan kuota penyimpanannya. | Files.Read.All |
| Mencantumkan konten folder | Hanya baca | Mencantumkan file dan folder di dalam folder di drive. | Files.Read.All |
| Mencantumkan izin file | Hanya baca | Mencantumkan izin berbagi yang ditetapkan pada file atau folder. | Files.Read.All |
| Pindahkan file | Tulis | Memindahkan file ke folder lain. | Files.ReadWrite.All |
| Memindahkan folder | Tulis | Memindahkan folder ke folder induk lain. | Files.ReadWrite.All |
| Ganti nama file | Tulis | Mengganti nama file. | Files.ReadWrite.All |
| Ganti nama folder | Tulis | Mengganti nama folder. | Files.ReadWrite.All |
| Mengganti konten file | Tulis | Mengganti seluruh konten file yang sudah ada. Untuk membuat file baru, gunakan Buat file. | Files.ReadWrite.All |
| Mengirim undangan berbagi | Tulis | Mengirim undangan berbagi untuk file atau folder. | Files.ReadWrite.All |
| Memperbarui properti file atau folder | Tulis | Memperbarui properti file atau folder (nama, deskripsi, folder induk). | Files.ReadWrite.All |
| Membuat daftar SharePoint | Tulis | Membuat daftar baru di situs SharePoint. | Sites.Manage.All |
| Membuat item daftar | Tulis | Membuat item baru di daftar SharePoint. | Sites.ReadWrite.All |
| Membuat halaman SharePoint | Tulis | Membuat halaman baru di situs SharePoint. | Sites.ReadWrite.All |
| Mendapatkan item daftar | Hanya baca | Mengambil satu baris daftar SharePoint, beserta nilai kolomnya. | Sites.Read.All |
| Mendapatkan konten halaman SharePoint | Hanya baca | Mengambil isi HTML halaman SharePoint. | Sites.Read.All |
| Mencantumkan item daftar | Hanya baca | Membaca baris daftar SharePoint, dengan nilai kolom setiap baris. | Sites.Read.All |
| Mencantumkan daftar SharePoint | Hanya baca | Mencantumkan daftar SharePoint di situs, termasuk ID dan template setiap daftar. | Sites.Read.All |
| Mencantumkan halaman SharePoint | Hanya baca | Mencantumkan halaman di situs SharePoint, dengan judul, URL, dan status publikasi setiap halaman. | Sites.Read.All |
| Menelusuri SharePoint dan OneDrive | Hanya baca | Menelusuri situs, halaman, item daftar SharePoint, dan file OneDrive yang dapat diakses pengguna. | Sites.Read.AllFiles.Read.All |
| Memperbarui daftar SharePoint | Tulis | Memperbarui properti daftar SharePoint (nama, deskripsi). | Sites.Manage.All |
| Memperbarui item daftar | Tulis | Memperbarui kolom pada item daftar SharePoint yang ada. | Sites.ReadWrite.All |
| Memperbarui halaman SharePoint | Tulis | Memperbarui judul atau nama file halaman SharePoint. | Sites.ReadWrite.All |
Outlook
| Tindakan | Jenis | Deskripsi | Izin yang diperlukan |
|---|---|---|---|
| Tambahkan lampiran | Tulis | Menambahkan lampiran file ke pesan email atau acara kalender yang ada. | Mail.ReadWriteCalendars.ReadWrite |
| Buat kalender | Tulis | Membuat kalender baru di kotak surat pengguna. | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Buat kontak | Tulis | Membuat kontak baru di folder Kontak pengguna. | Contacts.ReadWrite |
| Membuat draf pesan | Tulis | Membuat draf pesan email di kotak surat pengguna. | Mail.ReadWriteMail.ReadWrite.Shared |
| Buat acara kalender | Tulis | Membuat acara baru di kalender pengguna. | Calendars.ReadWrite |
| Buat draf balasan | Tulis | Membuat draf balasan untuk pengirim pesan email yang ada. | Mail.ReadWriteMail.ReadWrite.Shared |
| Menemukan waktu rapat | Hanya baca | Menyarankan waktu rapat berdasarkan ketersediaan peserta. | Calendars.Read.Shared |
| Teruskan pesan | Tulis | Meneruskan pesan email yang ada ke penerima yang ditentukan. | Mail.Send |
| Mendapatkan lampiran pesan email | Hanya baca | Mengambil byte dari satu lampiran file dari pesan di kotak surat pengguna. | Mail.Read |
| Mendapatkan balasan otomatis | Hanya baca | Mengambil setelan balasan otomatis (di luar kantor) Outlook pengguna. | MailboxSettings.Read |
| Mendapatkan acara kalender | Hanya baca | Mengambil satu acara dari kalender Outlook pengguna, termasuk respons tamu dan ID lampiran. | Calendars.Read |
| Mendapatkan lampiran acara kalender | Hanya baca | Mengambil byte dari satu lampiran file dari acara di kalender pengguna. | Calendars.Read |
| Mendapatkan pesan email | Hanya baca | Mengambil satu pesan dari kotak surat pengguna. | Mail.Read |
| Mendapatkan ketersediaan jadwal | Hanya baca | Mengambil ketersediaan senggang/sibuk untuk pengguna, ruang, atau peralatan selama rentang waktu tertentu. | Calendars.Read |
| Menampilkan daftar acara kalender | Hanya baca | Mencantumkan acara di kalender pengguna selama rentang waktu tertentu. | Calendars.Read |
| Menampilkan daftar kalender | Hanya baca | Mencantumkan kalender di kotak surat pengguna. | Calendars.Read |
| Mencantumkan kategori Outlook | Hanya baca | Mencantumkan kategori (label) dalam daftar kategori Outlook pengguna. | MailboxSettings.Read |
| Mencantumkan kontak | Hanya baca | Mencantumkan atau menelusuri kontak di buku alamat Outlook pengguna. | Contacts.Read |
| Mencantumkan aturan kotak masuk | Hanya baca | Mencantumkan aturan kotak masuk Outlook pengguna. | MailboxSettings.Read |
| Membuat daftar folder email | Hanya baca | Mencantumkan folder email di kotak surat pengguna. | Mail.ReadBasic |
| Mencantumkan pesan dalam folder | Hanya baca | Mencantumkan pesan di salah satu folder email pengguna, seperti kotak masuk atau item terkirim. | Mail.Read |
| Mencantumkan atau menelusuri kotak surat bersama | Hanya baca | Mencantumkan atau menelusuri pesan di kotak surat bersama atau yang didelegasikan yang dapat diakses pengguna. | Mail.Read.Shared |
| Pindahkan pesan | Tulis | Memindahkan pesan email ke folder email lain. | Mail.ReadWrite |
| Membalas pesan ke semua penerima | Tulis | Membalas pesan email yang ada, kepada pengirimnya dan semua penerima lainnya, dengan mempertahankan balasan dalam percakapan asli. | Mail.Send |
| Balas pesan | Tulis | Membalas pesan email yang ada, kepada pengirimnya, dengan menyimpan balasan dalam percakapan asli. | Mail.Send |
| RSVP ke acara | Tulis | Merespons undangan rapat (menerima, menerima untuk sementara, atau menolak). | Calendars.ReadWrite |
| Menelusuri email | Hanya baca | Menelusuri email Outlook pengguna berdasarkan kata kunci. | Mail.Read |
| Menelusuri email dalam folder | Hanya baca | Menelusuri pesan di salah satu folder email pengguna, termasuk subfolder seperti Kotak Masuk/Invoice, berdasarkan kata kunci, pengirim, atau subjek. | Mail.Read |
| Telusuri acara kalender | Hanya baca | Menelusuri acara kalender Outlook pengguna berdasarkan kata kunci. | Calendars.Read |
| Kirim draf pesan | Tulis | Mengirim pesan email draf yang ada. | Mail.Send |
| Kirim email | Tulis | Menulis dan mengirim pesan email baru. | Mail.Send |
| Perbarui kalender | Tulis | Memperbarui properti kalender yang ada (nama, warna, atau status default). | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Perbarui kontak | Tulis | Memperbarui properti kontak yang ada. | Contacts.ReadWrite |
| Perbarui acara | Tulis | Memperbarui properti acara kalender yang ada. | Calendars.ReadWrite |
| Perbarui pesan | Tulis | Memperbarui properti pesan email yang ada (misalnya, menandai sebagai telah dibaca, mengubah tanda, atau tingkat kepentingan). | Mail.ReadWrite |
| Membuat daftar tugas | Hanya baca | Mencantumkan daftar tugas Microsoft To Do (Outlook Tasks) pengguna. | Tasks.Read |
| Membuat daftar tugas | Hanya baca | Mencantumkan tugas di salah satu daftar Microsoft To Do (Outlook Tasks) pengguna. | Tasks.Read |
Tim
| Tindakan | Jenis | Deskripsi | Izin yang diperlukan |
|---|---|---|---|
| Menambahkan anggota ke saluran | Tulis | Menambahkan pengguna ke saluran Teams pribadi atau bersama. | ChannelMember.ReadWrite.All |
| Buat channel | Tulis | Membuat saluran baru dalam tim Teams. | Channel.Create |
| Buat chat | Tulis | Membuat chat Teams baru (chat pribadi, grup, atau rapat). | Chat.Create |
| Buat rapat | Tulis | Membuat rapat online Teams baru. | OnlineMeetings.ReadWrite |
| Membuat grup penjadwalan | Tulis | Membuat grup penjadwalan dalam jadwal Teams. | Schedule.ReadWrite.All |
| Membuat entri waktu nonaktif | Tulis | Membuat entri cuti untuk pengguna dalam jadwal Teams. | Schedule.ReadWrite.All |
| Membuat alasan cuti | Tulis | Membuat alasan waktu nonaktif baru (misalnya, Liburan, Cuti Sakit) untuk jadwal Tim. | Schedule.ReadWrite.All |
| Mendapatkan jadwal | Hanya baca | Membaca setelan jadwal Shift dan status penyediaan tim. | Schedule.Read.All |
| Mencantumkan pelanggan channel | Hanya baca | Mencantumkan anggota saluran Teams dan perannya. | ChannelMember.Read.All |
| Mencantumkan pesan channel | Hanya baca | Mencantumkan pesan di saluran Teams. | ChannelMessage.Read.AllGroup.ReadBasic.All |
| Mencantumkan saluran | Hanya baca | Mencantumkan saluran di Microsoft Team. | Channel.ReadBasic.AllGroup.ReadBasic.All |
| Mencantumkan pesan chat | Hanya baca | Mencantumkan pesan dalam chat Teams. | Chat.Read |
| Mencantumkan chat | Hanya baca | Mencantumkan chat Teams yang diikuti pengguna. | Chat.ReadBasic |
| Menampilkan daftar tim yang diikuti | Hanya baca | Mencantumkan Microsoft Teams tempat pengguna menjadi anggota. | Team.ReadBasic.All |
| Mencantumkan balasan pesan saluran | Hanya baca | Membaca rangkaian pesan di saluran Teams: postingan pertamanya dan balasan di bawahnya. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Membuat daftar grup penjadwalan | Hanya baca | Mencantumkan grup penjadwalan dalam jadwal Shift tim. | Schedule.Read.All |
| Mencantumkan entri waktu nonaktif | Hanya baca | Mencantumkan waktu cuti yang dipesan di jadwal Shift tim. | Schedule.Read.All |
| Mencantumkan alasan cuti | Hanya baca | Mencantumkan alasan cuti yang dapat dipilih di jadwal Shift tim. | Schedule.Read.All |
| Membalas pesan saluran | Tulis | Membalas pesan di saluran Teams. | ChannelMessage.Send |
| Menelusuri pesan chat | Hanya baca | Menelusuri pesan chat dan saluran Teams yang dapat diakses pengguna. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Mengirim pesan saluran | Tulis | Memposting pesan di saluran Teams. | ChannelMessage.Send |
| Kirim pesan chat | Tulis | Mengirim pesan di chat Teams. | ChatMessage.Send |
| Saluran update | Tulis | Memperbarui nama atau deskripsi saluran Teams. | ChannelSettings.ReadWrite.All |
| Memperbarui pesan channel | Tulis | Mengedit pesan channel yang diposting sebelumnya. | ChannelMessage.ReadWrite |
| Memperbarui chat | Tulis | Memperbarui topik chat grup Teams. | Chat.ReadWrite |
| Memperbarui pesan chat | Tulis | Mengedit pesan chat yang dikirim sebelumnya. | Chat.ReadWrite |
| Memperbarui grup penjadwalan | Tulis | Memperbarui nama, status aktif, atau anggota grup penjadwalan. | Schedule.ReadWrite.All |
| Perbarui tim | Tulis | Memperbarui nama, deskripsi, atau visibilitas tim Teams. | TeamSettings.ReadWrite.All |
| Memperbarui entri waktu nonaktif | Tulis | Memperbarui entri waktu nonaktif yang ada. | Schedule.ReadWrite.All |
Izin
Kolom Izin yang diperlukan dalam tabel sebelumnya mencantumkan izin Microsoft Graph yang didelegasikan yang diperlukan setiap tindakan. Gemini Enterprise hanya meminta izin untuk tindakan yang Anda aktifkan, ditambah izin berikut, yang diminta oleh setiap koneksi:
User.Read: membaca profil pengguna yang login, yang mengidentifikasi akun yang diwakili oleh konektor.offline_access: memungkinkan konektor memperbarui token aksesnya tanpa meminta pengguna untuk login lagi.
Semua izin didelegasikan: konektor bertindak sebagai pengguna yang login dan hanya dapat menjangkau data yang sudah dapat dijangkau pengguna tersebut.
Dengan OAuth yang dikelola Google, pengguna menyetujui izin ini saat mereka mengizinkan konektor; beberapa izin memerlukan administrator Microsoft Entra untuk memberikan izin bagi organisasi. Dengan aplikasi Anda sendiri, Anda memberikan izin ini pada pendaftaran aplikasi. Untuk mengetahui detailnya, lihat Mengonfigurasi izin Microsoft API.
Batasan
Bagian ini menguraikan masalah umum dan batasan yang dapat memengaruhi penggunaan penyimpanan data Microsoft 365.
- 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 365 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 365 hanya didukung di lokasi
global,us, daneu.
Penyimpanan data Microsoft 365 dipetakan satu per satu dengan satu tenant Microsoft 365. Fitur ini tidak dapat mencakup beberapa tenant yang terisolasi dalam Organisasi Multi-Tenant (MTO). Anda harus membuat penyimpanan data khusus untuk setiap tenant yang berbeda.
OAuth yang dikelolaGooglehanya mendukung tenant di cloud Microsoft komersial (termasuk GCC), dan tidak mendukung egress IP statis. Untuk tenant GCC High atau DoD, atau untuk menggunakan egress IP statis, gunakan aplikasi Microsoft Entra Anda sendiri.
Kotak surat harus dimigrasikan sepenuhnya ke Exchange Online. Kotak surat yang dihosting secara lokal di lingkungan Exchange hybrid tidak dapat diakses melalui Microsoft Graph API, dan kueri terhadap kotak surat tersebut dapat menampilkan error
MailboxNotEnabledForRESTAPI.
Langkah berikutnya
Untuk membuat dan mengonfigurasi penyimpanan data dengan Microsoft 365, lihat Menyiapkan penyimpanan data Microsoft 365.
Untuk mengonfigurasi aplikasi Microsoft Entra yang digunakan konektor untuk melakukan autentikasi, lihat Konfigurasi Microsoft 365.
Untuk melihat dan mengelola tindakan yang diaktifkan, lihat Mengelola tindakan.