개요

Gemini Enterprise용 Google Drive 데이터 스토어를 사용하면 파일 및 폴더를 포함한 Google Drive 데이터를 검색하고 작업을 수행할 수 있습니다.

지원되는 작업

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

작업 설명
파일 복사 Google Drive의 파일을 복사합니다.
파일 만들기 Google Drive에 새 파일을 만듭니다.
파일 콘텐츠 다운로드 Google Drive 파일의 콘텐츠를 다운로드합니다.
셀 값 가져오기 Google Sheets 스프레드시트에서 셀 값을 읽습니다.
파일 메타데이터 가져오기 Google Drive 파일의 메타데이터를 가져옵니다.
파일 권한 가져오기 Google Drive 파일의 권한을 나열합니다.
스프레드시트 가져오기 Google Sheets 스프레드시트의 콘텐츠와 메타데이터를 읽습니다.
행/열 삽입하기 Google Sheets 스프레드시트에 행 또는 열을 삽입합니다.
최근 파일 나열 Google Drive의 최근 파일을 나열합니다.
공유 드라이브 나열 Google Drive의 공유 드라이브를 나열합니다.
문서 읽기 Google Docs 문서의 콘텐츠를 읽습니다.
파일 콘텐츠 읽기 Google Drive 파일의 콘텐츠를 읽습니다.
프레젠테이션 읽기 Google Slides 프레젠테이션의 콘텐츠를 읽습니다.
파일 검색 검색어와 일치하는 Google Drive 파일을 검색합니다.
파일 공유 Google Drive 파일을 한 명 이상의 사용자와 공유합니다.
파일을 휴지통으로 이동 Google Drive 파일을 휴지통으로 이동합니다.
셀 값 업데이트 Google Sheets 스프레드시트에 셀 값을 씁니다.
파일 업데이트 기존 Google Drive 파일을 업데이트합니다.
수식 업데이트 Google Sheets 스프레드시트에 수식을 작성합니다.

필수 범위

Google에서 관리하는 OAuth 앱은 다음 OAuth 범위를 요청합니다. 사용자는 커넥터를 승인할 때 다음 범위를 부여합니다.

범위 목적
https://www.googleapis.com/auth/drive.readonly Google Drive 콘텐츠를 검색하고 가져옵니다. 데이터 스토어에서 파일 및 폴더를 나열하고, 메타데이터를 보고, 권한을 나열하고, 파일 콘텐츠를 읽을 수 있습니다.
https://www.googleapis.com/auth/drive.metadata.readonly Google Drive 파일 메타데이터를 읽습니다.
https://www.googleapis.com/auth/drive.file 사용자가 커넥터로 열거나 만드는 파일을 만들고 업데이트합니다.
https://www.googleapis.com/auth/drive.appdata Google Drive에 애플리케이션별 데이터를 저장합니다.
https://www.googleapis.com/auth/drive Google Drive 파일에 쓰기 작업(예: 복사, 공유, 휴지통으로 이동, 업데이트)을 실행합니다.

제한사항

  • Google Drive 데이터 스토어는 global, us, eu 위치에서만 지원됩니다.

  • 보안 제어를 사용하는 경우 다음 표의 설명대로 Google Drive의 데이터와 관련된 제한사항에 유의하세요.

    보안 제어 다음에 유의하세요.
    데이터 상주(DRZ) Gemini Enterprise는 Google Cloud의 데이터 상주만 보장합니다. 데이터 저장 위치 및 Google Drive에 대한 자세한 내용은 Google Workspace 규정 준수 가이드 및 문서(Google Workspace 데이터 리전 포함)를 참고하세요. 데이터가 저장되는 리전 선택 및 디지털 주권과 같은 예도 검토하세요.
    고객 관리 암호화 키(CMEK) 키는 Google Cloud내 데이터만 암호화합니다. Google Drive에 저장된 데이터에는 Cloud Key Management Service 제어가 적용되지 않습니다.
    액세스 투명성 액세스 투명성은 Google 직원이 Google Cloud 프로젝트에서 수행한 작업을 로깅합니다. Google Workspace에서 생성된 액세스 투명성 로그도 검토해야 합니다. 자세한 내용은 Google Workspace 관리 도움말 문서의 액세스 투명성 로그 이벤트를 참고하세요.

일반적인 검색 문제

검색해도 원하는 파일이 표시되지 않거나 Gemini Enterprise 웹 앱에서 일치하는 Google Drive 파일이 없다고 보고하는 경우 다음 문제와 해결 방법을 확인하세요.

Gemini Enterprise의 Google Workspace 데이터 액세스가 사용 중지됨

증상: Gemini Enterprise 웹 앱에서 일치하는 Google Drive 파일을 찾을 수 없다고 보고하거나 Search API를 통해 전송된 검색 요청에서 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. 오류(또는 경고)를 반환합니다. Cloud Logging에서 데이터 스토어 오류 로그를 검사할 수도 있습니다. Gemini Enterprise 데이터 스토어 문제 해결을 참조하세요.

문제: 사용자의 Google Workspace 조직에 대한 Google 관리 콘솔에서 Gemini Enterprise가 Google Workspace 데이터에 액세스하도록 허용 설정이 사용 중지되어 있습니다.

해결 방법: 사용자의 조직에 속한 Google Workspace 관리자에게 Gemini Enterprise가 Google Workspace 데이터에 액세스하도록 허용을 사용 설정해 달라고 요청합니다. 교차 조직 설정에서는 사용자가 Google Drive를 쿼리하는 각 Google Workspace 조직의 관리자가 이 설정을 사용 설정해야 합니다.

사용자와 데이터 스토어가 서로 다른 Google Workspace 조직에 속함

증상: Google Cloud 프로젝트와 다른 Google Workspace 조직에서 로그인한 사용자는 Gemini Enterprise 웹 앱에서 Google Drive 결과를 수신하지 못하거나 Search API를 통해 전송된 요청에서 403 Permission Denied: User does not belong to the same organization as the Workspace data store. Workspace data store is configured for customer ID ... while user belongs to customer ID ... 오류가 반환됩니다. 로그에서 403 오류를 확인하려면 Cloud Logging을 사용하여 Gemini Enterprise 커넥터 오류 로그에 액세스를 참조하세요.

문제: 기본적으로 Gemini Enterprise는 사용자의 Google Workspace 고객 ID가 Google Drive 데이터 스토어 및 Google Cloud 프로젝트의 조직과 일치하는 경우에만 사용자가 Google Drive 데이터 스토어를 검색할 수 있도록 허용합니다.

해결 방법: 조직 간 설정을 완료합니다.

  1. Cloud Customer Care에 문의하여 사용자가 Gemini Enterprise에 액세스하는 각 Google Workspace 조직의 고객 ID를 Google Cloud 프로젝트의 허용 목록에 추가합니다.
  2. 각 Google Workspace 조직의 Google Workspace 관리자가 Gemini Enterprise가 Google Workspace 데이터에 액세스하도록 허용을 사용 설정하도록 합니다.
  3. 사용자가 자신의 조직 외부에서 소유한 문서를 찾아야 하는 경우 웹 앱 기능 관리에서 교차 도메인 문서 포함을 사용 설정합니다.

1MB 텍스트 추출 한도를 초과하는 키워드는 검색할 수 없습니다.

증상: 대용량 파일에서 나중에 표시되는 키워드를 검색해도 파일이 반환되지 않습니다.

문제: Google Drive는 파일에서 검색 가능하도록 텍스트 및 서식 데이터를 1MB만 추출합니다. 1MB 색인 제한을 초과하는 키워드는 검색할 수 없습니다.

해결 방법: 파일의 처음 1MB 내에 표시되는 검색어를 사용하여 검색하거나 큰 문서를 작은 파일로 분할합니다.

크기 또는 PDF 페이지 한도를 초과하는 파일은 색인이 생성되지 않음

증상: 특정 대용량 파일 또는 긴 PDF가 검색 결과에 표시되지 않습니다.

문제: Google Drive 크기 또는 페이지 한도를 초과하는 파일은 색인이 생성되지 않으며 검색 결과에 표시되지 않습니다.

  • 대부분의 파일 형식의 경우 파일 크기는 10MB를 초과할 수 없으며, 다음과 같은 예외가 있습니다.
    • XLSX 파일: 최대 20MB
    • PDF 파일: 최대 30MB
    • 텍스트 파일: 최대 100MB
  • PDF 파일의 광학 문자 인식은 80페이지로 제한됩니다. Google Drive는 50MB 또는 80페이지를 초과하는 PDF를 색인 생성하지 않습니다.

해결 방법: 파일 크기를 줄이거나 이러한 색인 생성 한도를 초과하는 파일과 PDF를 분할합니다.

다음 단계