Dodawanie kanału Google Drive

Co przygotować przed rozpoczęciem

Przygotuj te elementy:

Wymaganie	Dlaczego jest potrzebne
Konto Google	Do Google Cloud i autoryzacji Google Drive
Projekt Google Cloud	Do włączenia Drive API i utworzenia danych OAuth
Klient OAuth 2.0	Pozwala ImgHost uzyskać Client ID, Client Secret i Refresh Token
Domena ImgHost	Do URI przekierowania OAuth. Musi odpowiadać faktycznie używanej domenie.

Konfiguracja

Krok 1: Włącz Google Drive API

1. Otwórz Google Cloud Console.
2. Utwórz nowy projekt albo wybierz istniejący.
3. Przejdź do APIs & Services.
4. Kliknij Enable APIs and Services.
5. Wyszukaj Google Drive API.
6. Otwórz i włącz API.

Krok 2: Skonfiguruj ekran zgody OAuth

1. W Google Cloud otwórz Google Auth Platform.
2. Uzupełnij podstawowe informacje w Branding, takie jak nazwa aplikacji, e-mail pomocy i kontakt deweloperski.
3. Otwórz Audience.
4. Dla większości prywatnych instalacji self-hosted wybierz External.
5. Jeśli wybierasz External, dodaj konto Google do autoryzacji w Test users.
6. Otwórz Data Access.
7. Dodaj wymagane uprawnienia Google Drive.

Krok 3: Utwórz klienta OAuth 2.0

1. W Google Auth Platform otwórz Clients.
2. Utwórz nowego klienta.
3. Ustaw typ aplikacji na Web application.
4. Nadaj klientowi czytelną nazwę.
5. W authorized JavaScript origins wpisz URL ImgHost, na przykład:

https://img.example.com

6. W authorized redirect URIs wpisz:

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

Po utworzeniu skopiuj:

Wygenerowana wartość	Pole ImgHost
Client ID	Client ID
Client Secret	Client Secret

Krok 4: Wypełnij kanał Google Drive

W Ustawieniach przesyłania wybierz Google Drive i wypełnij:

Pole ImgHost	Co wpisać
Nazwa kanału	Czytelna nazwa, np. Main Google Drive
Client ID	Client ID z Google Cloud
Client Secret	Client Secret z Google Cloud
Refresh Token	Na razie zostaw puste. Pobierzesz je w kolejnym kroku.
Katalog główny	Opcjonalnie. Domyślnie imgbed.

Krok 5: Pobierz Refresh Token

1. Kliknij Get Token.
2. Wybierz konto Google, które chcesz podłączyć.
3. Przejdź przez autoryzację.
4. Strona callback pokaże Refresh Token.
5. Skopiuj go.
6. Wróć do ImgHost i wklej go w polu Refresh Token.

Jeśli później zmienisz konto Google, klienta OAuth albo stara autoryzacja wygaśnie, nie musisz usuwać kanału. Otwórz stronę edycji i kliknij Reauthorize.

Krok 6: Zapisz kanał

Po wypełnieniu wszystkich pól zapisz kanał.

Szybki przebieg

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

Referencje

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