Это старая версия документа!


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

Для настройки интеграции необходимы:

  1. Учетная запись в Google.
    Для этой учетной записи должен быть доступен сервис Webmaster tools и Консоль разработчика Google.
  2. Приложение «Адванта» на https веб-сервере с актуальным заверенным сертификатом SSL.
  3. Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция Адванты и Google Calendar API.
  4. Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена Адванта.
В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.
Интерфейс сервиса Webmaster tools и консоли разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки.

Заверьте домен на сервисе Webmaster tools, для этого:

  1. добавьте новый ресурс (учитываем протокол https в адресе домена);


    Рисунок 1 – Добавить ресурс в Search Console

  2. проверьте доступность из сети указанного выше домена: следует действовать согласно инструкции (Рисунок 2). В случае успешной проверки подтверждаем свои права (кнопка «Подтвердить»).


    Рисунок 2 – Подтверждение прав

  3. В случае удачного подтверждения прав домен появится в списке. При возникновении ошибок выдаются соответствующие сообщения (Рисунок3). В примере (Рисунок 3) сертификат SSL еще не привязан к домену. После устранения ошибок переходим к следующему шагу.


    Рисунок 3 – Появление домена в списке

Если сервис Webmaster tools не смог найти файл 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: /
  1. Перейдите в Консоль разработчика Google и создайте новый проект (Рисунок 4).


    Рисунок 4 – Кнопка «Создать проект»

  2. Введите название, которое будет отображаться только в консоли разработчика (Рисунок 5).


    Рисунок 5 – Создание нового проекта

  3. С главной страницы перейдите к библиотеке API (Рисунок 6).


    Рисунок 6 – Кнопка перехода к библиотеке API

  4. Найдите Google Calendar API, перейдите на страницу и нажмите «Включить».
  5. Перейдите в панель управления и проверьте список включённых для проекта API (Рисунок 7)


    Рисунок 7 – Список включённых API на панели управления

  6. Перед созданием ключа настройте информацию о проекте.
    Перейдите «Учётные данные» → «Окно запроса доступа OAuth» (Рисунок 8). Параметр «Product name» будет отображаться в приветственном сообщении, пример которого приведен справа (Рисунок 8). При необходимости заполните остальные поля.


    Рисунок 8 – Информация о проекте

  7. Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth» (Рисунок 9).


    Рисунок 9 – Создать идентификатор клиента OAuth

  8. В открывшемся окне выберите «Другие типы» и введите название (Рисунок 10).


    Рисунок 10 – Выбор типа приложения

  9. Указав тип, вы получите реквизиты сертификата (Рисунок 11).


    Рисунок 11 – Реквизиты API сертификата

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

Для этого настройте домен и подпишите пользователя в системе «Адванта» на канал рассылки push-сообщений.

  1. Перейдите «Учётные данные» → «Подтверждение прав на домен» и нажмите «Добавить домен» (Рисунок 12).


    Рисунок 12 – Добавление домена

  2. Укажите домен без протокола https:// и нажмите «Добавить домен» (Рисунок 13).


    Рисунок 13 – Ввод имени домена

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

Также причиной может быть ошибочный сертификат SSL, который привязан к домену. Например, это может быть самозаверенный сертификат, либо просроченный.

После настройки API проекта можно переходить к настройке интеграции с Google Calendar в разделе администрирования.