| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия |
| product:settings:system:google_calendar [04.06.2019 13:39] – ↷ Страница перемещена из product:settings:server:google_calendar в product:settings:system:google_calendar mayn | product:settings:system:google_calendar [11.01.2022 13:50] (текущий) – anna.makhneva |
|---|
| ====== Настройка интеграции с Google Calendar ====== | ====== Настройка интеграции с Google Calendar ====== |
| | Подробный алгоритм - [[product/settings/system/google_calendar|здесь]] |
| |
| Для настройки интеграции необходимы: | Для настройки интеграции необходимы: |
| - Учетная запись в Google. \\ Для этой учетной записи должен быть доступен сервис [[https://www.google.com/webmasters/tools/home|Webmaster tools]] и [[https://console.developers.google.com/|Консоль разработчика Google]]. | - Учетная запись в Google. \\ Для этой учетной записи должен быть доступен сервис [[https://search.google.com/search-console|Google Search Console]] и [[https://console.developers.google.com/|Консоль разработчика Google]]. |
| - Приложение «Адванта» на https веб-сервере с актуальным заверенным сертификатом SSL. | - Приложение ADVANTA на https веб-сервере с актуальным заверенным сертификатом SSL. |
| - Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция Адванты и Google Calendar API. | - Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция ADVANTA и Google Calendar API. |
| - Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена Адванта. | - Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена ADVANTA. |
| |
| <callout>В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.</callout> | <callout>В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.</callout> |
| |
| <callout type="info">Интерфейс сервиса Webmaster tools и консоли разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки.</callout> | <callout type="info">Интерфейс сервисов Google Search Console и Консоль разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки.</callout> |
| |
| =====Подключение домена===== | =====Подключение домена===== |
| Заверьте домен на сервисе [[https://www.google.com/webmasters/tools/home|Webmaster tools]], для этого: | Заверьте домен на сервисе [[https://search.google.com/search-console|Google Search Console]], для этого: |
| - добавьте новый ресурс (учитываем протокол https в адресе домена); \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_3.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 1** -- Добавить ресурс в Search Console</text> | - добавьте новый ресурс -> "**Ресурс с префиксом в 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:settings_configuration_4.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 2** -- Подтверждение прав</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. \\ В случае успешной проверки -> «Подтвердить». |
| - В случае удачного подтверждения прав домен появится в списке. При возникновении ошибок выдаются соответствующие сообщения (Рисунок3). В примере (Рисунок 3) сертификат SSL еще не привязан к домену. После устранения ошибок переходим к следующему шагу. \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_5.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 3** -- Появление домена в списке</text> | - Домен появится в списке, если права успешно подтверждены. \\ При возникновении ошибок выдаются соответствующие сообщения. После устранения ошибок переходите к следующему шагу. \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_03.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 3** -- Сообщение о подтверждении прав</text> |
| |
| Если сервис Webmaster tools не смог найти файл ''robots.txt'' в указанном домене, то в его корневой каталог следует добавить файл с именем ''robots.txt'' и содержимым, приведенным ниже. | Если сервис Google Search Console не смог найти файл ''robots.txt'' в указанном домене, то в его корневой каталог следует добавить файл с именем ''robots.txt'' и содержимым, приведенным ниже. |
| |
| Указанные настройки позволят всем известным ботам индексировать только главную страницу домена. | Указанные настройки позволят всем известным ботам индексировать только главную страницу домена. |
| =====Создание и настройка API проекта===== | =====Создание и настройка API проекта===== |
| |
| - Перейдите в [[https://console.developers.google.com/|Консоль разработчика Google]] и создайте новый проект (Рисунок 4). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_6.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 4** -- Кнопка «Создать проект»</text> | - Перейдите в [[https://console.developers.google.com/|Консоль разработчика Google]] и создайте новый проект (Рисунок 4). |
| - Введите название, которое будет отображаться только в консоли разработчика (Рисунок 5). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_6.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 5** -- Создание нового проекта</text> | - Введите название, которое будет отображаться только в консоли разработчика. \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_04.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 4** -- Кнопка «Создать проект»</text> |
| - С главной страницы перейдите к библиотеке API (Рисунок 6). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_8.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 6** -- Кнопка перехода к библиотеке API</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, перейдите на страницу и нажмите «Включить». | - Найдите Google Calendar API, перейдите на страницу и нажмите «Включить». \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_06.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 6** -- Кнопка перехода к библиотеке API</text> |
| - Перейдите в панель управления и проверьте список включённых для проекта API (Рисунок 7) \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_9.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 7** -- Список включённых API на панели управления</text> | - Перейдите в панель управления и проверьте список включённых для проекта API. \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_07.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 7** -- Список включённых API на панели управления</text> |
| - Перед созданием ключа настройте информацию о проекте. \\ Перейдите «Учётные данные» -> «Окно запроса доступа OAuth» (Рисунок 8). Параметр «Product name» будет отображаться в приветственном сообщении, пример которого приведен справа (Рисунок 8). При необходимости заполните остальные поля. \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_10.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 8** -- Информация о проекте</text> | - Настройте информацию о проекте. \\ - Перейдите «Учётные данные» -> «Создать учётные данные» -> «Идентификатор клиента OAuth». \\ <image shape="thumbnail">{{ :product:settings:system:settings_configuration_08.png?nolink |}} </image> \\ <TEXT align="center">**Рисунок 8** -- Создать идентификатор клиента OAuth</text> |
| - Перейдите «Учётные данные» -> «Создать учётные данные» -> «Идентификатор клиента OAuth» (Рисунок 9). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_11.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 9** -- Создать идентификатор клиента 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> |
| - В открывшемся окне выберите «Другие типы» и введите название (Рисунок 10). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_12.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 10** -- Выбор типа приложения</text> | - После этого снова повторите действия "Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth»". |
| - Указав тип, вы получите реквизиты сертификата (Рисунок 11). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_13.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 11** -- Реквизиты API сертификата</text> | - В открывшемся окне выберите «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-сообщений===== | =====Настройка сервера push-сообщений===== |
| |
| Настройка нужна, чтобы Google отправлял push-сообщения на сервер в случае изменения, создания или удаления мероприятия в Google Calendar. | Настройка нужна, чтобы Google отправлял push-сообщения на сервер в случае изменения, создания или удаления мероприятия в Google Calendar. |
| |
| Для этого настройте домен и подпишите пользователя в системе «Адванта» на канал рассылки push-сообщений. | Для этого настройте домен и подпишите пользователя в системе ADVANTA на канал рассылки push-сообщений. |
| - Перейдите «Учётные данные» -> «Подтверждение прав на домен» и нажмите «Добавить домен» (Рисунок 12). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_14.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 12** -- Добавление домена</text> | - Перейдите в «Учётные данные» -> «Подтверждение прав на домен» и нажмите «**Добавить домен**» |
| - Укажите домен без протокола %%https://%% и нажмите «Добавить домен» (Рисунок 13). \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_15.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 13** -- Ввод имени домена</text> | - Укажите домен без протокола %%https://%% и нажмите «Добавить домен». \\ <image shape="thumbnail">{{ :product:settings:settings_configuration_15.png?nolink |}}</image> \\ <TEXT align="center">**Рисунок 11** -- Ввод имени домена</text> |
| | |
| Если при добавлении домена возникла ошибка, значит у используемой учетной записи Google нет доступа к указанному домену, либо домен неверно заверен в сервисе Webmaster tools. | |
| |
| Также причиной может быть ошибочный сертификат SSL, который привязан к домену. Например, это может быть самозаверенный сертификат, либо просроченный. | Если при добавлении домена возникла ошибка, значит у используемой учетной записи Google нет доступа к указанному домену, либо домен неверно заверен в сервисе Google Search Console. |
| |
| <callout type="info" icon="true">После настройки API проекта можно переходить к [[product:settings:interface:calendar_synchronize|настройке интеграции с Google Calendar]] в разделе администрирования.</callout> | <callout type="info" icon="true">После выполнения всех пунктов можно переходить [[product:settings:interface:calendar_synchronize|к настройке интеграции с Google Calendar]] в разделе "Администрирование".</callout> |