Google-Workspace-Connectors

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.

Du benötigst einen Builder-Tarif 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:

Lerne mich kennen: Überfliege meine E-Mails, Meetings und Drive-Dateien und sag mir, woran ich arbeite.

Sei mein persönlicher Assistent: Beobachte meinen Posteingang und Kalender und sag mir, was heute meine Aufmerksamkeit braucht.

Bereite mein nächstes Meeting aus passenden E-Mail-Verläufen, Dateien und den Details der Teilnehmenden vor.

Entwirf nach jedem Meeting Follow-ups an die Teilnehmenden.

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 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
App-Nutzer-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:

Klicke in der Seitenleiste deines Workspaces auf Connectors.
Klicke auf Add connector.
Suche nach dem gewünschten Dienst, etwa Google Calendar oder Google Workspace, und klicke darauf.
Wähle Shared connector aus und klicke dann auf Next.
Gib einen Connection name ein.
Wähle unter Who can access aus, wo die Verbindung genutzt werden kann. Standard ist Apps and Super agent.
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.
Klicke auf Add connector. Melde dich dann mit dem Google-Konto an, das du teilen möchtest.
Öffne deine App im App-Editor.
Bitte den KI-Chat, die gemeinsame Google-Verbindung für die gewünschte Funktion zu nutzen.

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

Bevor du beginnst: Workspace-Owner und -Admins richten App-Nutzer-Connectors ein. Für Let Base44 manage OAuth brauchst du einen Pro-Tarif oder höher. Wenn du deinen eigenen OAuth-Client nutzt, lies vor dem Bauen Scopes und Berechtigungen.

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:

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

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

Klicke in der Seitenleiste deines Workspaces auf Connectors.
Klicke auf Add connector.
Suche nach dem gewünschten Dienst, etwa Google Calendar oder Google Drive, und klicke darauf.
Wähle App user connector aus und klicke dann auf Next.
Wenn Choose how to manage authentication erscheint, wähle Let Base44 manage OAuth oder Use your own OAuth client.
Gib einen Connector name ein.
Wenn du deinen eigenen OAuth-Client nutzt, gib dessen Client ID und Client Secret ein.
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.
Klicke auf Add Connector.
Öffne deine App im App-Editor.
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.

Gmail

Sende, lies und verwalte E-Mails in Gmail. Beispiel-Prompts Beschreibe im KI-Chat die Betreffzeile, den Nachrichtentext, die Formatierung, die Empfänger und alle dynamischen Felder. Zum Beispiel:

Sende automatische Bestätigungs-E-Mails, wenn eine neue Bestellung eingeht.

Lies und analysiere eingehende E-Mails, um Support-Tickets zu erstellen.

Löse automatisch einen Workflow aus, wenn eine neue E-Mail eintrifft.

Sende personalisierte Follow-up-E-Mails an neue Leads.

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 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:

Synchronisiere alle meine Buchungen direkt mit meinem Google Calendar.

Zeige Kunden meine Echtzeit-Verfügbarkeit aus Google Calendar.

Führe eine Automatisierung aus, wenn ein Kalendertermin erstellt oder aktualisiert wird.

Blockiere automatisch Meeting-Zeiten in meinem persönlichen Kalender.

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:

Baue ein CRM, das Kunden in beide Richtungen mit meinen Google Contacts synchronisiert.

Importiere Leads von Personen, denen ich geschrieben, die ich aber nie als Kontakt gespeichert habe.

Analysiere mein Kontaktnetzwerk und kategorisiere Kontakte automatisch mit KI.

Erstelle ein durchsuchbares Firmenverzeichnis aus meiner Google-Workspace-Organisation.

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. Beispiel-Prompts Beschreibe im KI-Chat die Dateien oder Ordner, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

Liste alle Dateien in meinem Google Drive auf und zeige sie in meiner App an.

Durchsuche Google Drive nach Dokumenten mit einem Stichwort und zeige die Ergebnisse an.

Speichere in meiner App erstellte PDF-Berichte in Google Drive.

Lies eine Tabelle aus Google Drive und importiere ihre Daten in meine App.

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. Beispiel-Prompts Beschreibe im KI-Chat das Dokument, was es auslöst, und alle dynamischen Felder. Zum Beispiel:

Erstelle automatisch Dokumente mit Meeting-Notizen.

Erstelle Verträge aus Vorlagen mit Kundendaten.

Aktualisiere geteilte Dokumente, wenn sich der Projektstatus ändert.

Exportiere Berichte im Google-Docs-Format.

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. Beispiel-Prompts Beschreibe im KI-Chat die Tabelle, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

Exportiere App-Daten in eine Google-Sheets-Tabelle.

Importiere Leads aus einem Google Sheet in das CRM.

Aktualisiere Lagerbestände in Google Sheets automatisch.

Erstelle wöchentliche Berichte und speichere sie in Google Sheets.

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. 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.

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. Anforderungen, Zeiträume und Ausnahmen legt Google fest. Prüfe daher die Entwicklerdokumentation von Google, bevor du damit planst.

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
App-Nutzer-Connector

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

// 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

Konfiguriere, deploye und rufe eine gemeinsame Verbindung aus einer Backend-Funktion auf.

App-Nutzer-Connectors

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.

Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der englischen Version.

Erste Schritte

App erstellen

App absichern

App bewerben

Konnektoren

Änderungsprotokoll

Was du tun kannst

E-Mails automatisieren

Kalender und Kontakte synchronisieren

Mit Dateien und Daten arbeiten

Google-Workspace-Connector

Einen Google-Dienst verbinden

Google-Dienste

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scopes und Berechtigungen

Google-Dienste in einer Backend-Funktion nutzen

Gemeinsame Connectors

App-Nutzer-Connectors

Fehlerbehebung

​Was du tun kannst

E-Mails automatisieren

Kalender und Kontakte synchronisieren

Mit Dateien und Daten arbeiten

​Google-Workspace-Connector

​Einen Google-Dienst verbinden

​Google-Dienste

​Gmail

​Google Calendar

​Google Contacts

​Google Drive

​Google Docs

​Google Sheets

​Scopes und Berechtigungen

​Google-Dienste in einer Backend-Funktion nutzen

Gemeinsame Connectors

App-Nutzer-Connectors

​Fehlerbehebung

Was du tun kannst

Google-Workspace-Connector

Einen Google-Dienst verbinden

Google-Dienste

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scopes und Berechtigungen

Google-Dienste in einer Backend-Funktion nutzen

Fehlerbehebung