Перейти к основному содержимому

Настройка интеграции с G Suite

к сведению

Dispatch поставляется с несколькими плагинами G Suite (Docs, Groups, Drive и др.). На этой странице описаны доступные параметры этих плагинов и разрешения, которые нужны, чтобы их включить.

Настройка Dispatch​

Плагины G Suite настраиваются в веб-интерфейсе Dispatch в разделе «Настройки» -> «Проект» -> «Плагины» (Settings -> Project -> Plugins). Добавьте нужные плагины кнопкой NEW, затем откройте их настройки, нажав на три вертикальные точки.

Developer Key​

Используется службой Google API Discovery Service и защищает от ограничения частоты запросов.

Service Account Client Email​

Значение client_email из файла конфигурации сервисного аккаунта Google Cloud Platform (GCP).

Service Account Client Id​

Значение client_id из файла конфигурации сервисного аккаунта Google Cloud Platform (GCP).

Service Account Delegated Account​

Аккаунт, которому делегируются права от сервисного аккаунта Google Cloud Platform (GCP). Исходящие письма и другие артефакты будут выглядеть отправленными от этого аккаунта.

Service Account Private Key​

Значение private_key из файла конфигурации сервисного аккаунта Google Cloud Platform (GCP).

Service Account Private Key Id​

Значение private_key_id из файла конфигурации сервисного аккаунта Google Cloud Platform (GCP).

Service Account Project Id​

Значение project_id из файла конфигурации сервисного аккаунта Google Cloud Platform (GCP).

Google Workspace Domain​

Базовый домен, к которому относится этот сервисный аккаунт Google Cloud Platform (GCP).

Default Event Duration (Minutes)​

Длительность событий конференций по умолчанию в минутах. По умолчанию 1440 минут (1 день).

Настройка G Suite​

Чтобы настроить интеграцию с G Suite, создайте несколько ресурсов в Google Cloud Platform и привяжите их к своей организации G Suite.

Включение необходимых API в Google Cloud Platform​

Откройте консоль Google Cloud Platform (GCP). Для интеграции с Dispatch создайте новый проект GCP.

Создайте новый сервисный аккаунт внутри проекта GCP (APIs & Services > Credentials > Create Credentials > Service Account). Назначать этому сервисному аккаунту какие-либо разрешения Google Cloud, когда вас об этом спросят, не нужно.

После создания скачайте ключ в формате JSON. Его значения понадобятся для настройки Dispatch:

  • project_id -> Service Account Project Id
  • private_key_id -> Service Account Private Key Id
  • private_key -> Service Account Private Key
  • client_email -> Service Account Client Email
  • client_id -> Service Account Client Id

Затем создайте API-ключ разработчика (APIs & Services > Credentials > Create Credentials > API Key) и укажите его в поле Developer Key.

Включите следующие API (APIs and Services > Library):

  • Google Drive API
  • Google Drive Activity API
  • Google People API
  • Google Docs API
  • Google Calendar API
  • Gmail API
  • Admin SDK (нужен для создания групп и управления ими)

Наконец, создайте OAuth-приложение — через него G Suite будет авторизовать сервисный аккаунт и API-ключ (APIs & Services > OAuth Consent Screen). Укажите следующие скоупы:

https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/directory.readonly
https://www.googleapis.com/auth/drive.activity.readonly
https://mail.google.com/
https://www.googleapis.com/auth/admin.directory.group
https://www.googleapis.com/auth/apps.groups.settings
https://www.googleapis.com/auth/calendar

Примечание. Если вы не собираетесь использовать Google Meet для конференций, скоуп https://www.googleapis.com/auth/calendar вам не нужен.

Подключение Dispatch к G Suite​

Откройте в админ-панели G Suite страницу Domain-wide Delegation (Security > API Controls > Domain-wide Delegation) (делегирование на уровне домена) и добавьте нового API-клиента.

Введите Client ID, который вы указали в поле Service Account Client Id, и вставьте список OAuth-скоупов, приведённых выше, через запятую.