====== Настройка интеграции с Google Calendar ====== Подробный алгоритм - [[product/settings/system/google_calendar|здесь]] Для настройки интеграции необходимы: - Учетная запись в Google. \\ Для этой учетной записи должен быть доступен сервис [[https://search.google.com/search-console|Google Search Console]] и [[https://console.developers.google.com/|Консоль разработчика Google]]. - Приложение ADVANTA на https веб-сервере с актуальным заверенным сертификатом SSL. - Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция ADVANTA и Google Calendar API. - Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена ADVANTA. В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345. Интерфейс сервисов Google Search Console и Консоль разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки. =====Подключение домена===== Заверьте домен на сервисе [[https://search.google.com/search-console|Google Search Console]], для этого: - добавьте новый ресурс -> "**Ресурс с префиксом в URL**" -> укажите ресурс с протоколом ''https'' в адресе; \\ {{ :product:settings:system:settings_configuration_01.png?nolink |}} \\ **Рисунок 1** -- Добавить ресурс в Search Console - действуйте согласно рекомендациям (Рисунок 2). \\ {{ :product:settings:system:settings_configuration_02.png?nolink |}} \\ **Рисунок 2** -- Подтверждение прав \\ Скачанный файл нужно загрузить в корень сайта, т.е чтобы он стал доступен для Google по адресу https://a2nta.ru/google6e61a8a115f815ba.html. \\ В случае успешной проверки -> «Подтвердить». - Домен появится в списке, если права успешно подтверждены. \\ При возникновении ошибок выдаются соответствующие сообщения. После устранения ошибок переходите к следующему шагу. \\ {{ :product:settings:system:settings_configuration_03.png?nolink |}} \\ **Рисунок 3** -- Сообщение о подтверждении прав Если сервис Google Search Console не смог найти файл ''robots.txt'' в указанном домене, то в его корневой каталог следует добавить файл с именем ''robots.txt'' и содержимым, приведенным ниже. Указанные настройки позволят всем известным ботам индексировать только главную страницу домена. User-agent: * Disallow: / User-agent: Yandex Allow: /$ Disallow: / User-agent: Mail.Ru Allow: /$ Disallow: / User-agent: StackRambler Allow: /$ Disallow: / User-agent: Googlebot Allow: /$ Disallow: / User-agent: googlebot-image Allow: /$ Disallow: / User-agent: googlebot-mobile Allow: /$ Disallow: / User-agent: Aport Allow: /$ Disallow: / User-agent: msnbot Allow: /$ Disallow: / User-agent: psbot Allow: /$ Disallow: / User-agent: yahoo-slurp Allow: /$ Disallow: / =====Создание и настройка API проекта===== - Перейдите в [[https://console.developers.google.com/|Консоль разработчика Google]] и создайте новый проект (Рисунок 4). - Введите название, которое будет отображаться только в консоли разработчика. \\ {{ :product:settings:system:settings_configuration_04.png?nolink |}} \\ **Рисунок 4** -- Кнопка «Создать проект» - С главной страницы перейдите к [[https://console.developers.google.com/apis/library|библиотеке API]].{{ :product:settings:system:settings_configuration_05.png?nolink |}} \\ **Рисунок 5** -- Создание нового проекта - Найдите Google Calendar API, перейдите на страницу и нажмите «Включить». \\ {{ :product:settings:system:settings_configuration_06.png?nolink |}} \\ **Рисунок 6** -- Кнопка перехода к библиотеке API - Перейдите в панель управления и проверьте список включённых для проекта API. \\ {{ :product:settings:system:settings_configuration_07.png?nolink |}} \\ **Рисунок 7** -- Список включённых API на панели управления - Настройте информацию о проекте. \\ - Перейдите «Учётные данные» -> «Создать учётные данные» -> «Идентификатор клиента OAuth». \\ {{ :product:settings:system:settings_configuration_08.png?nolink |}} \\ **Рисунок 8** -- Создать идентификатор клиента OAuth - После выполнения предыдущего пункта появится вкладка OAuth consent screen: \\ {{:product:settings:system:oauth_consent.jpg?nolink|}} \\ в ней заполните обязательные поля в первом окне; \\ {{:product:settings:system:oauth_2.jpg?nolink|}} \\ второе окно можно пропустить; \\ добавьте адреса пользователей, календарь которых нужно синхронизировать, в третьем окне. \\ {{:product:settings:system:oauth3.jpg?nolink|}} - После этого снова повторите действия "Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth»". - В открывшемся окне выберите «Desktop app». \\ {{:product:settings:system:photo_2021-10-27_16-25-29.jpg|}} \\ **Рисунок 9** -- Выбор типа приложения - Указав тип, вы получите реквизиты сертификата. \\ {{ :product:settings:system:settings_configuration_10.png?nolink |}} \\ **Рисунок 10** -- Идентификатор =====Настройка сервера push-сообщений===== Настройка нужна, чтобы Google отправлял push-сообщения на сервер в случае изменения, создания или удаления мероприятия в Google Calendar. Для этого настройте домен и подпишите пользователя в системе ADVANTA на канал рассылки push-сообщений. - Перейдите в «Учётные данные» -> «Подтверждение прав на домен» и нажмите «**Добавить домен**» - Укажите домен без протокола %%https://%% и нажмите «Добавить домен». \\ {{ :product:settings:settings_configuration_15.png?nolink |}} \\ **Рисунок 11** -- Ввод имени домена Если при добавлении домена возникла ошибка, значит у используемой учетной записи Google нет доступа к указанному домену, либо домен неверно заверен в сервисе Google Search Console. После выполнения всех пунктов можно переходить [[product:settings:interface:calendar_synchronize|к настройке интеграции с Google Calendar]] в разделе "Администрирование".