Яндекс Календарь

Доступные операции

События (чтение и изменение):
  • Удалить событие по UID; функция недоступна, пока удаление отключено.

  • Получить событие основного календаря по UID в формате iCalendar и JSON.

  • Показать события основного календаря в диапазоне UTC в формате ICS и JSON.

  • Частично изменить событие, только если переданная версия ETag еще актуальна.

  • Создать/заменить событие целиком; не fallback после calendar_patch_event.

Участники событий:
  • Добавить участников, сохранив остальные поля события и проверив его версию ETag.

  • Показать организатора и участников события календаря.

  • Показать роль и статус участия текущего пользователя в событии.

  • Удалить участников, сохранив остальные поля события и проверив его версию ETag.

Занятость:
  • Показать занятые интервалы UTC в основном календаре текущего пользователя.

Настройки и возможности интеграции:
  • Показать состояние конфигурации без раскрытия токенов и секретов клиентов.

  • Показать доступные интеграции с сервисами Яндекса и их ограничения.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.
В витрине интеграций доступны два шаблона для работы с Яндекс Календарем:
  • Яндекс Календарь — личный. Для личных аккаунтов Яндекс (доступна только индивидуальная авторизация).

  • Яндекс Календарь — корпоративный. Для корпоративных аккаунтов Яндекс.

Для работы требуется созданное OAuth-приложение яндекса.

Для создания приложения:
  1. Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.

  2. Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.

    connector yandex calendar 0
  3. Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.

  4. Укажите название для сервиса, почту и иконку приложения.

    connector yandex calendar 1
  5. Выберите Веб-сервисы и вставьте Redirect URl.

    connector yandex calendar 2
    Где взять Redirect URl:
    1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

    2. В витрине интеграций откройте подключаемую интеграцию.

    3. Нажмите Далее и скопируйте значение из поля Callback URL.

  6. Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для календаря, которые будут разрешены в интеграции (начинаются со слова calendar).

    • calendar:read_all — Просмотр любых данных в Календаре.

    • calendar:write_all — Изменение любых данных в Календаре.

    • calendar:events.read — Просмотр событий в Календаре.

    • calendar:events.write — Создание, изменение и удаление событий в Календаре.

    • calendar:calendars.read — Просмотр списка календарей и их настроек.

    • calendar:calendars.write — Создание, изменение и удаление календарей, управление доступом к ним.

    • calendar:free_busy.read — Просмотр занятости пользователей и переговорок в Календаре.

    • calendar:resources.read — Просмотр доступных офисов и переговорок организации в Календаре.

    • calendar:my_settings.read — Просмотр пользовательских настроек Календаря.

    • calendar:my_settings.write — Изменение пользовательских настроек Календаря.

    • calendar:all — Чтение и изменение содержимого календарей и списков дел.

    connector yandex calendar 3
  7. Убедитесь, что все данные указаны верно и нажмите Создать приложение.

  8. Если добавляете интеграцию корпоративным календарем, дополнительно активируйте функцию сервисных приложений с помощью запроса:
    POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
    Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.

    connector yandex calendar 5
  9. Скопируйте в созданном приложении ClientID и Client secret.

    connector yandex calendar 4
  10. Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.

  11. Нажмите Далее, а затем Добавить — интеграция добавится для авторизации пользователями.

Авторизация в интеграции

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

  2. Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.

  3. Укажите учетные данные вашего аккаунта Яндекс.