Ringkasan

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.All
User.ReadBasic.All
Membuat daftar pemilik grup Hanya baca Mencantumkan pemilik grup dalam direktori. GroupMember.Read.All
User.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.All
Files.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.All
Files.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.ReadWrite
Calendars.ReadWrite
Buat kalender Tulis Membuat kalender baru di kotak surat pengguna. Calendars.ReadWrite
Calendars.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.ReadWrite
Mail.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.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
Mencantumkan saluran Hanya baca Mencantumkan saluran di Microsoft Team. Channel.ReadBasic.All
Group.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.Read
ChannelMessage.Read.All
Group.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.Read
ChannelMessage.Read.All
Group.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, dan eu.

  • 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