К основному содержимому

Интеграция с календарем Google Workspace

Этот документ содержит инструкции для пользователей PeopleForce о том, как интегрировать Google Календарь с помощью учетных записей Google.

Обновлено больше недели назад

Данная интеграция позволит вашей платформе взаимодействовать с Google Calendar API и выполнять такие операции, как создание событий в календарях пользователей и проверка доступности для индивидуальных встреч и собеседований, без ручного вмешательства пользователя.

Преимущества

Интеграция календаря Google с PeopleForce имеет ряд преимуществ:

  • Организованное планирование собеседований: Автоматизировав процесс планирования собеседований, вы сэкономите время.

  • Доступность сотрудников в режиме реального времени: Благодаря интеграции вы можете легко проверять доступность ваших сотрудников в режиме реального времени. Это упрощает процесс планирования индивидуальных встреч и командных мероприятий, поскольку вы можете определить подходящие временные промежутки на основе индивидуальных и командных календарей.

  • Возможность совместной работы: Создавая события непосредственно в календарях пользователей, интеграция гарантирует, что все заинтересованные стороны будут проинформированы о запланированных встречах и задачах.

Необходимые составляющие

  1. Учетная запись Google Cloud Platform (GCP);

  2. Базовое понимание Google Cloud Console и API;

  3. Доступ супер-администратора к вашему домену Google Workspace.

⚠️ Обратите внимание, что Google Workspace не бесплатный сервис и должен быть приобретен для использования компанией.

Шаг 1: Создайте проект Google в Google Cloud Platform

  1. Создайте новый проект, нажав на выпадающее меню проекта и выбрав "Новый проект".

Шаг 2: Включите API календаря Google

  1. В консоли Google Cloud выберите свой проект.

  2. На левой панели нажмите "API & Services > Library".

  3. В быстром поиске найдите "Google Calendar API".

  4. Нажмите на карточку API, а затем нажмите "Включить".

Шаг 3: Создайте сервисный аккаунт

  1. Перейдите в "IAM & Admin > Service Accounts" в консоли Google Cloud.

  2. Нажмите "Create Service Account".

  3. Введите название и описание сервисного аккаунта.

  4. Нажмите "Create and continue", а затем "Done".

Шаг 4: Сгенерируйте ключ для сервисного аккаунта

  1. Вернитесь на страницу "Service Accounts".

  2. Нажмите на только что созданную учетную запись службы.

  3. Перейдите в раздел "Keys" и нажмите "Add Key".

  4. Выберите "JSON" для типа ключа.

  5. Нажмите "Create". Будет создан файл ключа в формате JSON и загружен на ваш компьютер. Храните этот файл в безопасном и доступном месте, поскольку он понадобится для аутентификации вашего приложения в Google.

Шаг 5: Делегируйте общедоменные полномочия своему сервисному аккаунту

  1. В качестве супер администратора перейдите в консоль администратора вашего домена Google Workspace домена.

  2. Перейдите в раздел "Security > API Controls".

  3. На панели "Domain-wide delegation" выберите "Manage Domain-Wide Delegation".

  4. Нажмите "Add new".

  5. В поле "Client ID" введите идентификатор клиента, найденный в файле JSON-ключей вашей учетной записи.

  6. Нажмите кнопку "Authorize".

Шаг 6: Используйте сервисный аккаунт в PeopleForce

Теперь на платформе PeopleForce вы можете ввести путь к загруженному JSON-файлу ключа. Чтобы настроить эту интеграцию, выполните следующие шаги:

  1. Перейдите в "Настройки".

  2. Выберите "Интеграции" и выберите "Google Календарь".

  3. Вставьте ключ из JSON файла из вашего сервисного аккаунта в соответствующее поле.

  4. Нажмите кнопку "Установить".

Важно

Все действия, выполняемые сервисным аккаунтом, будут выглядеть так, будто их выполняет пользователь, чей адрес электронной почты был указан во время шага 6. Пожалуйста, используйте сервисный аккаунт ответственно и соблюдайте условия использования, установленные Google.

FAQ

Что произойдет, если существующие пользователи удалят интеграцию, а затем попытаются установить ее снова?

Существующие клиенты, которые интегрировались ранее, останутся с оригинальной реализацией, поскольку будут работать в обычном режиме, однако, если они удалят интеграцию, а затем попытаются установить ее снова, она запросит ключ JSON, используя новый метод интеграции.

Нашли ответ на свой вопрос?