개요

Gemini Enterprise용 Microsoft Outlook 데이터 스토어를 사용하면 OneDrive 및 SharePoint에 저장된 이메일, 캘린더, 연락처, Microsoft 365 파일 (Excel 통합 문서, Word 문서, PowerPoint 프레젠테이션)을 검색하고 작업을 실행할 수 있습니다.

지원되는 Microsoft Outlook 버전

Microsoft Outlook 데이터 스토어는 IDP 통합과 함께 Microsoft Graph API v1.0을 지원합니다.

지원되는 작업

Microsoft Outlook 데이터 스토어를 사용 설정하면 최종 사용자가 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 실행할 수 있습니다.

작업 설명
연락처 만들기 Microsoft Outlook에 새 연락처를 만듭니다.
이벤트 만들기 새 일정을 만듭니다.
첨부파일 다운로드 Microsoft Outlook 이메일 메시지에서 첨부파일을 다운로드합니다.
메일 보내기 이메일 메시지를 전송합니다. 여기에는 첨부파일이 포함된 이메일 전송이 포함됩니다.
연락처 업데이트 Microsoft Outlook의 기존 연락처를 업데이트합니다.
이벤트 업데이트 기존 일정을 업데이트합니다.
Excel 데이터 읽기 OneDrive 또는 SharePoint에 저장된 Excel (.xlsx) 파일에서 워크북을 나열하고, 워크시트, 표, 행을 읽습니다.
Excel 데이터 수정 OneDrive 또는 SharePoint에 저장된 Excel (.xlsx) 파일에서 행을 추가 및 업데이트하고, 워크시트와 표를 만들고, 주요 열을 추가합니다.
Word 문서 만들기 사용자의 OneDrive에 새 Word (.docx) 문서를 만듭니다.
Word 문서를 PDF로 변환 OneDrive 또는 SharePoint에 저장된 Word (.docx) 문서를 PDF로 변환합니다.
PowerPoint 프레젠테이션 만들기 사용자의 OneDrive에 새 PowerPoint (.pptx) 프레젠테이션을 만듭니다.
PowerPoint를 PDF로 변환하기 OneDrive 또는 SharePoint에 저장된 PowerPoint (.pptx) 프레젠테이션을 PDF로 변환합니다.

필수 권한

다음 표에는 Microsoft Outlook 검색 및 작업에 필요한 권한이 나와 있습니다.

연결 모드 권한 목적
제휴 검색 Mail.Read
Mail.Read.Shared
Calendars.Read
Contacts.Read		 (위임됨) 데이터 스토어가 로그인한 사용자의 메일함, 공유 메일함의 이메일, 캘린더 일정, 연락처를 읽을 수 있습니다.
데이터 수집 Calendars.Read (애플리케이션) 데이터 저장소가 모든 캘린더의 일정을 읽을 수 있도록 허용합니다.
Calendars.ReadBasic.All (애플리케이션) 데이터 저장소가 본문, 첨부파일, 확장 프로그램과 같은 속성을 제외한 모든 캘린더의 일정을 읽을 수 있도록 허용합니다.
Contacts.Read (애플리케이션) 데이터 스토어가 모든 편지함의 모든 연락처를 읽도록 허용합니다.
Mail.Read (애플리케이션) 데이터 스토어가 모든 편지함의 메일을 읽을 수 있도록 허용합니다.
Mail.ReadBasic (애플리케이션) 데이터 스토어가 모든 메일함에서 기본 메일 속성을 읽을 수 있도록 허용합니다. 본문, previewBody, 첨부파일, 확장 속성을 제외한 모든 속성이 포함됩니다.
Mail.ReadBasic.All (애플리케이션) 데이터 스토어가 모든 메일함에서 기본 메일 속성을 읽을 수 있도록 허용합니다. 본문, previewBody, 첨부파일, 확장 속성을 제외한 모든 속성이 포함됩니다.
User.Read (위임됨) 데이터 스토어가 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다.
User.Read.All (애플리케이션) 데이터 스토어가 조직 내 다른 사용자의 전체 프로필 속성, 보고서, 관리자를 읽을 수 있도록 허용합니다.
User.ReadBasic.All (애플리케이션) 데이터 스토어가 조직 내 다른 사용자의 기본 프로필 속성을 읽을 수 있도록 허용합니다.
작업 Mail.Send (위임됨) 데이터 스토어가 조직의 사용자로 메일을 보낼 수 있도록 허용합니다.
Calendars.ReadWrite (위임됨) 데이터 스토어가 사용자 캘린더에서 이벤트를 생성, 읽기, 업데이트, 삭제할 수 있도록 허용합니다.
Contacts.ReadWrite (위임됨) 데이터 저장소가 사용자 연락처를 만들고, 읽고, 업데이트하고, 삭제할 수 있도록 허용합니다.
User.Read (위임됨) 데이터 스토어가 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다.
파일 생산성 (Excel, Word, PowerPoint) Files.Read.All 파일 메타데이터를 읽거나 파일 콘텐츠를 다운로드하는 도구에만 충분합니다(위임됨). Excel 통합 문서 나열, Excel 통합 문서 메타데이터 읽기, Word (.docx) 또는 PowerPoint (.pptx) 문서를 PDF로 변환하는 경우에 해당합니다. 사용자가 액세스할 수 있는 모든 파일을 읽습니다. 여기에는 사용자가 액세스할 수 있는 SharePoint 사이트에 저장된 파일이 포함됩니다. Excel 통합 문서 콘텐츠 작업에 충분하지 않음 (다음 행 참고).
Files.ReadWrite.All (위임됨) 워크시트 가져오기, 테이블 가져오기, 행 가져오기, 행 가져오기, 워크시트 및 테이블 만들기, 행 추가 및 업데이트, 키 열 추가 등 모든 Excel 통합 문서 콘텐츠 작업 (읽기 및 쓰기)에 필요합니다. 이러한 엔드포인트 (예: worksheet-list, table-list, tablerow-list)의 Microsoft Graph API 참조에 따라 허용되는 위임된 권한은 Files.ReadWrite입니다. Files.ReadWrite.All는 사용자가 액세스할 수 있는 모든 드라이브 (개인 OneDrive 및 사용자가 액세스할 수 있는 모든 SharePoint 문서 라이브러리)에 동일한 기능을 부여합니다. 사용자의 OneDrive에 Word 및 PowerPoint 문서를 만드는 데도 필요합니다.
User.Read (위임됨) 파일 작업을 위해 로그인한 사용자의 OneDrive 위치를 확인하는 데 필요합니다.
작업 (Outlook 할 일 목록 및 작업) Tasks.Read (위임됨) 로그인한 사용자의 Outlook 할 일 목록 및 할 일에 대한 읽기 작업 (할 일 목록 나열, 할 일 나열, 할 일 가져오기)에 필요합니다.
Tasks.ReadWrite (위임됨) 쓰기 작업에 필요합니다. 로그인한 사용자의 Outlook 할 일 목록에서 할 일을 만들고, 업데이트하고, 삭제합니다.
사용자 및 디렉터리 (위임된 열거) User.ReadBasic.All (위임됨) 조직의 다른 사용자의 프로필을 열거하거나 조회하는 도구 (사용자 가져오기, 사용자 목록, 다른 사용자의 메일함 또는 캘린더에서 작동하는 도구)에 필요합니다.

Microsoft Outlook 권한을 추가하는 방법은 Microsoft Outlook 구성 및 필요한 권한 설정을 참고하세요.

데이터 수집 비율 제한

요청량 한도는 10분당 API 요청 10,000개입니다. 이러한 비율 제한은 연결 모드로 수집을 선택한 경우 Microsoft Outlook 데이터 스토어에만 적용됩니다.

제한사항

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

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

  • Microsoft Outlook 데이터 스토어는 노드당 초당 하나의 트랜잭션을 처리할 수 있으며 이 한도를 초과하는 트랜잭션은 제한됩니다.

  • Microsoft Outlook 데이터 스토어에서 비율 제한 초과 오류를 재시도할 수 있는지 여부는 Microsoft Graph API에서 retry-after 값을 수신하는지에 따라 달라지며, 이 값은 Outlook 데이터 스토어에만 제공됩니다. 기본 재시도 횟수는 3회입니다.

  • Microsoft Outlook 데이터 저장소의 처리량은 Microsoft Graph에서 부과하는 API 호출 제한에 따라 제한됩니다. 한도는 각 앱 ID와 메일함 조합(즉, 특정 사용자 또는 그룹 메일함에 액세스하는 특정 앱)에 적용됩니다. 한 편지함의 한도를 초과해도 애플리케이션이 다른 편지함에 액세스하는 기능에는 영향을 미치지 않습니다.

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

  • 사서함이 Exchange Online으로 완전히 이전되어야 합니다. 하이브리드 Exchange 환경에서 온프레미스로 호스팅되는 사서함은 Microsoft Graph API를 통해 액세스할 수 없습니다. 이러한 메일함을 쿼리하거나 테넌트 간 메일함을 쿼리하려고 하면 MailboxNotEnabledForRESTAPI 오류가 발생할 수 있습니다.

  • Microsoft Outlook 데이터 스토어는 노드당 초당 하나의 트랜잭션을 처리할 수 있으며 이 한도를 초과하는 트랜잭션을 제한합니다.

다음 단계