#Налаштування Google

This feature is provided by the commercial plugin «Поштовий менеджер», please purchase to use

#Передумови

Щоб користувачі могли підключати свої облікові записи Google Mail до 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".

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

3. Знайдіть "mail".

4. Натисніть кнопку "ENABLE", щоб увімкнути Gmail API.

#Налаштування екрана згоди OAuth

1. Натисніть меню "OAuth consent screen" ліворуч.

2. Виберіть "External".

3. Заповніть інформацію про проєкт (вона відображатиметься на сторінці авторизації) і натисніть "Зберегти".

4. Заповніть контактну інформацію розробника та натисніть "Продовжити".

5. Натисніть "Продовжити".

6. Додайте тестових користувачів для перевірки перед публікацією застосунку.

7. Натисніть "Продовжити".

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

#Створення облікових даних

1. Натисніть меню "Credentials" ліворуч.

2. Натисніть кнопку "CREATE CREDENTIALS" і виберіть "OAuth client ID".

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".

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. Якщо перевірка ще не завершена, користувачі можуть натиснути небезпечне посилання, щоб авторизуватися та увійти.