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

Интеграции22 окт. 2026 г.4 минуты чтения

Google Календарь

Mitra подключается к Google Календарю по протоколу CalDAV, как к любому календарному серверу. Отличается только вход: Google не принимает пароль, а просит разрешить доступ на своей странице. Для этого Google должен знать ваш сервер Mitra, поэтому администратор сервера один раз регистрирует его в Google и передаёт Mitra идентификатор клиента и секрет, которые выдаёт Google.

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

  1. Зарегистрируйте Mitra в Google.
  2. Передайте Mitra идентификатор клиента и секрет.
  3. Подключите аккаунт.

Первые два шага выполняются один раз для каждого сервера Mitra.

  1. Создайте проект в Google Cloud console и в разделе APIs & Services включите CalDAV API.

  2. Настройте OAuth consent screen. Добавьте себя и всех, кто будет подключать аккаунт, как test user или опубликуйте приложение.

  3. Создайте OAuth client типа Web application. В качестве authorized redirect URI укажите адрес вашего сервера Mitra, а после него /api/integrations/google/callback:

    https://mitra.example.com/api/integrations/google/callback
  4. Скопируйте client ID и client secret, которые покажет Google.

CAUTION

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

Передача Mitra идентификатора клиента и секрета

Section titled “Передача Mitra идентификатора клиента и секрета”

Задайте их как переменные окружения вместе с MITRA_URL, адресом вашего сервера:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com'
MITRA_GOOGLE_CLIENT_SECRET: '…'
# …

Затем перезапустите Mitra:

Terminal window
docker compose up -d

Задайте обе переменные или ни одной. Mitra не запустится, если есть идентификатор клиента, но нет секрета, так что незавершённая настройка не останется незамеченной.

MITRA_URL должен совпадать с адресом в redirect URI. Без него Mitra использует адрес, по которому вы открыли приложение, и этого достаточно, чтобы опробовать его на localhost. Для всех адресов, кроме localhost, Google принимает только адреса перенаправления с https://, поэтому настоящему серверу нужны HTTPS и MITRA_URL. Все переменные перечислены в разделе Конфигурация.

  1. Выберите Добавить интеграцию внизу боковой панели, затем Google Календарь.
  2. Нажмите Продолжить с Google. Google попросит выбрать аккаунт и разрешить Mitra просматривать и изменять ваши календари.
  3. Когда вы вернётесь в Mitra, там появится список календарей аккаунта, все включённые. Выключите ненужные и нажмите Сохранить.

Если подключить тот же аккаунт Google ещё раз, его разрешение продлится, а второй копии аккаунта не появится.

Google ограничивает частоту обращений приложений, поэтому Mitra синхронизирует аккаунты Google примерно раз в минуту (см. как работает синхронизация).

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

Section titled “Календари, к которым вам открыли доступ”

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

  1. Войдите в Google и откройте calendar.google.com/calendar/syncselect.
  2. В разделе Shared Calendars отметьте каждый календарь, который нужен вам в Mitra, и нажмите Save.
  3. В Mitra откройте меню ⋯ аккаунта на боковой панели, выберите Изменить и нажмите Обновить.
  4. Включите появившиеся календари и нажмите Сохранить.

Календарь, к которому вам открыли доступ с правом See all event details, в Mitra доступен только для чтения: вы видите всё, что в нём есть, но не можете добавлять, изменять или удалять события. Если владелец позже даст вам право Make changes to events, редактирование включится при следующей синхронизации. См. Календари только для чтения.

Всё синхронизируется так же, как для CalDAV, кроме связей между записями: Google удаляет их из своей копии события, поэтому Mitra не предлагает их в календарях Google.

Вложениями в календаре Google служат файлы Google Диска, прикреплённые в Google Календаре. Mitra показывает их, и каждое открывается на Диске, но добавлять или удалять вложения не может: Google хранит только файлы с Диска и отбрасывает вложения, добавленные другими приложениями.

Доступность с отметкой «занят» в календаре Google добавляется в этот календарь в виде занятых событий, чтобы другие видели, что это время занято. Всё работает так, как описано для CalDAV.

Токен, который выдаёт Google, никогда не покидает сервер. Браузер лишь открывает страницу Google, чтобы вы разрешили доступ. Mitra хранит токен вместе с аккаунтом и при каждой синхронизации получает по нему кратковременный доступ.

Выберите Удалить в меню ⋯ аккаунта, чтобы удалить его из Mitra вместе с токеном. Чтобы отозвать доступ Mitra и на стороне Google, удалите Mitra из списка сторонних приложений, связанных с аккаунтом Google. Если сделать только это, синхронизация тоже прекратится: аккаунт останется в Mitra, но каждая синхронизация будет завершаться ошибкой, пока вы не подключите его снова.

  • Если при выборе Google Календарь вместо кнопки Продолжить с Google появляется сообщение, что на этом сервере интеграция не настроена, значит, переменные MITRA_GOOGLE_CLIENT_ID и MITRA_GOOGLE_CLIENT_SECRET не заданы или Mitra не перезапускали после того, как их задали.
  • Если Google отвечает redirect_uri_mismatch, redirect URI в Google Cloud console не совпадает с MITRA_URL, за которым следует /api/integrations/google/callback. Он должен совпадать в точности, включая https:// и без косой черты в конце.
  • Если аккаунты перестают синхронизироваться через 7 дней, ваш экран запроса доступа всё ещё в режиме тестирования. Опубликуйте приложение и подключите аккаунты заново.