Plainva

Konfiguracja synchronizacji Google Drive (własne dane dostępowe)

Stan na: 2026-10-09

Aby zsynchronizować lokalny vault z Google Drive w Plainva, możesz użyć własnych danych dostępowych Google API. Ponieważ Plainva nie przeszła (jeszcze) przez centralną weryfikację CASA Google, podejście Bring Your Own Credentials (BYO) oferuje bezpieczny sposób na synchronizację Twoich prywatnych plików.

Zasadniczo tworzysz sobie mały własny „projekt deweloperski” u Google, który należy wyłącznie do Ciebie i do którego dostęp masz tylko Ty.

Instrukcja krok po kroku

1. Utwórz projekt w Google Cloud Console

  1. Przejdź do Google Cloud Console.
  2. Zaloguj się na swoje konto Google.
  3. W lewym górnym rogu (obok logo Google Cloud) otwórz menu rozwijane projektu i wybierz Nowy projekt.
  4. Wpisz nazwę (np. „Plainva Sync”) i kliknij Utwórz.

2. Włącz Google Drive API

  1. Wybierz swój nowo utworzony projekt w menu rozwijanym u góry.
  2. Wyszukaj Google Drive API w górnym pasku wyszukiwania i wybierz wpis w sekcji „Marketplace”.
  3. Kliknij Włącz.

3. Skonfiguruj ekran zgody OAuth

Aby Plainva mogła używać Twoich danych dostępowych, musi zostać skonfigurowany ekran zgody („OAuth Consent Screen”). Ponieważ tylko Ty korzystasz z aplikacji, pozostaje ona w trybie „testowym”.

  1. W lewym menu bocznym pod APIs & Services otwórz OAuth consent screen.
  2. W sekcji „User Type” wybierz Zewnętrzny (chyba że korzystasz z Google Workspace) i kliknij Utwórz.
  3. Informacje o aplikacji:
    • Nazwa aplikacji: np. „Plainva”
    • E-mail wsparcia użytkownika: Twój własny adres e-mail
    • Dane kontaktowe programisty: Twój własny adres e-mail
    • Kliknij Zapisz i kontynuuj.
  4. Zakresy (Scopes):
    • Kliknij Dodaj lub usuń zakresy.
    • Wyszukaj .../auth/drive (Google Drive API, pełny dostęp) i zaznacz pole.
    • Kontekst: pełny dostęp jest potrzebny, aby Plainva mogła synchronizować także pliki, które umieścisz bezpośrednio w folderze synchronizacji przez interfejs webowy Google Drive.
    • Kliknij Aktualizuj, następnie Zapisz i kontynuuj.
  5. Użytkownicy testowi:
    • Kliknij Dodaj użytkowników.
    • Wpisz dokładnie ten adres e-mail Google, którego później użyjesz do synchronizacji w Plainva.
    • Kliknij Zapisz i kontynuuj, następnie wróć do panelu.

Ważne: nie musisz publikować aplikacji — w statusie „Testing” działa ona w pełni. Licz się jednak z tym, że Google unieważni logowanie po 7 dniach — i to na stałe: w tym trybie wygasa też token odświeżający, więc Plainva nie może go odnowić w tle. Plainva mówi o tym wprost („logowanie wygasło”), a Zaloguj się ponownie w szczegółach konta przywraca je jednym przebiegiem dla każdej usługi tego konta.

W produkcji usuwa stały termin wygaśnięcia trybu testowego. Nie gwarantuje stałego logowania: Google nadal może wygasić lub cofnąć dostęp. Wymagania dotyczące publikacji i weryfikacji zależą od zastosowania i żądanych uprawnień. Google: wygasanie tokenów odświeżania.

4. Utwórz dane dostępowe (Client ID i Secret)

  1. Otwórz Dane dostępowe (Credentials) w lewym menu.
  2. Kliknij Utwórz dane dostępowe u góry i wybierz Identyfikator klienta OAuth.
  3. Jako „Typ aplikacji” wybierz Aplikacja komputerowa (lub „Other UI”).
  4. Nazwa: np. „Plainva Desktop Client”.
  5. Kliknij Utwórz.
  6. Wyskakujące okienko pokaże Twój Client ID i Client Secret.

5. Wprowadź je w Plainva

  1. Otwórz Plainva i przejdź do ustawień vaultu (ikona zębatki przy danym vaulcie).
  2. Otwórz sekcję Synchronizacja.
  3. Wybierz Google Drive jako dostawcę.
  4. Wklej skopiowane Client ID i Client Secret w odpowiednie pola.
  5. Kliknij Połącz z Google.
  6. Otworzy się okno przeglądarki Google. Zaloguj się kontem, które dodałeś w sekcji „Użytkownicy testowi”.
  7. Google może ostrzec, że aplikacja jest niezweryfikowana. Kliknij Zaawansowane, a następnie Przejdź do Plainva (niebezpieczne).
  8. Potwierdź żądane uprawnienia.

Twój vault synchronizuje się teraz bezpiecznie z Google Drive za pomocą Twoich własnych danych dostępowych.

Google OAuth — Desktop / Android / iOS

Powyższa instrukcja dla komputera wymaga klienta typu komputerowego z identyfikatorem klienta i odpowiadającym mu sekretem. Na telefonie, zarówno na Androidzie, jak i na iOS, Plainva loguje się do Google w przeglądarce: utwórz w swoim projekcie Google klienta OAuth typu iOS, także dla Androida, z identyfikatorem pakietu com.plainva.app. Plainva wraca przez com.plainva.app:/oauth2redirect; sekretu klienta nie ma. Wpisz identyfikator klienta w formularzu Google w Plainva. Nie twórz klienta typu Android: Google dopuszcza nazwę pakietu i odcisk certyfikatu wersji z Play w dokładnie jednym projekcie na świecie i odrzuca każdy kolejny („nazwa pakietu Androida i odcisk cyfrowy są już używane”). Klient Android skonfigurowany dla Plainva 0.8.3 lub 0.8.4 nie działa przy nowym logowaniu; konta już zalogowane działają dalej. Klient komputerowy nie zastępuje rejestracji mobilnej. Dla kalendarzy włącz dodatkowo Google Calendar API i Google Tasks API.

Google: iOS / Desktop · Google: Android

Dodawaj pliki, kalendarz lub pocztę do właściwego konta. Plainva sprawdza wybrane logowanie i prosi o brakujące uprawnienia.

Rejestracja Google nie pasuje do ścieżki powrotu tego urządzenia. Sprawdź typ klienta i konfigurację mobilną w instrukcji Google.

Ogólny błąd logowania nie ujawnia stanu publikacji ani listy użytkowników testowych projektu Google. Sprawdź je w Google Cloud oraz przeczytaj konkretny komunikat dostawcy. Klient komputerowy wymaga ID i odpowiedniego klucza; rejestracja mobilna zależy od platformy i zainstalowanej kompilacji.