Настройка Google Console

Прежде чем модуль Google Workspace сможет взаимодействовать с сервисами Google, необходимо создать проект Google Cloud, включить необходимые API и сгенерировать учётные данные OAuth. Это руководство проведёт вас через каждый шаг.

Шаг 1: Создание проекта Google Cloud

1. Перейдите в Google API Console.
2. Нажмите Выбрать проект в верхней панели навигации, затем нажмите Новый проект.
3. Введите Название проекта (например, «Concord CRM Integration»).
4. Нажмите Создать и дождитесь создания проекта.
5. Убедитесь, что новый проект выбран в выпадающем списке проектов.

к сведению

Если у вас уже есть проект Google Cloud, который вы хотите использовать повторно, выберите его из списка проектов вместо создания нового.

Шаг 2: Включение необходимых API

С выбранным проектом включите каждый из следующих API:

1. Перейдите в APIs & Services → Library.
2. Найдите и включите каждый API по отдельности:
   • Google Drive API
   • Google Docs API
   • Google Sheets API
   • Google Slides API

Для каждого API:

1. Нажмите на название API в результатах поиска.
2. Нажмите Enable.
3. Дождитесь подтверждения, прежде чем переходить к следующему.

warning

Все четыре API должны быть включены для корректной работы модуля. Если какой-либо API отсутствует, соответствующий сервис Google не будет доступен из CRM.

Шаг 3: Настройка экрана согласия OAuth

1. Перейдите в APIs & Services → OAuth consent screen.
2. Выберите Тип пользователя:
   • External -- Рекомендуется для большинства настроек. Позволяет любому аккаунту Google авторизоваться.
   • Internal -- Доступен только для платных аккаунтов Google Workspace. Ограничивает доступ пользователями внутри вашей организации.
3. Нажмите Create.
4. Заполните обязательные поля:
   • App Name -- Название, которое пользователи увидят при авторизации (например, «Concord CRM»).
   • User Support Email -- Ваш адрес электронной почты для поддержки.
   • Developer Contact Information -- Ваш адрес электронной почты.
5. Нажмите Save and Continue на шагах Scopes и Test Users (изменения не требуются для базовой настройки).
6. Нажмите Back to Dashboard на вкладке «Сводка».

Статус публикации

Статус	Требуется HTTPS	Примечания
Testing	Нет	Ограничен 100 тестовыми пользователями; показывает дополнительное предупреждение о согласии
Production	Да	Доступен всем пользователям; ваш сайт должен использовать HTTPS

подсказка

Для первоначальной настройки и тестирования оставьте приложение в режиме Testing. После проверки работоспособности переключитесь в режим Production для удобной авторизации.

Шаг 4: Создание учётных данных OAuth

1. Перейдите в APIs & Services → Credentials.
2. Нажмите Create Credentials → OAuth client ID.
3. Выберите Web application в качестве типа приложения.
4. Введите Название для учётных данных (например, «Concord CRM OAuth»).
5. В разделе Authorized redirect URIs добавьте следующий адрес:

https://yourdomain.com/google-workspace/callback

Замените yourdomain.com на фактический домен, где установлена ваша Concord CRM.

6. Нажмите Create.
7. В появившемся диалоге будут отображены ваш Client ID и Client Secret. Скопируйте оба значения.

warning

URI перенаправления должен точно совпадать с URL установки вашей Concord CRM, включая протокол (HTTPS) и путь. Неверный URI перенаправления приведёт к ошибке авторизации.

Шаг 5: Подключение к Concord CRM

1. Войдите в Concord CRM как администратор.
2. Перейдите в настройки модуля Google Workspace.
3. Вставьте Client ID и Client Secret из предыдущего шага.
4. Нажмите Сохранить и авторизовать.
5. Появится экран согласия Google. Выберите свой аккаунт Google и предоставьте запрошенные разрешения.
6. Вы будете перенаправлены обратно в Concord CRM. Статус подключения должен отображаться как Авторизован.

к сведению

Если ваше приложение Google Cloud находится в режиме Testing, при авторизации вы увидите дополнительный экран предупреждения. Нажмите Continue для продолжения. Это предупреждение не появляется в режиме Production.

Устранение неполадок

Проблема	Решение
«Error 400: redirect_uri_mismatch»	Убедитесь, что URI перенаправления в Google Cloud точно совпадает с URL вашей CRM
Авторизация молча завершается с ошибкой	Убедитесь, что все четыре API включены в проекте Google Cloud
«Access blocked: App not verified»	Переключитесь в режим Production или добавьте свой аккаунт как тестовый пользователь
Соединение разрывается через некоторое время	Повторно авторизуйтесь из настроек модуля; проверьте настройки обновления токена

Рекомендации по безопасности

• Ограничьте учётные данные OAuth для вашего конкретного домена с помощью авторизованных URI перенаправления.
• Используйте HTTPS для установки Concord CRM для защиты токенов OAuth при передаче.
• Периодически проверяйте доступ к API в Google Cloud Console, чтобы убедиться, что не предоставлены ненужные разрешения.
• Обновляйте учётные данные, если подозреваете, что они были скомпрометированы.

Поддержка

Если вам нужна помощь с настройкой проекта Google Cloud, посетите Themesic Support Ticketing Area для получения помощи.