Google Drive

Google Drive Integráció

Az alkalmazás támogatja a képek közvetlen kezelésétGoogle Drive-ról.

---

📚 Google Drive Miről?

A Google Drive integráció lehetővé teszi:

• Képek direkt Driveről feldolgozása (letöltés nélkül)
• Google Fotók Könyvtár feldolgozása
• Cloud Sync — A Drive és a helyi adatbázis szinkronban marad
• Szinkronizálva képek — Módosított képek automatikusan frissülnek

---

🔑 1. Google OAuth 2.0 Beállítása

Google Console Belépés

1. Nyiss meg: https://console.developers.google.com/
2. Bejelentkezés a Google fiókodba
3. Új projekt létrehozása (pl. "Face-Local")

API-k Engedélyezése

1. APIs & Services → Library szekció
2. A keresésben: Google Drive API
3. Google Drive API kiválasztása
4. ENABLE gombra kattintás
5. Ugyanez a Google Photos Library API számára

OAuth 2.0 Credentials Létrehozása

1. APIs & Services → Credentials szekció
2. Create Credentials → OAuth 2.0 Client IDs
3. Application type: Desktop application
4. Kitöltés:
   • Name: "Face-Local"
   • Authorized redirect URIs: http://localhost:8080/callback
5. Create gombra kattintás

Credentials Letöltése

1. A létrehozott credentials-re kattintás
2. Download JSON gombra kattintás
3. A fájlt mentsd el: google_credentials.json

---

🔐 2. Az Alkalmazás Konfigurálása

.env Fájl Létrehozása

A projektmappában létrehozz egy .env fájlt:

cat > .env << EOF
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
EOF

Az értékeket a letöltött JSON-ből másold:

{
  "client_id": "123456789.apps.googleusercontent.com",  // Ez az ID
  "client_secret": "abcdefgh_secret"  // Ez a secret
}

config.yaml Módosítása

Opcionálisan a config.yaml-ben:

google_drive:
  enabled: true
  client_id: "YOUR_CLIENT_ID"
  client_secret: "YOUR_CLIENT_SECRET"
  cache_dir: ~/.cache/face-local/gdrive
  sync_enabled: true

---

🔗 3. Google Drive Hitelesítése

Első Hitelesítés

1. Az alkalmazást indítod
2. Settings dialógus → Google Drive fülön
3. A [Authenticate with Google] gombra kattintasz
4. Az alkalmazás egy weboldalt nyit meg a böngészőben
5. Google fiók bejelentkezése (ha szükséges)
6. Allow gombra kattintás az alkalmazás hozzáféréséhez

Az alkalmazás egy token-t kap, amelyet felhasznál az API-khoz való hozzáféréshez.

Hitelesítés Eltávolítása

Ha le szeretnéd csatlakoztatni a Google Drive-ot:

1. Settings → Google Drive fülön
2. A [Disconnect] gombra kattintasz
3. Az alkalmazás törlésre kerül a Drive-os engedélyezések közül

---

📁 4. Google Drive Mappa Megnyitása

Mappa Kiválasztása

Az alkalmazásban:

1. File → Open Library
2. A [Browse Google Drive] gombra kattintasz
3. A Google Drive mappastruktúrája megjelenik
4. Az feldolgozandó mappádat kiválasztod
5. OK gombra kattintasz

Drive Mappa Szinkronizálása

Az alkalmazás:

1. Feldolgozza a képeket a Drive-ról
2. Az eredményes adatbázis a helyi gépen marad
3. Az eredeti képek a Drive-on maradnak (nem törlődnek)

---

🔄 5. Szinkronizálás

Automatikus Szinkronizálás

Ha engedélyezve van:

google_drive:
  sync_enabled: true

Az alkalmazás:

1. Bejelentkezéskor szinkronizálja a Drive módosításait
2. Feldolgozás közben új Drive képeket azonosít
3. Kilépéskor elmenti az adatbázist

Manuális Szinkronizálás

Ha szükséges azonnali szinkronizálás:

1. Tools → Google Drive → Sync Now
2. Az alkalmazás frissítési ellenőrizódik az új Drive képeket
3. Az új képek feldolgozódnak

Szinkronizálás Konfliktusai

Ha egy képet helyileg és a Drive-on módosítottál:

Conflict detected:
├─ Local version: 2026-06-01 14:30
├─ Drive version: 2026-06-01 15:00
└─ Choose: [Use Local] [Use Drive]

---

📸 Google Fotók Könyvtár

Az alkalmazás támogatja a Google Fotók Könyvtár feldolgozását:

Fotók Könyvtár Feltárása

1. File → Open Library
2. [Google Photos Library] gombra kattintás
3. Az alkalmazás az összes Fotók albumat megjeleníti
4. Az feldolgozni kívánt albumot kiválasztod
5. OK gombra kattintás

Az alkalmazás:

1. Le nem tölti az összes képet (csak szükség szerint)
2. Feldolgozódik a metaadatok alapján
3. Az arcok azonosítódnak a képekből

---

💾 6. Google Drive Cache

Az alkalmazás a Google Drive adatokat gyorsítótárazza (cache):

Cache Helye

~/.cache/face-local/gdrive/
├─ metadata.json       (fotók metaadata)
├─ thumbnails/        (kicsi képek)
└─ ...

Cache Kezelése

A cache automatikusan kezelhető, de manuálisan is törlhetheted:

1. Settings → Storage fülön
2. Clear Google Drive Cache gombra kattintás
3. Az alkalmazás a cache-et újra letölti az API-ból

---

🔐 7. Biztonsági Megjegyzések

⚠️ Fontos

• Soha ne osszuk meg a GOOGLE_CLIENT_SECRET-et
• Ellenőrizd, hogy a .env fájl gitignore-ba van
• Csak megbízható networkről csatlakozz a Google Drive-hoz

.gitignore

A .env fájl biztos legyen a .gitignore-ban:

echo ".env" >> .gitignore

Token Tárolása

Az alkalmazás a token-eket az alábbi helyen tárja:

~/.config/face-local/google_token.json

Ez a fájl szenzitív, nem szabad megosztani!

---

🐛 Gyakori Google Drive Problémák

Probléma: "Authentication Failed"

Oka: A token lejárt vagy érvénytelen.

Megoldás:

1. Settings → Google Drive fülön
2. [Re-authenticate] gombra kattintás
3. Újra bejelentkezés a Google fiókba

Probléma: "Drive Mappa Nem Érhető El"

Oka: A mappa törölve lett vagy nincs jogosultságod.

Megoldás:

1. Ellenőrizd, hogy a mappa még létezik-e a Drive-on
2. Sharing beállítások ellenőrzése
3. Egy másik mappát próbálj meg

Probléma: "Sync Conflict"

Oka: Az alkalmazás nem tudja, melyik verzióval menjen.

Megoldás:

• Az alkalmazás felkér, hogy válassz: Use Local vagy Use Drive
• Válaszd a frissebbet (vagy a megbízhatóbbat)

Probléma: "API Quota Exceeded"

Oka: Túl sokszor kérdezted le az API-t.

Megoldás:

1. Várakozz néhány percet
2. Az API quota percenként újraszámítódik
3. Próbáld újra később

---

📖 Kapcsolódó Oldalak

• Beállítások — Google Drive beállítások
• Telepítés — OAuth konfigurálása
• Keresés & Szűrés — Drive mappákat böngészni