Соединитель Google Drive Graph (предварительная версия)

Статья
12/20/2024

С помощью соединителя Microsoft Graph ваша организация в M365 может индексировать файлы, доступные любому пользователю в Google Диск, с помощью Microsoft Copilot и поиска.

Эта статья предназначена для администраторов Microsoft 365 или всех, кто настраивает, запускает и отслеживает соединитель Google Drive.

Примечание.

Соединитель Google Drive доступен в предварительной версии. Если вы хотите получить ранний доступ, чтобы попробовать его, зарегистрируйтесь с помощью этой формы.

Возможности

Доступ к файлам Google Диска с помощью функции семантического поиска
Сохранение списков ACL, определенных вашей организацией
Настройка частоты обхода контента
Создание рабочих процессов с помощью этого подключения и подключаемых модулей из Microsoft Copilot Studio

Ограничения

Папка, ответы & комментарии не индексируемые

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

Перед созданием соединителя Google Drive необходимо:

1. Быть суперадминистратором Google Workspace или получить доступ

Доступ предоставляется ролью суперадминистраторов или является пользователем с правами администратора. Вам не нужна роль суперадминистраторов, если вы получили доступ с помощью роли суперадминистраторов.

2. Настройка учетных данных для подключения учетной записи службы Google Drive

Настроенные учетные данные подключения к учетной записи службы Google Drive, содержащие адрес электронной почты учетной записи администратора, адрес электронной почты клиента (адрес электронной почты учетной записи службы) и закрытый ключ. Дополнительные сведения см. в статье Создание и удаление ключей учетной записи службы.

3. Создание учетной записи облачной службы Google

Создайте учетную запись облачной службы Google (учетную запись с делегированными полномочиями для использования удостоверения пользователя) с включением делегирования G Suite на уровне домена, активированным для проверки подлинности между серверами, а затем создайте закрытый ключ JSON с помощью учетной записи. Дополнительные сведения см. в статье Создание учетных записей служб.

4. Добавление необходимых API в учетную запись пользователя

Добавьте API пакета SDK Администратор и API Google Drive в учетную запись пользователя.

5. Добавление областей OAuth в учетную запись службы

Добавьте (или попросите пользователя с ролью суперадминистратора добавить) следующие области OAuth в учетную запись службы с помощью роли суперадминистратора. Эти области API необходимы для обхода всех документов и сведений об управлении доступом (ACL) для всех пользователей в домене Google Workspace:

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

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

https://www.googleapis.com/auth/drive.readonly

Настройка

1. Отображаемое имя

Отображаемое имя используется для идентификации каждой ссылки в Copilot, помогая пользователям легко распознавать связанный файл или элемент. Отображаемое имя также означает доверенное содержимое.

2. Домен Google Apps

Чтобы зарегистрироваться в Google Workspace, вам потребуется доменное имя в Интернете, например your-company.com. В этом домене может размещаться веб-сайт (www.your-company.com) и электронная почта (info@your-company.com). Дополнительные сведения см. в разделе Что такое домен?.

3. Адрес электронной почты учетной записи администратора Google Apps

Введите адрес электронной почты учетной записи администратора Google Apps в user@company.com формате.

4. Развертывание для ограниченной аудитории

Разверните это подключение в ограниченной базе пользователей, если вы хотите проверить его в Copilot и других поисковых поверхностях, прежде чем развернуть развертывание для более широкой аудитории.

Для других параметров, таких как разрешения доступа, правила включения данных, схема, частота обхода контента и т. д., мы устанавливаем значения по умолчанию в зависимости от того, что лучше всего подходит для данных в Google Диск. Параметры значений по умолчанию приведены ниже.

Page	Параметры	Значения по умолчанию
Пользователи	Разрешения доступа	Все файлы, доступные любому пользователю в Google Диск, видны всем пользователям Microsoft 365 в вашем клиенте из Поиска (Майкрософт) или Copilot.
Содержимое	Индексирование содержимого	Все опубликованные публикации и страницы выбираются по умолчанию.
Содержимое	Управление свойствами	Чтобы проверка свойства по умолчанию и их схему, щелкните здесь.
Синхронизация	Добавочный обход контента	Частота: каждые 15 минут
Синхронизация	Полный обход контента	Частота: каждый день

Если вы хотите изменить любое из этих значений, необходимо выбрать параметр Настраиваемая настройка .

Настраиваемая настройка

Пользовательская настройка подходит для администраторов, которые хотят изменить значения параметров по умолчанию. Щелкнув параметр "Настраиваемая настройка", вы увидите три другие вкладки: Пользователи, Содержимое и Синхронизация.

Пользователи

Разрешения доступа

В настоящее время индексируются и видны всем пользователям Microsoft 365 в вашем клиенте только файлы, доступные всем пользователям Microsoft 365 из поиска Майкрософт или Copilot.

Содержимое

Управление свойствами

Здесь можно добавить или удалить доступные свойства из источника данных Google Диска. Назначьте схему свойству (определите, доступно ли свойство для поиска, можно запрашивать, можно получить или уточнить), измените семантику метки и добавьте псевдоним в свойство. Свойства, выбранные по умолчанию:

Свойство source	Label	Описание	схема;
CreatedTime	Дата создания	Время создания файла.	Поиск, запрос, извлечение
Описание		Краткое описание файла.
FileExtension	Расширение файла	Последний компонент fullFileExtension. Этот параметр доступен только для файлов с двоичным содержимым в Google Диск.	Запрос, уточнение, извлечение
FileType		Тип файла.
IconLink	IconUrl	Статическая ссылка без проверки подлинности на значок файла.	Восстанавливать
LastModifingUser	lastModifiedDateTime	Последний пользователь, изменяя файл. Это поле заполняется только в том случае, если последнее изменение было выполнено вошедшем в систему пользователем.	Запрос, извлечение, поиск
modifiedTime	Автор последнего изменения	Время последнего изменения файла кем-либо (дата-время RFC 3339).	Запрос, извлечение, поиск
Ссылка	url	Ссылка для открытия файла в соответствующем редакторе Google или средстве просмотра в браузере.	Восстанавливать
Имя	Имя файла	Имя файла	Запрос, извлечение, поиск
Владелец	Автор	Владелец этого файла. Только некоторые устаревшие файлы могут иметь более одного владельца. Это поле не заполняется для элементов на общих дисках.	Поиск, запрос, извлечение
ParentFolderLink		Ссылка на родительскую папку, содержащую файл.	Восстанавливать
ParentFolderName		Имя родительской папки, содержащей файл.	Поиск, запрос, извлечение
Размер		Размер больших двоичных объектов и файлов сторонних редакторов в байтах.	Поиск, запрос, извлечение

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

Вы можете настроить полное и добавочное обход контента на основе параметров планирования, представленных здесь. По умолчанию добавочный обход контента устанавливается каждые 15 минут, а полный — на каждый день. При необходимости эти расписания можно настроить в соответствии с потребностями обновления данных.

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

Обнаружены недопустимые учетные данные. Проверьте учетные данные и проверка разрешения учетной записи службы.

Эта ошибка возникает, когда у учетной записи службы отсутствуют необходимые разрешения для доступа к Google Диску. Проверьте учетные данные учетной записи и убедитесь, что они правильно заполнены на странице настройки.

Отсутствуют необходимые разрешения для пользователей и файлов.

Ошибка проверки подлинности: отсутствуют одна или несколько обязательных областей OAuth для учетной записи службы. Учетная запись службы должна включать обе области API: