Google Docs

Diese Anleitung zeigt dir, wie du ein Google Docs-Dokument (z. B. mit Platzhaltern wie {{Name}}) von außen befüllen kannst – etwa in einem Script oder über eine API. Ideal für automatisierte Dokumentenerstellung, Vorlagen oder Berichte.

---

🧰 Voraussetzungen

Bevor du die Google Docs API verwenden kannst, benötigst du ein eingerichtetes Google Cloud-Projekt mit aktivierten APIs und einem Service Account.

🪣 Google Cloud-Projekt anlegen

1. Öffne die Google Cloud Console: https://console.cloud.google.com

2. Klicke auf „Neues Projekt erstellen“.

3. Gib deinem Projekt einen Namen und bestätige.

---

⚙️ APIs aktivieren

1. Navigiere zu „APIs & Services → Library“.

2. Aktiviere folgende APIs:

   • Google Docs API

   • Google Drive API

Die Google Drive API ist erforderlich, damit dein Service Account auf das Dokument zugreifen kann.

---

🔑 Service Account erstellen

1. Öffne „IAM & Admin → Service Accounts“.

2. Klicke auf „Service Account erstellen“ (z. B. mit dem Namen doc-writer).

3. Erstelle und lade den JSON-Schlüssel herunter – dieser enthält die Anmeldedaten, die du später im Code verwendest.

Bewahre die JSON-Datei sicher auf! Sie enthält sensible Zugangsdaten und sollte niemals öffentlich geteilt werden.

---

🔓 Zugriffsrechte vergeben

1. Öffne dein gewünschtes Google Docs-Dokument.

2. Klicke auf Teilen.

3. Füge die E-Mail-Adresse deines Service Accounts hinzu, z. B.: [email protected]

4. Wähle die Berechtigung „Editor“, damit die API Inhalte ändern darf.

Verwende separate Service Accounts für verschiedene Projekte oder Systeme, um Zugriffe klar zu trennen.

---

✏️ Inhalt ändern (Platzhalter ersetzen)

1. Dokumenten-ID ermitteln

Die Dokumenten-ID findest du in der URL deines Google Docs: https://docs.google.com/document/d/1ABCxyz1234567/edit

➡️ Dokumenten-ID: 1ABCxyz1234567

2. Beispiel: Platzhalter ersetzen

Mit der Google Docs API kannst du Platzhalter wie {{Name}} direkt im Dokument austauschen.

POST https://docs.googleapis.com/v1/documents/1ABCxyz1234567:batchUpdate
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "requests": [
    {
      "replaceAllText": {
        "containsText": {
          "text": "{{Name}}",
          "matchCase": true
        },
        "replaceText": "Max Mustermann"
      }
    }
  ]
}

Du kannst mehrere Platzhalter gleichzeitig ersetzen, indem du mehrere replaceAllText-Objekte im requests-Array definierst.

Verwende klar definierte Platzhalter wie {{Name}} oder {{Adresse}}, um Verwechslungen mit normalem Text zu vermeiden.

---

✅ Ergebnis

Nach erfolgreicher Ausführung wird das Dokument automatisch aktualisiert – alle Vorkommen von {{Name}} werden durch den angegebenen Text ersetzt.

Beispielausgabe:

{
  "documentId": "1ABCxyz1234567",
  "replies": [
    { "replaceAllText": { "occurrencesChanged": 1 } }
  ]
}

Dein Google Docs-Dokument wurde erfolgreich befüllt! Du kannst diesen Prozess in Automatisierungen, Skripten oder Workflows verwenden, um personalisierte Dokumente zu generieren.