Цей документ містить інструкції для користувачів PeopleForce про те, як інтегрувати Google Календар за допомогою облікових записів Google. Це дозволить вашій платформі взаємодіяти з Google Calendar API і виконувати такі операції, як створення подій у календарях користувачів і перевірка доступності для індивідуальних зустрічей та співбесід, без ручного втручання користувача.
Переваги
Інтеграція календаря Google з PeopleForce має низку переваг:
Впорядковане планування співбесід: Автоматизувавши процес планування співбесід, ви заощадите час.
Доступність співробітників в режимі реального часу: Завдяки інтеграції ви можете легко перевіряти доступність ваших співробітників в режимі реального часу. Це спрощує процес планування індивідуальних зустрічей і командних заходів, оскільки ви можете визначити відповідні часові проміжки на основі індивідуальних і командних календарів.
Можливість спільної роботи: Створюючи події безпосередньо в календарях користувачів, інтеграція гарантує, що всі зацікавлені сторони будуть проінформовані про заплановані зустрічі та завдання.
Необхідні складові
Обліковий запис Google Cloud Platform (GCP);
Базове розуміння Google Cloud Console та API;
Доступ супер-адміністратора до вашого домену Google Workspace.
⚠️ Зверніть увагу, що Google Workspace не є безкоштовним сервісом і має бути придбаним для використання компанією.
Крок 1: Створіть проект Google в Google Cloud Platform
Відкрийте консоль розробника Google.
Створіть новий проект, натиснувши на випадаюче меню проекту і вибравши "Новий проект"
Крок 2: Увімкніть API календаря Google
У консолі Google Cloud виберіть свій проект.
На лівій панелі натисніть 'API & Services > Library.''
3. У швидкому пошуку знайдіть "Google Calendar API".
4. Натисніть на картку API, а потім натисніть "Увімкнути".
Крок 3: Створіть сервісний акаунт
Перейдіть до "IAM & Admin > Service Accounts" у консолі Google Cloud.
2. Натисніть "Create Service Account".
3. Введіть назву та опис сервісного акаунта.
4. Натисніть "Create and continue", а потім "Done".
Крок 4: Згенеруйте ключ для сервісного акаунта
Поверніться на сторінку ''Service Accounts''.
Натисніть на щойно створений обліковий запис служби.
Перейдіть до розділу Keys" і натисніть "Add Key".
4. Виберіть "JSON" для типу ключа.
5. Натисніть "Create". Буде створено файл ключа у форматі JSON і завантажено його на ваш комп'ютер. Зберігайте цей файл у безпечному та доступному місці, оскільки він знадобиться для автентифікації вашого додатку в Google.
Крок 5: Делегуйте загальнодоменні повноваження своєму сервісному акаунту
Як супер адміністратор, перейдіть до консолі адміністратора вашого домену Google Workspace.
2. Перейдіть в розділ ''Security > API Controls''.
3. На панелі "Domain-wide delegation" виберіть "Manage Domain-Wide Delegation".
4. Натисніть ''Add new''.
5. У полі "Client ID" введіть ідентифікатор клієнта, знайдений у файлі JSON-ключів вашого облікового запису.
6. У полі "0auth scopes" введіть наступні чотири значення:
7. Натисніть кнопку "Authorize".
Крок 6: Використовуйте сервісний акаунт у PeopleForce
Тепер на платформі PeopleForce ви можете ввести шлях до завантаженого JSON-файлу ключа. Щоб налаштувати цю інтеграцію, виконайте наступні кроки:
Перейдіть до "Налаштувань".
Виберіть "Інтеграції" та виберіть "Google Календар".
Вставте ключ з JSON файлу з вашого сервісного акаунту у відповідне поле.
Натисніть кнопку "Встановити".
Важливо
Усі дії, що виконуються сервісним акаунтом, виглядатимуть так, ніби їх виконує користувач, чию адресу електронної пошти було вказано під час процесу "Делегування повноважень для всього домену". Будь ласка, використовуйте сервісний акаунт відповідально і дотримуйтесь умов використання, встановлених Google.
FAQ
Що станеться, якщо існуючі користувачі видалять інтеграцію, а потім спробують встановити її знову?
Існуючі клієнти, які інтегрувалися раніше, залишаться з оригінальною реалізацією, оскільки працюватимуть у звичайному режимі, однак, якщо вони видалять інтеграцію, а потім спробують встановити її знову, вона запитає ключ JSON, використовуючи новий метод інтеграції.