Яндекс Календарь
Доступные операции
-
Удалить событие по UID; функция недоступна, пока удаление отключено.
-
Получить событие основного календаря по UID в формате iCalendar и JSON.
-
Показать события основного календаря в диапазоне UTC в формате ICS и JSON.
-
Частично изменить событие, только если переданная версия ETag еще актуальна.
-
Создать/заменить событие целиком; не fallback после calendar_patch_event.
-
Добавить участников, сохранив остальные поля события и проверив его версию ETag.
-
Показать организатора и участников события календаря.
-
Показать роль и статус участия текущего пользователя в событии.
-
Удалить участников, сохранив остальные поля события и проверив его версию ETag.
-
Показать занятые интервалы UTC в основном календаре текущего пользователя.
-
Показать состояние конфигурации без раскрытия токенов и секретов клиентов.
-
Показать доступные интеграции с сервисами Яндекса и их ограничения.
Подготовка и добавление из витрины
| Подготовка выполняется администратором GigaCowork. |
-
Яндекс Календарь — личный. Для личных аккаунтов Яндекс (доступна только индивидуальная авторизация).
-
Яндекс Календарь — корпоративный. Для корпоративных аккаунтов Яндекс.
Для работы требуется созданное OAuth-приложение яндекса.
-
Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.
-
Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.
-
Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.
-
Укажите название для сервиса, почту и иконку приложения.
-
Выберите Веб-сервисы и вставьте Redirect URl.
Где взять Redirect URl:
-
В разделе
Администрирование →
Интеграции нажмите Добавить интеграцию. -
В витрине интеграций откройте подключаемую интеграцию.
-
Нажмите Далее и скопируйте значение из поля Callback URL.
-
-
Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для календаря, которые будут разрешены в интеграции (начинаются со слова 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 — Чтение и изменение содержимого календарей и списков дел.
-
-
Убедитесь, что все данные указаны верно и нажмите Создать приложение.
-
Если добавляете интеграцию корпоративным календарем, дополнительно активируйте функцию сервисных приложений с помощью запроса:
POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.
-
Скопируйте в созданном приложении ClientID и Client secret.
-
Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.
-
Нажмите Далее, а затем Добавить — интеграция добавится для авторизации пользователями.
Авторизация в интеграции
-
Проверьте, что интеграция находится в разделе
Каталоги →
Интеграции. Если ее нет, попросите администратора GigaCowork ее включить. -
Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.
-
Укажите учетные данные вашего аккаунта Яндекс.