개요

Gemini Enterprise용 Microsoft 365 커넥터를 사용하면 SharePoint 사이트, OneDrive 파일, Outlook 메일, Outlook 캘린더, 연락처, Microsoft Teams 등 Microsoft 365 전반의 데이터를 단일 커넥터에서 검색하고 조치를 취할 수 있습니다. 커넥터는 Microsoft Graph API를 통해 이러한 모든 표시 경로에 도달합니다.

하나의 커넥터가 모든 Microsoft 365 노출 영역을 처리하므로 SharePoint, OneDrive, Outlook, Teams에 대해 별도의 데이터 스토어를 만들 필요가 없습니다.

커넥터는 두 가지 OAuth 2.0 인증 방법을 지원합니다.

  • Google관리형 OAuth(기본값): 커넥터는 Google 에서 관리하는 Microsoft Entra 애플리케이션을 사용합니다. 자체 애플리케이션을 등록하거나 클라이언트 ID 및 클라이언트 보안 비밀번호를 제공하지 않습니다.
  • 자체 앱 사용: 자체 Microsoft Entra 애플리케이션을 등록하고 데이터 스토어를 설정할 때 테넌트 ID, 클라이언트 ID, 클라이언트 보안 비밀번호를 제공합니다.

자세한 내용은 Microsoft 365 구성을 참조하세요.

지원되는 작업

Microsoft 365 커넥터를 사용 설정하면 최종 사용자가 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 수행할 수 있습니다. 작업은 작업이 수행되는 Microsoft 365 제품별로 그룹화되며, 이는Google Cloud 콘솔에서 작업을 선택할 때 그룹화되는 방식과 일치합니다. 각 작업에 대해 표에는 데이터를 읽기만 하는지 또는 변경하는지 여부와 필요한 위임된 Microsoft Graph 권한이 표시됩니다. 권한이 요청되고 부여되는 방식은 권한을 참고하세요.

사용자 및 그룹

작업 유형 설명 필수 권한
그룹 구성원 추가 쓰기 사용자를 그룹의 구성원으로 추가합니다. GroupMember.ReadWrite.All
그룹 소유자 추가 쓰기 사용자를 그룹의 소유자로 추가합니다. Group.ReadWrite.All
그룹 만들기 쓰기 새 Microsoft 365 그룹을 만듭니다. Group.ReadWrite.All
내 프로필 가져오기 읽기 전용 Microsoft 계정의 키가 되는 이메일 주소를 포함하여 로그인한 사용자의 프로필을 가져옵니다. User.Read
사용자 프로필 가져오기 읽기 전용 디렉터리에서 사용자의 프로필을 가져옵니다. User.ReadBasic.All
사용자 직장 프로필 가져오기 읽기 전용 사용자의 직책, 부서, 사무실, 전화번호, 관리자, 직속 부하 직원을 가져옵니다. User.Read.All
그룹 구성원 나열 읽기 전용 디렉터리에 있는 그룹의 직접 구성원을 나열합니다. Group.ReadBasic.All
User.ReadBasic.All
그룹 소유자 나열 읽기 전용 디렉터리에 있는 그룹의 소유자를 나열합니다. GroupMember.Read.All
User.ReadBasic.All
그룹 나열 읽기 전용 디렉터리에서 이름으로 그룹을 찾고 각 그룹의 ID를 반환합니다. Group.ReadBasic.All
디렉터리에서 사용자 찾기 읽기 전용 이름 또는 이메일 주소로 조직 디렉터리에서 사용자를 찾습니다. User.ReadBasic.All
그룹 업데이트 쓰기 그룹의 이름, 설명 또는 공개 상태를 업데이트합니다. Group.ReadWrite.All

SharePoint 및 OneDrive

작업 유형 설명 필수 권한
Excel 범위 가져오기 읽기 전용 표 외부의 셀을 포함하여 워크시트의 셀 블록에 있는 셀 값을 읽습니다. Files.Read.All
Excel 표 행 가져오기 읽기 전용 Excel 통합 문서에서 테이블의 열 헤더와 함께 테이블의 한 행을 읽습니다. Files.Read.All
Excel 표 행 가져오기 읽기 전용 Excel 통합 문서에서 테이블의 데이터 행을 테이블의 열 헤더와 함께 읽습니다. Files.Read.All
Excel 표 나열 읽기 전용 Excel 통합 문서의 형식 지정된 표와 각 표가 있는 워크시트를 나열합니다. Files.Read.All
Excel 통합 문서 속성 가져오기 읽기 전용 Excel 통합 문서의 파일 속성(이름, 크기, URL, 마지막으로 변경한 사용자)을 읽습니다. Files.Read.All
Excel 워크시트 가져오기 읽기 전용 Excel 통합 문서의 워크시트 하나와 해당 워크시트의 데이터 범위를 읽습니다. Files.Read.All
Excel 워크시트 나열 읽기 전용 Excel 통합 문서의 워크시트를 탭 순서대로 나열합니다. Files.Read.All
Excel 통합 문서 나열 읽기 전용 사용자가 액세스할 수 있는 OneDrive 및 SharePoint 사이트에서 Excel 통합 문서를 찾습니다. Sites.Read.All
Files.Read.All
문서 체크인 쓰기 문서를 체크인하여 수정 잠금을 해제하고 다른 사용자가 사용할 수 있도록 합니다. Files.ReadWrite.All
문서 확인 쓰기 문서를 체크아웃하여 단독 편집을 위해 잠급니다. Files.ReadWrite.All
파일 복사 쓰기 파일을 새 위치에 복사합니다. Files.ReadWrite.All
폴더 복사 쓰기 폴더를 새 위치에 복사합니다. Files.ReadWrite.All
파일 만들기 쓰기 폴더 내에 지정된 이름으로 새 파일을 만듭니다. 기존 파일을 덮어쓰지 않습니다. 이 경우 파일 콘텐츠 바꾸기를 사용합니다. Files.ReadWrite.All
폴더 만들기 쓰기 기존 폴더 내에 새 폴더를 만듭니다. Files.ReadWrite.All
공유 링크 만들기 쓰기 파일 또는 폴더에 대한 공유 가능한 링크를 만듭니다. Files.ReadWrite.All
결제 취소 쓰기 문서 체크아웃을 취소하고 대기 중인 변경사항을 삭제합니다. Files.ReadWrite.All
URL로 파일 또는 폴더 가져오기 읽기 전용 SharePoint 또는 OneDrive 링크가 가리키는 파일 또는 폴더를 찾아 읽거나 작업을 수행할 수 있습니다. Files.Read.All
파일 콘텐츠 다운로드 읽기 전용 드라이브에 저장된 파일의 원시 콘텐츠를 다운로드합니다. Files.Read.All
내 OneDrive 가져오기 읽기 전용 로그인한 사용자의 OneDrive를 가져와 최상위 수준에 파일을 저장하거나 나열하고 스토리지 한도를 보고합니다. Files.Read.All
폴더 내용 보기 읽기 전용 드라이브의 폴더 내에 있는 파일 및 폴더를 나열합니다. Files.Read.All
파일 권한 나열 읽기 전용 파일 또는 폴더에 설정된 공유 권한을 나열합니다. Files.Read.All
파일 이동 쓰기 파일을 다른 폴더로 이동합니다. Files.ReadWrite.All
폴더 이동 쓰기 폴더를 다른 상위 폴더로 이동합니다. Files.ReadWrite.All
파일 이름 변경 쓰기 파일 이름을 바꿉니다. Files.ReadWrite.All
폴더 이름 바꾸기 쓰기 폴더 이름을 바꿉니다. Files.ReadWrite.All
파일 콘텐츠 바꾸기 쓰기 이미 존재하는 파일의 전체 콘텐츠를 대체합니다. 새 파일을 만들려면 파일 만들기를 사용합니다. Files.ReadWrite.All
공유 초대 보내기 쓰기 파일 또는 폴더의 공유 초대를 전송합니다. Files.ReadWrite.All
파일 또는 폴더 속성 업데이트 쓰기 파일 또는 폴더의 속성(이름, 설명, 상위 폴더)을 업데이트합니다. Files.ReadWrite.All
SharePoint 목록 만들기 쓰기 SharePoint 사이트에 새 목록을 만듭니다. Sites.Manage.All
목록 항목 만들기 쓰기 SharePoint 목록에 새 항목을 만듭니다. Sites.ReadWrite.All
SharePoint 페이지 만들기 쓰기 SharePoint 사이트에 새 페이지를 만듭니다. Sites.ReadWrite.All
목록 항목 가져오기 읽기 전용 SharePoint 목록의 단일 행을 열 값과 함께 가져옵니다. Sites.Read.All
SharePoint 페이지 콘텐츠 가져오기 읽기 전용 SharePoint 페이지의 HTML 본문을 가져옵니다. Sites.Read.All
목록 항목 나열 읽기 전용 각 행의 열 값과 함께 SharePoint 목록의 행을 읽습니다. Sites.Read.All
SharePoint 목록 나열 읽기 전용 각 목록의 ID 및 템플릿을 포함하여 사이트의 SharePoint 목록을 나열합니다. Sites.Read.All
SharePoint 페이지 나열 읽기 전용 SharePoint 사이트의 페이지를 각 페이지의 제목, URL, 게시 상태와 함께 나열합니다. Sites.Read.All
SharePoint 및 OneDrive 검색 읽기 전용 사용자가 액세스할 수 있는 SharePoint 사이트, 페이지, 목록 항목, OneDrive 파일을 검색합니다. Sites.Read.All
Files.Read.All
SharePoint 목록 업데이트 쓰기 SharePoint 목록의 속성(이름, 설명)을 업데이트합니다. Sites.Manage.All
목록 항목 업데이트 쓰기 기존 SharePoint 목록 항목의 필드를 업데이트합니다. Sites.ReadWrite.All
SharePoint 페이지 업데이트 쓰기 SharePoint 페이지의 제목 또는 파일 이름을 업데이트합니다. Sites.ReadWrite.All

Outlook

작업 유형 설명 필수 권한
연결 추가 쓰기 기존 이메일 메시지 또는 캘린더 일정에 파일 첨부파일을 추가합니다. Mail.ReadWrite
Calendars.ReadWrite
캘린더 만들기 쓰기 사용자의 편지함에 새 캘린더를 만듭니다. Calendars.ReadWrite
Calendars.ReadWrite.Shared
연락처 만들기 쓰기 사용자의 연락처 폴더에 새 연락처를 만듭니다. Contacts.ReadWrite
초안 메시지 만들기 쓰기 사용자의 편지함에 이메일 메시지 초안을 만듭니다. Mail.ReadWrite
Mail.ReadWrite.Shared
캘린더 일정 만들기 쓰기 사용자의 캘린더에 새 일정을 만듭니다. Calendars.ReadWrite
답장 초안 만들기 쓰기 기존 이메일 메시지의 발신자에게 보낼 답장 초안을 만듭니다. Mail.ReadWrite
Mail.ReadWrite.Shared
회의 시간 찾기 읽기 전용 참석자의 참석 가능 여부에 따라 회의 시간을 제안합니다. Calendars.Read.Shared
메시지 전달 쓰기 기존 이메일 메시지를 지정된 수신자에게 전달합니다. Mail.Send
이메일 메시지 첨부파일 가져오기 읽기 전용 사용자의 편지함에 있는 메일에서 파일 첨부파일 1개의 바이트를 가져옵니다. Mail.Read
자동 답장 받기 읽기 전용 사용자의 Outlook 자동 답장(부재중) 설정을 가져옵니다. MailboxSettings.Read
캘린더 일정 가져오기 읽기 전용 참석자 응답 및 첨부파일 ID를 포함하여 사용자의 Outlook 캘린더에서 일정 하나를 가져옵니다. Calendars.Read
캘린더 일정 첨부파일 가져오기 읽기 전용 사용자 캘린더의 일정에서 파일 첨부파일 1개의 바이트를 가져옵니다. Calendars.Read
이메일 메시지 가져오기 읽기 전용 사용자의 편지함에서 단일 메일을 가져옵니다. Mail.Read
일정 예약 가능 여부 가져오기 읽기 전용 특정 기간 동안 사용자, 회의실 또는 장비의 한가함/바쁨 상태를 가져옵니다. Calendars.Read
캘린더 일정 나열 읽기 전용 특정 기간 동안 사용자의 캘린더에 있는 일정을 나열합니다. Calendars.Read
캘린더 나열 읽기 전용 사용자의 편지함에 있는 캘린더를 나열합니다. Calendars.Read
Outlook 카테고리 나열 읽기 전용 사용자의 Outlook 카테고리 목록에 있는 카테고리(라벨)를 나열합니다. MailboxSettings.Read
연락처 나열 읽기 전용 사용자의 Outlook 주소록에 있는 연락처를 나열하거나 검색합니다. Contacts.Read
받은편지함 규칙 나열 읽기 전용 사용자의 Outlook 받은편지함 규칙을 나열합니다. MailboxSettings.Read
메일 폴더 나열 읽기 전용 사용자의 편지함에 있는 메일 폴더를 나열합니다. Mail.ReadBasic
폴더의 메시지 나열 읽기 전용 사용자의 메일 폴더 중 하나(예: 받은편지함 또는 보낸편지함)에 있는 메일을 나열합니다. Mail.Read
공유 편지함 나열 또는 검색하기 읽기 전용 사용자가 액세스할 수 있는 공유 또는 위임된 편지함의 메일을 나열하거나 검색합니다. Mail.Read.Shared
메시지 이동 쓰기 이메일 메시지를 다른 메일 폴더로 이동합니다. Mail.ReadWrite
메일에 전체 답장 쓰기 기존 이메일 메시지, 발신자, 기타 모든 수신자에게 답장하며, 답장은 원래 대화에 유지됩니다. Mail.Send
메시지에 답장하기 쓰기 기존 이메일 메시지의 발신자에게 답장하고 답장을 원본 대화에 유지합니다. Mail.Send
이벤트 참석 여부 회신 쓰기 회의 초대에 응답합니다(수락, 미정 상태로 수락 또는 거부). Calendars.ReadWrite
이메일 검색 읽기 전용 키워드로 사용자의 Outlook 메일을 검색합니다. Mail.Read
폴더에서 이메일 검색 읽기 전용 키워드, 발신자 또는 제목을 기준으로 받은편지함/인보이스와 같은 하위 폴더를 포함하여 사용자의 메일 폴더 중 하나에서 메시지를 검색합니다. Mail.Read
캘린더 일정 검색 읽기 전용 키워드로 사용자의 Outlook 캘린더 일정을 검색합니다. Calendars.Read
초안 메시지 보내기 쓰기 기존 임시보관 이메일 메시지를 전송합니다. Mail.Send
메일 보내기 쓰기 새 이메일 메시지를 작성하고 전송합니다. Mail.Send
캘린더 업데이트 쓰기 기존 캘린더의 속성(이름, 색상 또는 기본 상태)을 업데이트합니다. Calendars.ReadWrite
Calendars.ReadWrite.Shared
연락처 업데이트 쓰기 기존 연락처의 속성을 업데이트합니다. Contacts.ReadWrite
일정 업데이트 쓰기 기존 캘린더 일정의 속성을 업데이트합니다. Calendars.ReadWrite
메시지 업데이트 쓰기 기존 이메일 메시지의 속성을 업데이트합니다(예: 읽음으로 표시, 플래그 또는 중요도 변경). Mail.ReadWrite
할 일 목록 나열 읽기 전용 사용자의 Microsoft To Do(Outlook Tasks) 할 일 목록을 나열합니다. Tasks.Read
태스크 표시 읽기 전용 사용자의 Microsoft To Do(Outlook 할 일 목록) 목록 중 하나에 있는 할 일을 나열합니다. Tasks.Read

팀

작업 유형 설명 필수 권한
채널에 구성원 추가 쓰기 비공개 또는 공유 Teams 채널에 사용자를 추가합니다. ChannelMember.ReadWrite.All
채널 만들기 쓰기 Teams 팀 내에 새 채널을 만듭니다. Channel.Create
채팅 만들기 쓰기 새 Teams 채팅(일대일, 그룹 또는 회의 채팅)을 만듭니다. Chat.Create
회의 만들기 쓰기 새 Teams 온라인 회의를 만듭니다. OnlineMeetings.ReadWrite
예약 그룹 만들기 쓰기 Teams 일정 내에 일정 그룹을 만듭니다. Schedule.ReadWrite.All
휴가 항목 만들기 쓰기 Teams 일정에서 사용자의 휴가 항목을 만듭니다. Schedule.ReadWrite.All
휴가 사유 만들기 쓰기 Teams 일정에 새로운 휴가 사유(예: 휴가, 병가)를 만듭니다. Schedule.ReadWrite.All
일정 가져오기 읽기 전용 팀의 교대근무 일정 설정 및 프로비저닝 상태를 읽습니다. Schedule.Read.All
채널 회원 나열 읽기 전용 Teams 채널의 구성원과 역할을 나열합니다. ChannelMember.Read.All
채널 메시지 나열 읽기 전용 Teams 채널의 메시지를 나열합니다. ChannelMessage.Read.All
Group.ReadBasic.All
채널 나열 읽기 전용 Microsoft Teams의 채널을 나열합니다. Channel.ReadBasic.All
Group.ReadBasic.All
채팅 메시지 나열 읽기 전용 Teams 채팅의 메시지를 나열합니다. Chat.Read
채팅 나열 읽기 전용 사용자가 참여하는 Teams 채팅을 나열합니다. Chat.ReadBasic
참여한 팀 나열 읽기 전용 사용자가 속한 Microsoft Teams를 나열합니다. Team.ReadBasic.All
채널 메시지 답장 나열 읽기 전용 Teams 채널 대화목록(첫 번째 게시물과 그 아래의 답글)을 읽습니다. Chat.Read
ChannelMessage.Read.All
Group.ReadBasic.All
예약 그룹 나열 읽기 전용 팀의 Shifts 일정에 있는 일정 그룹을 나열합니다. Schedule.Read.All
휴가 항목 나열 읽기 전용 팀의 교대근무 일정에 예약된 휴가를 나열합니다. Schedule.Read.All
휴가 사유 나열 읽기 전용 팀의 근무 일정에서 선택할 수 있는 휴가 사유를 나열합니다. Schedule.Read.All
채널 메시지에 답장 쓰기 Teams 채널의 메시지에 답장합니다. ChannelMessage.Send
채팅 메시지 검색하기 읽기 전용 사용자가 액세스할 수 있는 Teams 채팅 및 채널 메시지를 검색합니다. Chat.Read
ChannelMessage.Read.All
Group.ReadBasic.All
채널 메시지 보내기 쓰기 Teams 채널에 메시지를 게시합니다. ChannelMessage.Send
채팅 메시지 보내기 쓰기 Teams 채팅에서 메시지를 보냅니다. ChatMessage.Send
채널 업데이트 쓰기 Teams 채널의 이름 또는 설명을 업데이트합니다. ChannelSettings.ReadWrite.All
채널 업데이트 메시지 쓰기 이전에 게시된 채널 메시지를 수정합니다. ChannelMessage.ReadWrite
채팅 업데이트 쓰기 Teams 그룹 채팅의 주제를 업데이트합니다. Chat.ReadWrite
채팅 메시지 업데이트 쓰기 이전에 보낸 채팅 메시지를 수정합니다. Chat.ReadWrite
일정 예약 그룹 업데이트 쓰기 예약 그룹의 이름, 활성 상태 또는 구성원을 업데이트합니다. Schedule.ReadWrite.All
팀 업데이트 쓰기 Teams 팀의 이름, 설명 또는 공개 상태를 업데이트합니다. TeamSettings.ReadWrite.All
휴무 항목 업데이트 쓰기 기존 휴무 항목을 업데이트합니다. Schedule.ReadWrite.All

권한

위 표의 필요한 권한 열에는 각 작업에 필요한 위임된 Microsoft Graph 권한이 나열되어 있습니다. Gemini Enterprise는 사용자가 사용 설정한 작업에 대한 권한과 모든 연결에서 요청하는 다음 권한만 요청합니다.

  • User.Read: 로그인한 사용자의 프로필을 읽어 커넥터가 작동하는 계정을 식별합니다.
  • offline_access: 커넥터가 사용자에게 다시 로그인하도록 요청하지 않고 액세스 토큰을 새로고침할 수 있습니다.

모든 권한이 위임됩니다. 커넥터는 로그인한 사용자로 작동하며 해당 사용자가 이미 액세스할 수 있는 데이터에만 액세스할 수 있습니다.

Google관리형 OAuth를 사용하면 사용자가 커넥터를 승인할 때 이러한 권한에 동의합니다. 일부 권한은 Microsoft Entra 관리자가 조직에 사용자 동의를 받아야 합니다. 자체 앱을 사용하는 경우 앱 등록 시 이러한 권한을 부여합니다. 자세한 내용은 Microsoft API 권한 구성을 참조하세요.

제한사항

이 섹션에서는 Microsoft 365 데이터 스토어 사용에 영향을 줄 수 있는 알려진 문제와 제한사항을 간략하게 설명합니다.

  • 새 앱을 만들거나 기존 앱에 데이터 스토어를 추가할 때는 단일 커넥터 유형에 속하는 작업에 하나의 데이터 스토어만 연결하는 것이 좋습니다.
  • 기존 Microsoft 365 데이터 스토어에 VPC 서비스 제어 경계를 적용하는 것은 지원되지 않습니다. VPC 서비스 제어를 시행하려면 데이터 스토어를 삭제하고 다시 만들어야 합니다. VPC 서비스 제어 및 VPC 서비스 제어를 사용 설정한 후 작업을 사용하는 방법에 대한 자세한 내용은 VPC 서비스 제어로 앱 보호를 참조하세요.
  • Microsoft 365 데이터 스토어는 global, us, eu 위치에서만 지원됩니다.

  • Microsoft 365 데이터 스토어는 단일 Microsoft 365 테넌트와 일대일로 매핑됩니다. 멀티 테넌트 조직(MTO) 내에서 격리된 여러 테넌트에 걸쳐 있을 수 없습니다. 고유한 테넌트마다 전용 데이터 스토어를 만들어야 합니다.

  • Google관리형 OAuth는 상용 Microsoft 클라우드(GCC 포함)의 테넌트만 지원하며 고정 IP 이그레스는 지원하지 않습니다. GCC High 또는 DoD 테넌트의 경우 또는 고정 IP 이그레스를 사용하려면 자체 Microsoft Entra 앱을 사용하세요.

  • 사서함이 Exchange Online으로 완전히 이전되어야 합니다. 하이브리드 Exchange 환경에서 온프레미스에 호스팅된 사서함은 Microsoft Graph API를 통해 액세스할 수 없으며, 이에 대한 쿼리는 MailboxNotEnabledForRESTAPI 오류를 반환할 수 있습니다.

다음 단계