> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google-Workspace-Connectors

> Verbinde Gmail, Google Calendar, Contacts, Drive, Docs und Sheets mit einem einzelnen Connector oder arbeite über den Google-Workspace-Connector mit allen zusammen.

Wähle einen Connector und verbinde ihn über ein gemeinsames Konto oder das eigene Konto jeder Person. Scopes sind die Berechtigungen, die deine App bei Google anfragt. Frage also nur die an, die sie braucht.

> [!NOTE]
>
> Du benötigst einen [**Builder-Tarif**](https://base44.com/pricing) oder höher, um Connectors in deiner App zu nutzen.

***

## Was du tun kannst

Verbinde deine App mit deinen E-Mails, Kalendern, Kontakten und Dateien.

> **E-Mails automatisieren**
>
> Sende Bestätigungen und Follow-ups und mache aus eingehenden E-Mails Aufgaben oder Tickets.

> **Kalender und Kontakte synchronisieren**
>
> Synchronisiere Buchungen, zeige deine Verfügbarkeit und halte Kontakte aktuell.

> **Mit Dateien und Daten arbeiten**
>
> Speichere Berichte in Drive, erstelle Docs und importiere oder exportiere Sheets-Daten.

***

## Google-Workspace-Connector

Nutze diesen Connector, wenn deine App mehrere Google-Dienste kombiniert. Ein Beispiel ist ein Assistent, der mit deinem Posteingang, Kalender und deinen Drive-Dateien arbeitet. Wenn sie nur einen oder zwei nutzt, verbinde stattdessen diese.

**Beispiel-Prompts**

Beschreibe im KI-Chat die beteiligten Google-Dienste, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Lerne mich kennen: Überfliege meine E-Mails, Meetings und Drive-Dateien und sag mir, woran ich arbeite.
```

```text wrap theme={null}
Sei mein persönlicher Assistent: Beobachte meinen Posteingang und Kalender und sag mir, was heute meine Aufmerksamkeit braucht.
```

```text wrap theme={null}
Bereite mein nächstes Meeting aus passenden E-Mail-Verläufen, Dateien und den Details der Teilnehmenden vor.
```

```text wrap theme={null}
Entwirf nach jedem Meeting Follow-ups an die Teilnehmenden.
```

```text wrap theme={null}
Mache aus den Meetings und E-Mails dieser Woche ein Doc und ein Sheet.
```

**Scopes**

> Dieser Connector fragt die folgenden Scopes für 6 Dienste an. Er braucht also mehr Zugriff als ein einzelner Connector.
>
> * **Gmail:** `gmail.readonly`, `gmail.modify`, `gmail.compose`, `gmail.send`
> * **Calendar:** `calendar.readonly`, `calendar.settings.readonly`, `calendar.events`
> * **Contacts:** `contacts.readonly`
> * **Drive:** `drive.readonly`, `drive`
> * **Docs:** `documents.readonly`, `documents`
> * **Sheets:** `spreadsheets.readonly`, `spreadsheets`
>
> Jeder Scope wird beim jeweiligen Dienst unter [Google-Dienste](#google-services) beschrieben.
>
> **Zugriff:** Deine App arbeitet mit den Daten des Google-Kontos, das die Verbindung autorisiert.

***

## Einen Google-Dienst verbinden

Verbinde einen Google-Dienst über ein gemeinsames Konto oder lass jede Person ihr eigenes verbinden.

**Gemeinsamer Connector**

Du verbindest ein Konto einmal, und alle, die deine App nutzen, teilen diese Verbindung und ihre Daten.

**So fügst du einen gemeinsamen Google-Connector hinzu:**

1. Klicke in der Seitenleiste deines Workspaces auf **Connectors**.
2. Klicke auf **Add connector**.
3. Suche nach dem gewünschten Dienst, etwa **Google Calendar** oder **Google Workspace**, und klicke darauf.
4. Wähle **Shared connector** aus und klicke dann auf **Next**.
5. Gib einen **Connection name** ein.
6. Wähle unter **Who can access** aus, wo die Verbindung genutzt werden kann. Standard ist **Apps and Super agent**.
7. Wenn **Permissions** erscheint, wähle **Read-only**, um Daten anzusehen. Wähle **Read & write**, wenn deine App Daten senden, erstellen oder ändern muss. Standard ist **Read-only**.
8. Klicke auf **Add connector**. Melde dich dann mit dem Google-Konto an, das du teilen möchtest.
9. Öffne deine App im App-Editor.
10. Bitte den KI-Chat, die gemeinsame Google-Verbindung für die gewünschte Funktion zu nutzen.

**App-Nutzer-Connector**

Jede Person verbindet ihr eigenes Google-Konto. So arbeitet deine App mit ihren Daten. Google Calendar bietet außerdem **Let Base44 manage OAuth** an.

> [!TIP]
>
> **Bevor du beginnst:** Workspace-Owner und -Admins richten App-Nutzer-Connectors ein. Für **Let Base44 manage OAuth** brauchst du einen [Pro-Tarif](https://base44.com/pricing) oder höher. Wenn du deinen eigenen OAuth-Client nutzt, lies vor dem Bauen [Scopes und Berechtigungen](#scopes-and-permissions).

Wenn du **Let Base44 manage OAuth** für Google Calendar nutzt, springe zu **So fügst du einen App-Nutzer-Connector für Google hinzu**.

**So bereitest du deinen eigenen OAuth-Client vor:**

1. Erstelle oder wähle ein Projekt in der Google Cloud Console.
2. Aktiviere die API für jeden Google-Dienst, den deine App nutzt.
3. Richte den OAuth-Zustimmungsbildschirm mit den Scopes ein, die du anfragen möchtest.
4. Solange deine OAuth-App im Testmodus ist, füge die Google-Konten zum Testen als Testnutzer hinzu.
5. Erstelle einen OAuth-Client für eine Webanwendung.
6. Füge `https://connectors.base44.com/api/oauth/callback` als autorisierte Redirect-URI hinzu.
7. Kopiere die Client-ID und das Client-Secret.

**So fügst du einen App-Nutzer-Connector für Google hinzu:**

1. Klicke in der Seitenleiste deines Workspaces auf **Connectors**.
2. Klicke auf **Add connector**.
3. Suche nach dem gewünschten Dienst, etwa **Google Calendar** oder **Google Drive**, und klicke darauf.
4. Wähle **App user connector** aus und klicke dann auf **Next**.
5. Wenn **Choose how to manage authentication** erscheint, wähle **Let Base44 manage OAuth** oder **Use your own OAuth client**.
6. Gib einen **Connector name** ein.
7. Wenn du deinen eigenen OAuth-Client nutzt, gib dessen **Client ID** und **Client Secret** ein.
8. Entferne unter **Scopes** alle Scopes, die deine App nicht braucht. Mit deinem eigenen OAuth-Client fügst du weitere unter **Additional scopes** hinzu. Was jeder Scope bewirkt, findest du unter [Google-Dienste](#google-services).
9. Klicke auf **Add Connector**.
10. Öffne deine App im App-Editor.
11. Bitte den KI-Chat, eine Möglichkeit hinzuzufügen, mit der Personen ihr eigenes Google-Konto verbinden können.

***

## Google-Dienste

Suche den Dienst, den deine App nutzt. So siehst du, was er kann und welche Scopes er anfragt.

Andere Google-Connectors wie Google Analytics, Google Meet und Google Search Console findest du im [Connectors-Katalog](https://docs.base44.com/de/Integrations/connectors-catalog.md).

### Gmail

Sende, lies und verwalte E-Mails in [Gmail](https://base44.com/integrations/connectors/gmail).

**Beispiel-Prompts**

Beschreibe im KI-Chat die Betreffzeile, den Nachrichtentext, die Formatierung, die Empfänger und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Sende automatische Bestätigungs-E-Mails, wenn eine neue Bestellung eingeht.
```

```text wrap theme={null}
Lies und analysiere eingehende E-Mails, um Support-Tickets zu erstellen.
```

```text wrap theme={null}
Löse automatisch einen Workflow aus, wenn eine neue E-Mail eintrifft.
```

```text wrap theme={null}
Sende personalisierte Follow-up-E-Mails an neue Leads.
```

```text wrap theme={null}
Benachrichtige Teammitglieder per E-Mail, wenn ihnen Aufgaben zugewiesen werden.
```

**Scopes**

> Das Lesen von E-Mail-Inhalten ist ein eingeschränkter Google-Scope.
>
> Gmail-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `gmail.readonly`: Nachrichten und Metadaten lesen
> * `gmail.modify`: Nachrichten lesen, mit Labels versehen und ändern, aber nicht endgültig löschen
> * `gmail.compose`: Entwürfe erstellen und E-Mails senden
> * `gmail.send`: Nachrichten senden
> * `gmail.labels`: Labels verwalten
> * `gmail.settings.basic`: Filter, Signaturen und die Abwesenheitsnotiz verwalten
>
> **Zugriff:** Deine App arbeitet mit den E-Mails des Gmail-Kontos, das die Verbindung autorisiert.

### Google Calendar

Greife auf Termine in [Google Calendar](https://base44.com/integrations/connectors/google-calendar) zu und verwalte sie.

**Beispiel-Prompts**

Beschreibe im KI-Chat den Kalender, die Termine, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Synchronisiere alle meine Buchungen direkt mit meinem Google Calendar.
```

```text wrap theme={null}
Zeige Kunden meine Echtzeit-Verfügbarkeit aus Google Calendar.
```

```text wrap theme={null}
Führe eine Automatisierung aus, wenn ein Kalendertermin erstellt oder aktualisiert wird.
```

```text wrap theme={null}
Blockiere automatisch Meeting-Zeiten in meinem persönlichen Kalender.
```

```text wrap theme={null}
Füge neue Kalendertermine hinzu, wenn eine Aufgabe als erledigt markiert wird.
```

**Scopes**

> Der umfassende Scope `calendar` verwaltet jeden Kalender. Wähle einen engeren Scope, wenn deine App nur Termine oder Verfügbarkeit liest. Mit **Let Base44 manage OAuth** bietet die Auswahl nur die engeren Scopes an.
>
> Google-Calendar-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `calendar`: Alle Kalender und Termine verwalten
> * `calendar.readonly`: Alle Kalender, Termine und ihre Einstellungen ansehen
> * `calendar.events`: Termine in Kalendern verwalten
> * `calendar.events.readonly`: Termine in Kalendern ansehen
> * `calendar.events.freebusy`: Frei/Gebucht-Informationen aus Kalendern ansehen, ohne Termindetails zu sehen
> * `calendar.freebusy`: Frei/Gebucht-Informationen für Kalender ansehen
> * `calendar.app.created`: Kalender verwalten, die deine App erstellt hat
> * `calendar.calendarlist.readonly`: Die Liste der Kalender ansehen
> * `calendar.events.public.readonly`: Öffentliche Termine in Kalendern ansehen
> * `calendar.settings.readonly`: Google-Calendar-Einstellungen ansehen
>
> **Zugriff:** Deine App arbeitet mit den Kalendern des Google-Kontos, das die Verbindung autorisiert.

### Google Contacts

Lies, erstelle und verwalte Kontakte in Google Contacts.

**Beispiel-Prompts**

Beschreibe im KI-Chat die Kontakte, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Baue ein CRM, das Kunden in beide Richtungen mit meinen Google Contacts synchronisiert.
```

```text wrap theme={null}
Importiere Leads von Personen, denen ich geschrieben, die ich aber nie als Kontakt gespeichert habe.
```

```text wrap theme={null}
Analysiere mein Kontaktnetzwerk und kategorisiere Kontakte automatisch mit KI.
```

```text wrap theme={null}
Erstelle ein durchsuchbares Firmenverzeichnis aus meiner Google-Workspace-Organisation.
```

```text wrap theme={null}
Speichere neue Kunden automatisch als Kontakte, wenn sie sich registrieren.
```

**Scopes**

> Wähle `contacts.readonly`, wenn deine App nur gespeicherte Kontakte lesen muss.
>
> Google-Contacts-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `contacts.readonly`: Kontakte ansehen
> * `contacts`: Kontakte ansehen, erstellen, bearbeiten und löschen
> * `contacts.other.readonly`: Weitere Kontakte ansehen, etwa Personen, denen du geschrieben, die du aber nicht gespeichert hast
> * `directory.readonly`: Das Google-Workspace-Verzeichnis deiner Organisation ansehen
>
> **Zugriff:** Deine App arbeitet mit den Kontakten des Google-Kontos, das die Verbindung autorisiert.

### Google Drive

Suche, öffne und verwalte Dateien in [Google Drive](https://base44.com/integrations/connectors/google-drive).

**Beispiel-Prompts**

Beschreibe im KI-Chat die Dateien oder Ordner, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Liste alle Dateien in meinem Google Drive auf und zeige sie in meiner App an.
```

```text wrap theme={null}
Durchsuche Google Drive nach Dokumenten mit einem Stichwort und zeige die Ergebnisse an.
```

```text wrap theme={null}
Speichere in meiner App erstellte PDF-Berichte in Google Drive.
```

```text wrap theme={null}
Lies eine Tabelle aus Google Drive und importiere ihre Daten in meine App.
```

```text wrap theme={null}
Löse einen Workflow aus, wenn eine Datei in Drive hinzugefügt oder aktualisiert wird.
```

**Scopes**

> Der Scope `drive` gibt deiner App Zugriff auf alle Dateien und Ordner in Google Drive. `drive.file` umfasst nur die Dateien, die deine App erstellt oder öffnet.
>
> Google-Drive-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `drive`: Alle Dateien und Ordner in Google Drive ansehen, erstellen, bearbeiten und löschen
> * `drive.readonly`: Alle Dateien und Ordner in Google Drive ansehen
> * `drive.file`: Nur auf Dateien zugreifen, die deine App mit Berechtigung erstellt oder öffnet
>
> **Zugriff:** Deine App arbeitet mit Dateien im Google Drive des Google-Kontos, das die Verbindung autorisiert.

### Google Docs

Erstelle und bearbeite Dokumente in [Google Docs](https://base44.com/integrations/connectors/google-docs).

**Beispiel-Prompts**

Beschreibe im KI-Chat das Dokument, was es auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Erstelle automatisch Dokumente mit Meeting-Notizen.
```

```text wrap theme={null}
Erstelle Verträge aus Vorlagen mit Kundendaten.
```

```text wrap theme={null}
Aktualisiere geteilte Dokumente, wenn sich der Projektstatus ändert.
```

```text wrap theme={null}
Exportiere Berichte im Google-Docs-Format.
```

```text wrap theme={null}
Arbeite mit Teamkommentaren gemeinsam an Dokumenten.
```

**Scopes**

> Mit dem Scope `documents` kann deine App jedes Google-Docs-Dokument im verbundenen Konto ansehen und bearbeiten, nicht nur die selbst erstellten.
>
> Google-Docs-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `documents`: Alle Google-Docs-Dokumente ansehen, erstellen und bearbeiten
> * `documents.readonly`: Alle Google-Docs-Dokumente ansehen
>
> **Zugriff:** Deine App arbeitet mit den Dokumenten des Google-Kontos, das die Verbindung autorisiert.

### Google Sheets

Lies und schreibe Daten in Tabellen von [Google Sheets](https://base44.com/integrations/connectors/google-sheets).

**Beispiel-Prompts**

Beschreibe im KI-Chat die Tabelle, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Exportiere App-Daten in eine Google-Sheets-Tabelle.
```

```text wrap theme={null}
Importiere Leads aus einem Google Sheet in das CRM.
```

```text wrap theme={null}
Aktualisiere Lagerbestände in Google Sheets automatisch.
```

```text wrap theme={null}
Erstelle wöchentliche Berichte und speichere sie in Google Sheets.
```

```text wrap theme={null}
Synchronisiere Formulareinsendungen mit einer Google-Sheets-Datenbank.
```

**Scopes**

> Mit dem Scope `spreadsheets` kann deine App jede Tabelle im Konto ändern, nicht nur die selbst erstellten.
>
> Google-Sheets-Scope-Namen beginnen mit `https://www.googleapis.com/auth/`:
>
> * `spreadsheets`: Alle Google-Sheets-Tabellen ansehen, bearbeiten, erstellen und löschen
> * `spreadsheets.readonly`: Alle Google-Sheets-Tabellen ansehen
>
> **Zugriff:** Deine App arbeitet mit den Tabellen des Google-Kontos, das die Verbindung autorisiert.

***

## Scopes und Berechtigungen

Wenn du deinen eigenen OAuth-Client nutzt, gehört dir die OAuth-App. Du reichst ihre Verifizierung bei Google ein. Gemeinsame Google-Connectors und **Let Base44 manage OAuth** laufen über die OAuth-App von Base44. Dafür reichst du nichts bei Google ein. Siehe [Deinen eigenen OAuth-Client verwenden](https://docs.base44.com/de/Integrations/Connectors.md#using-your-own-oauth-client).

Google teilt die Berechtigungen, die deine App anfragt, in 3 Kategorien ein. Diese Gruppen bestimmen, welche Verifizierung deine App vor dem Livegang braucht. Wähle also die engsten Scopes, die die Funktionen deiner App abdecken. Das ist vor allem bei Gmail, Drive und Calendar wichtig.

* **Einfach:** Umfasst Name, E-Mail-Adresse und Profil. Google verlangt nichts weiter.
* **Sensibel:** Umfasst breiteren Zugriff auf einen Google-Dienst, etwa das Erstellen von Kalenderterminen. Google verlangt eine App-Verifizierung, einschließlich einer Prüfung deiner Datennutzung.
* **Eingeschränkt:** Umfasst das Lesen von Nachrichten- oder Dateiinhalten einer Person, etwa in Gmail. Google verlangt eine App-Verifizierung und eventuell eine jährliche unabhängige Sicherheitsbewertung.

> [!TIP]
>
> Um E-Mails ohne Verifizierung für eingeschränkte Scopes zu senden, frage nur `gmail.send` an.

Die Verifizierung für eingeschränkte Scopes kann mehrere Wochen dauern. Bis dahin kann Google die Zahl der Personen begrenzen, die deine App nutzen. Google kann außerdem eine Warnung zu einer nicht verifizierten App anzeigen. Wenn Google eine Sicherheitsbewertung verlangt, prüft ein von Google zugelassener unabhängiger Prüfer deine App nach dem CASA-Framework. Die Bewertung fragt nach der Plattform, auf der deine App läuft, und nach deinem eigenen Code. [Kontaktiere daher frühzeitig den Support](https://docs.base44.com/de/Community-and-support/Contacting-support.md). Anforderungen, Zeiträume und Ausnahmen legt Google fest. Prüfe daher [die Entwicklerdokumentation von Google](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification), bevor du damit planst.

> [!NOTE]
>
> Base44 fügt immer den Scope `email` hinzu, um das Google-Konto zu identifizieren. Er ist immer enthalten und erscheint daher unter **Scopes** als gesperrter Scope.

***

## Google-Dienste in einer Backend-Funktion nutzen

Wenn du eigene Backend-Funktionen schreibst, können sie die Google-APIs direkt aufrufen. Base44 übernimmt den OAuth-Flow und die Token-Speicherung.

Für eine gemeinsame Verbindung übergibst du eine Dienst-ID aus der Tabelle unten an `getConnection()`. Für eine App-Nutzer-Verbindung übergibst du die ID deines eigenen Connectors, keine Dienst-ID.

**Gemeinsamer Connector**

```javascript theme={null}
// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.
```

**App-Nutzer-Connector**

```javascript theme={null}
// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.
```

| Dienst | Dienst-ID (gemeinsame Verbindungen) |
| - | - |
| Gmail | `gmail` |
| Google Calendar | `googlecalendar` |
| Google Contacts | `google_contacts` |
| Google Drive | `googledrive` |
| Google Docs | `googledocs` |
| Google Sheets | `googlesheets` |
| Google Workspace | `googleworkspace` |

> **[Gemeinsame Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/shared-connectors.md)**
>
> Konfiguriere, deploye und rufe eine gemeinsame Verbindung aus einer Backend-Funktion auf.

> **[App-Nutzer-Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/app-user-connectors.md)**
>
> Rufe ein Token pro Nutzer ab und rufe die API im Namen der angemeldeten Person auf.

***

## Fehlerbehebung

Wenn du deinen eigenen OAuth-Client nutzt und Personen ihr Google-Konto nicht verbinden können, prüfe Folgendes.

> **Einige Personen können ihr eigenes Konto nicht verbinden**
>
> Dein eigener OAuth-Client startet im Testmodus. Dort können sich nur freigegebene Testnutzer verbinden. Bevor du den Zugriff erweiterst, stelle deine OAuth-App auf Produktion um. Schließe außerdem jede Verifizierung ab, die Google verlangt.

> **Das Verbinden schlägt mit einem Redirect-URI-Fehler fehl**
>
> Registriere die Callback-URL deiner Verbindung als autorisierte Redirect-URI in deinem Google-OAuth-Client:
>
> * Für die einzelne Callback-URL gib genau `https://connectors.base44.com/api/oauth/callback` ein.
> * Für Callback-URLs pro App siehe [Deine Callback-URLs ansehen](https://docs.base44.com/de/Integrations/Connectors.md#viewing-your-callback-urls).

> [!NOTE]
>
> Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.