Розклад · Google API
Підключення Google API
Сторінка /?do=rozklad&func=google_token використовується адміністратором для підключення до Google API. Після підключення система може синхронізувати заняття з Google Calendar і, якщо увімкнено відповідну опцію, перевіряти доступ до Google Workspace Directory.
Кому потрібна ця сторінка
Звичайним користувачам не потрібно відкривати цю сторінку. Вона призначена для адміністратора, який налаштовує інтеграцію розкладу з Google.
Що показує сторінка
Статус токена
Показує, чи активовано доступ Google API для root email. Якщо токена ще немає, доступна дія Підключити.
Перепідключення
Якщо токен уже активний, доступна дія Перепідключити. Її використовують після зміни Google Client ID, Client Secret або прав доступу.
Перевірка налаштувань
Сторінка показує, чи заповнені домен email, Google API Client ID, Google API Client Secret і Google API Root Email.
Тест підключення
Кнопка перевірки запускає тест доступу до Google API і повертає повідомлення про успіх або причину помилки.
Передумови
Як підключити Google API
1. Відкрийте сторінку Google API
Перейдіть у Розклад → Google API або відкрийте адресу /?do=rozklad&func=google_token.
2. Перевірте обов'язкові налаштування
Переконайтеся, що заповнені домен email, Google API Client ID, Google API Client Secret і Google API Root Email.
3. Додайте адреси в Google Cloud
Скопіюйте зі сторінки значення Дозволені джерела JavaScript та URI перенаправлення і внесіть їх у налаштування OAuth-клієнта.
4. Підключіть акаунт Google
Натисніть Підключити. Якщо інтеграція вже була активована, натисніть Перепідключити.
5. Підтвердьте доступ
У вікні Google виберіть адміністративний акаунт і надайте дозволи, потрібні для роботи розкладу з Google API.
6. Перевірте результат
Поверніться на сторінку Google API. У таблиці токенів має з'явитися статус Активовано.
Які дозволи використовуються
| Доступ | Для чого потрібен |
|---|---|
https://www.googleapis.com/auth/calendar | Створення, оновлення й перевірка календарів та подій розкладу. |
https://www.googleapis.com/auth/admin.directory.group | Робота з групами Google Workspace, якщо це використовується в налаштуваннях системи. |
https://www.googleapis.com/auth/admin.directory.user | Перевірка або створення користувачів Google Workspace, якщо увімкнено відповідну інтеграцію. |
https://www.googleapis.com/auth/admin.directory.orgunit | Перевірка організаційних підрозділів Google Workspace. |
Перевірка підключення
Кнопка Перевірити підключення запускає тест Google API. Під час перевірки система перевіряє доступ до календарів, пробує створити тестовий календар і видаляє його після перевірки.
Якщо увімкнено використання Google People API, додатково перевіряється доступ до користувачів Google Workspace та організаційних підрозділів Викладачі і Студенти.
Зверніть увагу
Під час перевірки користувачів система може створити тестовий обліковий запис у Google Workspace. Після тесту перевірте Google Admin Console і видаліть тестовий запис, якщо він залишився.
Типові проблеми
- Якщо сторінка просить вказати Root Email, заповніть Google API Root Email у налаштуваннях системи.
- Якщо Google відхиляє авторизацію, перевірте Client ID, Client Secret і URI перенаправлення.
- Якщо тест показує помилку календарів, перевірте доступ
calendarі права створення календарів у Google Workspace. - Якщо тест показує помилку User Directory, перевірте доступ
admin.directory.userі роль адміністратора Google Workspace. - Якщо повідомлення згадує підрозділи Викладачі або Студенти, створіть ці організаційні підрозділи вручну в Google Workspace Admin.
Коли натискати «Перепідключити»
Використовуйте перепідключення після зміни OAuth-клієнта, домену, root email або набору дозволів Google API. Це оновить доступ, який використовує для синхронізації.