Добавление канала Google Drive

Что подготовить сначала

Перед началом подготовьте:

Что нужно	Зачем это нужно
Аккаунт Google	Для доступа к Google Cloud и авторизации Google Drive
Проект Google Cloud	Для включения Drive API и создания OAuth credentials
OAuth 2.0 client	ImgHost использует его для получения Client ID, Client Secret и Refresh Token
Ваш домен ImgHost	Для OAuth redirect URI. Он должен совпадать с доменом, который вы реально используете.

Настройка

Шаг 1. Включите Google Drive API

1. Откройте Google Cloud Console.
2. Создайте новый проект или выберите существующий.
3. Перейдите в APIs & Services.
4. Нажмите Enable APIs and Services.
5. Найдите Google Drive API.
6. Откройте его и нажмите enable.

Шаг 2. Настройте OAuth Consent Screen

1. В Google Cloud откройте Google Auth Platform.
2. Заполните базовую информацию Branding: имя app, support email и developer contact email.
3. Откройте Audience.
4. Для большинства личных self-hosted развертываний выберите External.
5. Если выбран External, добавьте Google-аккаунт, который хотите авторизовать, в Test users.
6. Откройте Data Access.
7. Добавьте нужные permissions для Google Drive.

Шаг 3. Создайте OAuth 2.0 Client

1. В Google Auth Platform откройте Clients.
2. Создайте новый client.
3. Установите application type как Web application.
4. Дайте client понятное имя.
5. Для authorized JavaScript origins введите URL ImgHost, например:

https://img.example.com

6. Для authorized redirect URIs введите:

https://img.example.com/api/oauth/google/callback

После создания client скопируйте:

Сгенерированное значение	Поле ImgHost
Client ID	Client ID
Client Secret	Client Secret

Шаг 4. Заполните канал Google Drive

В настройках загрузки выберите Google Drive и заполните:

Поле ImgHost	Что ввести
Channel name	Понятное имя, например Main Google Drive
Client ID	Client ID из Google Cloud
Client Secret	Client Secret из Google Cloud
Refresh Token	Пока оставьте пустым. Получите его на следующем шаге.
Root directory	Необязательно. По умолчанию imgbed.

Шаг 5. Получите Refresh Token

1. Нажмите Get Token.
2. Выберите Google-аккаунт, который хотите подключить.
3. Пройдите подсказки авторизации.
4. На callback-странице появится Refresh Token.
5. Скопируйте его.
6. Вернитесь в ImgHost и вставьте его в поле Refresh Token.

Если позже вы смените Google-аккаунт, OAuth client или старая авторизация истечет, удалять канал не нужно. Откройте страницу редактирования и нажмите Reauthorize.

Шаг 6. Сохраните канал

Когда все поля заполнены, сохраните канал.

Короткий сценарий

Open Google Cloud
-> Create or select a project
-> Enable Google Drive API
-> Configure Google Auth Platform
-> If Audience is External, add your Google account to Test users
-> Create a Web application OAuth client
-> Use https://your-domain.com/api/oauth/google/callback as the redirect URI
-> Fill Client ID and Client Secret into ImgHost
-> Click Get Token
-> Sign in with Google and authorize
-> Copy the Refresh Token from the callback page
-> Paste it back into ImgHost and save
-> Upload a test image

Ссылки

1. Google OAuth Web Server Applications: https://developers.google.com/identity/protocols/oauth2/web-server
2. Google Workspace OAuth Consent Configuration: https://developers.google.com/workspace/guides/configure-oauth-consent
3. Google Drive API Auth Scopes: https://developers.google.com/workspace/drive/api/guides/api-specific-auth