Настройка интеграции с Google Calendar

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка интеграции с 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.

<callout>В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.</callout>

<callout type="info">Интерфейс сервисов Google Search Console и Консоль разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки.</callout>

=====Подключение домена=====
Заверьте домен на сервисе [[https://search.google.com/search-console|Google Search Console]], для этого:
  - добавьте новый ресурс -> "**Ресурс с префиксом в URL**" -> укажите ресурс с протоколом ''https'' в адресе;  \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_01.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 1** -- Добавить ресурс в Search Console</text>
  - действуйте согласно рекомендациям (Рисунок 2).  \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_02.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 2** -- Подтверждение прав</text> \\ Скачанный файл нужно загрузить в корень сайта, т.е чтобы он стал доступен для Google по адресу https://a2nta.ru/google6e61a8a115f815ba.html. \\ В случае успешной проверки -> «Подтвердить».
  - Домен появится в списке, если права успешно подтверждены. \\ При возникновении ошибок выдаются соответствующие сообщения. После устранения ошибок переходите к следующему шагу.  \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_03.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 3** -- Сообщение о подтверждении прав</text>

Если сервис Google Search Console не смог найти файл ''robots.txt'' в указанном домене, то в его корневой каталог следует добавить файл с именем ''robots.txt'' и содержимым, приведенным ниже.

Указанные настройки позволят всем известным ботам индексировать только главную страницу домена.

<code>
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: /
</code>

=====Создание и настройка API проекта=====

  - Перейдите в [[https://console.developers.google.com/|Консоль разработчика Google]] и создайте новый проект (Рисунок 4).  
  - Введите название, которое будет отображаться только в консоли разработчика. \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_04.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 4** -- Кнопка «Создать проект»</text>
  - С главной страницы перейдите к [[https://console.developers.google.com/apis/library|библиотеке API]].<image shape="thumbnail">{{ :product:settings:system:settings_configuration_05.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 5** -- Создание нового проекта</text>
  - Найдите Google Calendar API, перейдите на страницу и нажмите «Включить».  \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_06.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 6** -- Кнопка перехода к библиотеке API</text>
  - Перейдите в панель управления и проверьте список включённых для проекта API.  \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_07.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 7** -- Список включённых API на панели управления</text>
  - Настройте информацию о проекте.  \\   - Перейдите «Учётные данные» -> «Создать учётные данные» -> «Идентификатор клиента OAuth». \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_08.png?nolink |}} </image>  \\  <TEXT align="center">**Рисунок 8** -- Создать идентификатор клиента OAuth</text> 
  - После выполнения предыдущего пункта появится вкладка OAuth consent screen: \\ <image shape="thumbnail"> {{:product:settings:system:oauth_consent.jpg?nolink|}} </image> \\ в ней заполните обязательные поля в первом окне; \\ <image shape="thumbnail"> {{:product:settings:system:oauth_2.jpg?nolink|}} </image> \\ второе окно можно пропустить; \\ добавьте адреса пользователей, календарь которых нужно синхронизировать, в третьем окне. \\ <image shape="thumbnail"> {{:product:settings:system:oauth3.jpg?nolink|}} </image>
  - После этого снова повторите действия "Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth»".
  - В открывшемся окне выберите «Desktop app».  \\ <image shape="thumbnail"> 
 {{:product:settings:system:photo_2021-10-27_16-25-29.jpg|}} </image> \\ <TEXT align="center">**Рисунок 9** -- Выбор типа приложения</text>
  - Указав тип, вы получите реквизиты сертификата.  \\  <image shape="thumbnail">{{ :product:settings:system:settings_configuration_10.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 10** -- Идентификатор</text>
=====Настройка сервера push-сообщений=====

Настройка нужна, чтобы Google отправлял push-сообщения на сервер в случае изменения, создания или удаления мероприятия в Google Calendar.

Для этого настройте домен и подпишите пользователя в системе ADVANTA на канал рассылки push-сообщений.
  - Перейдите в «Учётные данные» -> «Подтверждение прав на домен» и нажмите «**Добавить домен**»
  - Укажите домен без протокола %%https://%% и нажмите «Добавить домен».  \\  <image shape="thumbnail">{{ :product:settings:settings_configuration_15.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 11** -- Ввод имени домена</text>

Если при добавлении домена возникла ошибка, значит у используемой учетной записи Google нет доступа к указанному домену, либо домен неверно заверен в сервисе Google Search Console.

<callout type="info" icon="true">После выполнения всех пунктов можно переходить [[product:settings:interface:calendar_synchronize|к настройке интеграции с Google Calendar]] в разделе "Администрирование".</callout>