Google Drive verbinden (Dienstkonto einrichten)

Google Drive Portal verbindet sich mit Google Drive über ein Dienstkonto (service account): eine technische Google-Identität, die du kostenlos in deinem eigenen Google-Cloud-Projekt erstellst. Du lädst seinen Schlüssel herunter (eine kleine JSON-Datei), gibst ihn dem Plugin und teilst einen Drive-Ordner mit der Adresse des Dienstkontos. Diese ganze Anleitung dauert etwa 10 Minuten.

Bevor du beginnst

• Ein Google-Konto, das den Drive-Ordner öffnen kann, den du anzeigen möchtest (ein normales Gmail-Konto oder ein Google-Workspace-Konto).
• Das Plugin ist installiert und aktiviert (siehe Die kostenlose Version installieren).
• Öffne in WordPress Drive Documents > Portal. Lass diese Seite in einem Browser-Tab offen: Die Karte Start here (hier beginnen) zeigt deinen Fortschritt, und der Bereich Connect Google Drive enthält direkte Links zu den Google-Seiten, die unten verwendet werden.

Schritt A: ein Google-Cloud-Projekt erstellen

Ein Projekt ist ein Container in Google Cloud, der deine Einstellungen enthält. Es ist kostenlos: Dieses Plugin nutzt die Drive API, die bei normaler Nutzung nichts kostet.

1. Gehe zu console.cloud.google.com/projectcreate und melde dich mit deinem Google-Konto an. Beim ersten Besuch akzeptierst du die Nutzungsbedingungen.
2. Gib bei Project name einen Namen ein, den du wiedererkennst, zum Beispiel Website-Dokumente.
3. Lass die anderen Felder, wie sie sind, und klicke auf Create.
4. Warte ein paar Sekunden und stelle dann sicher, dass das neue Projekt in der Projektauswahl oben in der Console ausgewählt ist.

Du kannst auch ein Projekt verwenden, das du schon hast.

Schritt B: die Google Drive API aktivieren

1. Öffne die Seite der Google Drive API (oder im Menü der Console APIs and services > Library und suche nach Google Drive API).
2. Prüfe, dass oben dein Projekt ausgewählt ist.
3. Klicke auf Enable.

Wenn du diesen Schritt überspringst, meldet das Plugin später: The Google Drive API is not enabled on this project. (Die Google Drive API ist in diesem Projekt nicht aktiviert.)

Schritt C: das Dienstkonto erstellen

1. Öffne IAM and admin > Service accounts.
2. Klicke auf Create service account.
3. Gib ihm einen beliebigen Namen, zum Beispiel wordpress-portal. Google füllt eine ID für dich aus.
4. Klicke auf Create and continue.
5. Die nächsten Bildschirme fragen nach Rollen und Nutzerzugriff. Vergib nichts: Klicke einfach auf Continue und dann auf Done. Das Dienstkonto braucht keine Cloud-Rolle.

Schritt D: den JSON-Schlüssel herunterladen

1. Klicke in der Liste der Dienstkonten auf das, das du gerade erstellt hast.
2. Öffne den Tab Keys.
3. Klicke auf Add key > Create new key.
4. Wähle JSON und klicke auf Create.
5. Eine .json-Datei wird auf deinen Computer heruntergeladen.

Schritt E: dem Plugin den Schlüssel geben

1. Gehe zurück zu WordPress, Drive Documents > Portal, Bereich Connect Google Drive.
2. Wähle unter Choose the JSON file (JSON-Datei auswählen) die heruntergeladene Datei. Oder füge unter Or paste its content (oder ihren Inhalt einfügen) den ganzen Inhalt der Datei ein (öffne sie mit einem beliebigen Texteditor und kopiere alles, von der ersten { bis zur letzten }).
3. Klicke auf Save the key.

Das Plugin prüft den Schlüssel sofort bei Google. Wenn es klappt, siehst du: Key saved and accepted by Google. Now share the Drive folder with ... , as Viewer. (Schlüssel gespeichert und von Google akzeptiert. Teile jetzt den Drive-Ordner.) Das Feld zeigt dann Connected to Google Drive mit der Adresse des Dienstkontos, die etwa so aussieht: name@project-id.iam.gserviceaccount.com.

Schritt F: den Drive-Ordner mit dem Dienstkonto teilen

Das Dienstkonto sieht nichts in deinem Drive, bis du einen Ordner mit ihm teilst. Das Teilen entscheidet, was das Portal anzeigen kann.

1. Klicke auf der Plugin-Seite im Bereich Share a Drive folder auf Copy neben der Adresse des Dienstkontos.
2. Öffne Google Drive und suche den Ordner, den du auf der Website anzeigen möchtest.
3. Klicke mit der rechten Maustaste auf den Ordner und wähle Share (auf manchen Bildschirmen Share > Share).
4. Füge die Adresse des Dienstkontos in das Feld Add people ein.
5. Setze die Rolle auf Viewer. Viewer reicht: Das Plugin schreibt nie in Drive.
6. Klicke auf Send (oder Share). Wenn Google warnt, dass die Adresse außerhalb deiner Organisation liegt, ist das normal: Bestätige.
7. Gehe zurück zu WordPress und lade die Seite Drive Documents > Portal neu. Der Ordner erscheint in der Liste Folders the service account can see (Ordner, die das Dienstkonto sehen kann).

Alles im geteilten Ordner ist für das Plugin sichtbar, auch Unterordner und Dateien, die du später hinzufügst. Sonst nichts in deinem Drive.

Schritt G: die Verbindungsprüfung ausführen

1. Klicke im Bereich Connect Google Drive unter Connection check auf Run check.
2. Das Plugin führt echte Abfragen bei Google aus und zeigt, was zurückkommt. Der letzte Abschnitt, Reading, sagt dir in einfachen Worten, was zu tun ist.

Wenn alles in Ordnung ist, steht dort: Everything works: the service account sees 1 shared folder. You can now pick it with the Browse button next to a rule. (Alles funktioniert: Das Dienstkonto sieht 1 geteilten Ordner. Du kannst ihn jetzt mit dem Button Browse neben einer Regel auswählen.) Mach jetzt weiter mit Festlegen, wer welchen Ordner sieht.

Weitere Buttons im Bereich Connect Google Drive

• Replace the key (öffne zuerst Replace the key with a new one): Wähle oder füge einen neuen Schlüssel ein, der den gespeicherten ersetzt (zum Beispiel nachdem du den alten Schlüssel in Google Cloud gelöscht hast).
• Clear cache: vergisst die vom Plugin gespeicherten Listen und fragt Google erneut.
• Remove the key: trennt die Website. Das Portal bleibt offline, bis ein neuer Schlüssel gespeichert wird.

Installation auf mehreren Kunden-Websites

Jede Website sollte ihr eigenes Google-Cloud-Projekt und ihr eigenes Dienstkonto verwenden. Zwischen den Websites wird nichts geteilt, und im Code muss nichts bearbeitet werden: Jede Website zeigt ihre eigene Adresse an, mit der du den Ordner teilst.