/UUST-GC-Schedule

📅 Расписание УУНИТ в Google Календаре!

Primary LanguagePythonMIT LicenseMIT

UGATU-Google-Calendar-Schedule

logo

Интеграция расписания УГАТУ в Google Календарь

Этот проект позволяет интегрировать расписание Уфимского Государственного Авиационного Технического Университета (УГАТУ) в ваш Google Календарь. Таким образом, вы сможете использовать это расписание с Apple, Siri и другими сервисами, поддерживающими Google Calendar API.

Для получения расписания используется api/new_schedule_api, но так же есть и другой способ через api/schedule (json формат, но только для текущего семестра).

Установка

  1. Создайте новый проект в Google Cloud Platform (GCP).

  2. Включите Google Calendar API в настройках проекта GCP. Для этого перейдите в "Enabled APIs & Services", затем "ENABLE APIS AND SERVICES" и найдите "Google Calendar API". Активируйте его.

  3. Создайте информацию о согласии OAuth consent screen для вашего проекта. Перейдя в раздел "Scopes" нажмите "ADD OR REMOVE SCOPES" и добавьте первые три пункта (.../auth/userinfo.email, .../auth/userinfo.profile, openid), а также поиском найдите и выберите "Google Calendar API". В разделе " Test users" добавьте свою почту.

  4. Перейдите в Credentials и создайте учетные данные (OAuth client ID) для веб-приложения (Web application). В поле "Authorized redirect URIs" добавьте и укажите http://localhost:8080/. Скачайте файл JSON с учетными данными выбрав "DOWNLOAD JSON". Переименуйте его в client_secret.json и поместите его в корневую папку проекта.

  5. Настройте файл settings.ini следующим образом:

    • default_calendar: Ваш адрес электронной почты / ID вторичного календаря.
    • schedule_year: Год начала текущего учебного периода.
    • schedule_type: 1 для расписания группы, 2 для расписания преподавателя.
    • student_group_or_teacher_id: ID группы (если schedule_type равен 1) / ID преподавателя (если schedule_type равен 2).
    • minutes_before_popup_reminder_first_lesson: За сколько минут перед началом первой пары отправлять уведомление.
    • minutes_before_popup_reminder: За сколько минут перед началом каждой последующей пары отправлять уведомление.

    P.S. Параметр student_group_or_teacher_id можно достать, выбрав на сайте расписания свою группу, и посмотрев на финальную ссылку ( Прим. https://isu.ugatu.su/api/new_schedule_api/?schedule_semestr_id=ID&WhatShow=1&student_group_id=ID&weeks=0)

  6. Установите зависимости через консольную команду pip install -r requirements.txt.

  7. Запустите скрипт main.py. На странице авторизации Google подтвердите доступ к вашему календарю.

  8. Для работы скрипта в фоновом режиме можете использовать pm2. Пример: pm2 start main.py --name UGCS --interpreter python3 --no-autorestart --cron-restart="*/30 * * * *".