> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail: OAuth

> Настройка OAuth Gmail для коннектора

В этом разделе описана настройка коннектора Gmail с помощью приложения Google с поддержкой OAuth.
Это может сделать любой (даже без платного Google Workspace)!

Если вы организация с Google Workspace и предпочитаете использовать сервисный аккаунт для доступа к Gmail, см.
раздел [здесь](./service_account).

### Авторизация

**1. Создайте проект Google Cloud**

* [https://console.cloud.google.com/projectcreate](https://console.cloud.google.com/projectcreate)

**2. Включите Gmail API**

* На левой панели откройте **APIs & services**
* Перейдите в **Enabled APIs and services**
* Вверху нажмите **+ENABLE APIS AND SERVICES**
* Найдите **Gmail API** и нажмите **ENABLE**
* Либо откройте эту [ссылку](https://console.cloud.google.com/apis/enableflow?apiid=gmail.googleapis.com), выберите свой проект и включите **Gmail API**

**3. Настройте экран согласия OAuth**

* В разделе **APIs & services** выберите вкладку **OAuth consent screen**
* Если у вас нет **Google Organization**, выберите **External** в **User Type**
* Назовите приложение Yahont (или как хотите)
* В качестве обязательных адресов электронной почты используйте любые на ваш выбор или `support@yahont.ai`, если хотите, чтобы команда Yahont помогала решать проблемы.
* Нажмите **SAVE AND CONTINUE**

**4. Настройте области**

* Добавьте область `.../auth/gmail.readonly` для `Gmail API`

> [!NOTE]
>
> Чтобы включить синхронизацию прав для этого коннектора:
>
> * Включите **Admin SDK API** (откройте ссылку: [https://console.cloud.google.com/flows/enableapi?apiid=admin.googleapis.com](https://console.cloud.google.com/flows/enableapi?apiid=admin.googleapis.com)) и включите его для своего проекта.
> * Добавьте область `.../auth/admins.directory.user.readonly` для `Admin SDK API`.
> * Добавьте область `.../auth/admins.directory.group.readonly` для `Admin SDK API`.
> * Аккаунт, проходящий процесс OAuth, должен иметь роль администратора в Google Workspace
>   с доступом к привилегии «Groups > Read». Это можно задать в Google Admin Console в разделе Account > Admin roles.

![Экран согласия Google Cloud OAuth с выбранной областью Gmail readonly](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/gmail/GmailScopes.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=c9dfed1dd1b1cf2897e58f9c2c406246)

**5. Настройте тестовых пользователей**

* Это относится только к пользователям без Google Organization.
* Добавьте хотя бы один адрес электронной почты тестового пользователя.
  Только аккаунты, добавленные здесь, смогут проходить процесс OAuth для индексации новых писем.
* Нажмите **SAVE AND CONTINUE**, проверьте изменения и нажмите **BACK TO DASHBOARD**

**6. Создайте учётные данные OAuth**

* Откройте вкладку **Credentials** и выберите **+ CREATE CREDENTIALS** -> **OAuth client ID**

![Создание OAuth client ID в Google Cloud Console для Gmail](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/google_drive/GoogleDriveCredential.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=7d4cc228c2ec96cad42881b7b240e23b)

* Выберите **Web application** и задайте имя, например `YahontConnector`
* Добавьте **Authorized JavaScript origins**
* `http://localhost:3000` при самостоятельном размещении
* `https://<INTERNAL_DEPLOYMENT_URL>`, если вы настроили Yahont для рабочего использования
* `https://cloud.yahont.ai`, если вы используете сервис Yahont Cloud
* Добавьте **Authorized redirect URIs**
* `http://localhost:3000/admin/connectors/gmail/auth/callback` при самостоятельном размещении
* `https://<INTERNAL_DEPLOYMENT_URL>/admin/connectors/gmail/auth/callback`, если вы настроили Yahont для рабочего использования
* `https://cloud.yahont.ai/admin/connectors/gmail/auth/callback`, если вы используете сервис Yahont Cloud

![Authorized origins и redirect URIs для клиента Gmail OAuth](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/gmail/GmailCredentials.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=c6a94ccfd2553d41109a9645e940850b)

* Нажмите create, и справа рядом с **Client secret**
  есть возможность скачать учётные данные в виде JSON. Скачайте JSON для использования на следующем шаге.

![Скачивание учётных данных клиента OAuth в формате JSON из Google Cloud Console](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/google_drive/DriveDownloadCredentials.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=3c99a970f4a5e38948ade317ceb4e78b)

### Индексирование

Сначала откройте панель администратора и выберите коннектор Gmail.

Затем нажмите **Create New**. В разделе **Option 1: OAuth app** загрузите (или вставьте) JSON приложения OAuth,
скачанный выше, затем нажмите **Authenticate with Gmail** и продолжите с аккаунтом,
который хотите использовать для индексации Gmail.

После завершения выберите созданные учётные данные и нажмите кнопку **Continue**, чтобы настроить коннектор!

> [!NOTE]
>
> JSON приложения сохраняется в созданных учётных данных,
> поэтому каждые учётные данные OAuth несут собственное приложение.
> Чтобы добавить больше коннекторов для того же аккаунта, выберите существующие учётные данные из списка,
> а не создавайте новые. В одном инстансе может быть несколько учётных данных Gmail.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.