Разделы документации
Коннекторы

Google Drive

Подключение Google Drive к Charo — сервис-аккаунт с делегированием, выбор дисков и папок, синхронизация прав.

Что индексируется

  • Файлы «Моих дисков» пользователей и общих дисков: документы Google (Docs/Sheets/Slides), офисные файлы, PDF и другие поддерживаемые форматы.
  • Метаданные: владельцы, время изменения, права доступа (для синхронизации прав).
  • Файлы больше порога размера пропускаются.

Предварительные требования

  • Google Workspace и права супер-администратора для настройки сервис-аккаунта и делегирования (domain-wide delegation).

Получение учётных данных

Основной способ — сервис-аккаунт с делегированием:

  1. В console.cloud.google.com создайте проект и включите API: Google Drive API и Admin SDK API.

  2. Создайте сервис-аккаунт (IAM & Admin → Service Accounts), выпустите для него JSON-ключ.

  3. В админ-консоли Workspace (Security → Access and data control → API controls → Domain-wide delegation) добавьте client ID сервис-аккаунта со scope’ами:

    https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
https://www.googleapis.com/auth/admin.directory.user.readonly

  4. В Charo загрузите JSON-ключ («Ключ сервисного аккаунта Google») и укажите «Email основного администратора» — от его имени сервис-аккаунт будет обращаться к API.

Подробный разбор прав и типовых ошибок — «Google Drive: права доступа».

Настройка в Charo

Вкладка «Как индексировать ваш Google Drive?»:

ПолеЧто означает
Включать общие диски?индексировать общие диски организации
Include Everyone’s My Drive?индексировать «Мои диски» всех пользователей (для сервис-аккаунта)
URL общих дисковлибо перечислите конкретные общие диски
URL папоклибо конкретные папки
Email владельцев «Моего диска»либо «Мои диски» конкретных пользователей

Расширенные поля: «Email конкретных пользователей» (индексировать только доступное этим пользователям) и «Скрывать файлы, доступные только по ссылке?».

Синхронизация прав

Поддерживается: Charo переносит права файлов и папок Google Drive, включая членство в группах Workspace, — файл найдёт только тот, кому он доступен. Требуется активная лицензия.

Ограничения и частота обновления

  • Файлы больше ~10 МБ пропускаются.
  • Скорость ограничена квотами Google Drive API; большие домены индексируются долго.
  • Обновления забираются инкрементально по расписанию коннектора.

Устранение неполадок

«client not authorized for any of the scopes requested»

Не настроено делегирование или список scope’ов неполный — сверьте его со списком на странице прав доступа.

Пустая индексация при сервис-аккаунте

Проверьте «Email основного администратора»: это должен быть действующий администратор Workspace, а не адрес сервис-аккаунта.

Часть файлов отсутствует

Файлы, доступные «всем по ссылке», могли быть скрыты настройкой «Скрывать файлы, доступные только по ссылке?», либо превышают порог размера.