#Настройка Google

This feature is provided by the commercial plugin «Управление почтой», please purchase to use

#Предварительные условия

Чтобы пользователи могли подключать свои аккаунты Google Почты к NocoBase, система должна быть развернута на сервере с доступом к сервисам Google, так как бэкенд будет вызывать Google API.

#Регистрация аккаунта

1. Откройте https://console.cloud.google.com/welcome, чтобы перейти в Google Cloud.
2. При первом входе вам потребуется принять условия использования.

#Создание приложения

1. Нажмите "Select a project" (Выбрать проект) в верхней части страницы.

2. Нажмите кнопку "NEW PROJECT" (Новый проект) во всплывающем окне.

3. Заполните информацию о проекте.

4. После создания проекта выберите его.

#Включение Gmail API

1. Нажмите кнопку "APIs & Services" (API и сервисы).

2. Перейдите на панель управления "APIs & Services".

3. Введите "mail" в поиске.

4. Нажмите кнопку "ENABLE" (Включить), чтобы активировать Gmail API.

#Настройка экрана согласия OAuth

1. Нажмите на пункт меню "OAuth consent screen" (Экран согласия OAuth) слева.

2. Выберите "External" (Внешний).

3. Заполните информацию о проекте (она будет отображаться на странице авторизации) и нажмите "Сохранить".

4. Заполните контактную информацию разработчика (Developer contact information) и нажмите "Продолжить".

5. Нажмите "Продолжить".

6. Добавьте тестовых пользователей для проверки приложения перед его публикацией.

7. Нажмите "Продолжить".

8. Просмотрите сводную информацию и вернитесь на панель управления.

#Создание учетных данных

1. Нажмите на пункт меню "Credentials" (Учетные данные) слева.

2. Нажмите кнопку "CREATE CREDENTIALS" (Создать учетные данные) и выберите "OAuth client ID" (Идентификатор клиента OAuth).

3. Выберите "Web application" (Веб-приложение).

4. Заполните информацию о приложении.

5. Введите домен, на котором будет развернут проект (здесь в качестве примера используется тестовый адрес NocoBase).

6. Добавьте авторизованный URI перенаправления. Он должен быть в формате домен + "/admin/settings/mail/oauth2". Пример: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. Нажмите "Создать", чтобы просмотреть информацию OAuth.

8. Скопируйте Client ID и Client secret и вставьте их на страницу настройки почты.

9. Нажмите "Сохранить", чтобы завершить настройку.

#Публикация приложения

После завершения описанных выше шагов и тестирования таких функций, как авторизация тестовых пользователей и отправка электронной почты, вы можете опубликовать приложение.

1. Нажмите на пункт меню "OAuth consent screen" (Экран согласия OAuth).

2. Нажмите кнопку "EDIT APP" (Редактировать приложение), затем нажмите кнопку "SAVE AND CONTINUE" (Сохранить и продолжить) внизу.

3. Нажмите кнопку "ADD OR REMOVE SCOPES" (Добавить или удалить области), чтобы выбрать области разрешений пользователя.

4. Введите "Gmail API" для поиска, затем установите флажок "Gmail API" (убедитесь, что значение области действия (Scope) соответствует Gmail API с "https://mail.google.com/").

5. Нажмите кнопку "UPDATE" (Обновить) внизу, чтобы сохранить изменения.

6. Нажимайте кнопку "SAVE AND CONTINUE" (Сохранить и продолжить) внизу каждой страницы, а затем нажмите кнопку "BACK TO DASHBOARD" (Вернуться на панель управления), чтобы вернуться на страницу панели управления.

7. Нажмите кнопку "PUBLISH APP" (Опубликовать приложение). Появится страница подтверждения публикации, где будет перечислен необходимый контент для публикации. Затем нажмите кнопку "CONFIRM" (Подтвердить).

8. Вернитесь на страницу консоли, и вы увидите, что статус публикации изменился на "In production" (В производстве).

9. Нажмите кнопку "PREPARE FOR VERIFICATION" (Подготовиться к проверке), заполните необходимую информацию и нажмите кнопку "SAVE AND CONTINUE" (Сохранить и продолжить) (данные на изображении приведены только для примера).

10. Продолжайте заполнять необходимую информацию (данные на изображении приведены только для примера).

11. Нажмите кнопку "SAVE AND CONTINUE" (Сохранить и продолжить).

12. Нажмите кнопку "SUBMIT FOR VERIFICATION" (Отправить на проверку), чтобы отправить запрос на проверку.

13. Дождитесь результатов проверки.

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