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

Интеграция с календарем 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, используя новый метод интеграции.

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