Zum Hauptinhalt springen
Sende E-Mails, synchronisiere Kalender und Kontakte und arbeite mit Dateien aus deiner App. Verbinde jeden Google-Dienst einzeln oder nutze den Google-Workspace-Connector, um in einer Verbindung mit mehreren zu arbeiten.

Was du tun kannst

Wähle einen Google-Dienst, um zu sehen, was du damit bauen kannst. Oder nutze den Google-Workspace-Connector, um mehrere in einer Verbindung zu kombinieren.

Gmail

E-Mails senden, lesen und organisieren.

Google Calendar

Termine synchronisieren und deine Verfügbarkeit zeigen.

Google Contacts

Kontakte finden, hinzufügen und aktualisieren.

Google Drive

Dateien speichern, teilen und organisieren.

Google Docs

Dokumente erstellen und aktualisieren.

Google Sheets

Tabellen lesen, schreiben und aktualisieren.
Suchst du einen anderen Google-Connector? Sieh dir Google Maps, Google Search Console und weitere im Connectors-Katalog an.

Gmail

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

Google Calendar

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

Google Contacts

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

Google Drive

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

Google Docs

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

Google Sheets

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

Google-Workspace-Connector

Baue Funktionen, die mit deinem Posteingang, Kalender, Kontakten und Dateien zusammen arbeiten. Ein Beispiel ist ein Assistent, der Meetings mit passenden E-Mails und Dokumenten vorbereitet. Beispiel-Prompts Beschreibe im KI-Chat die beteiligten Google-Dienste, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

Einen Google-Dienst verbinden

Verbinde einen Google-Dienst über ein gemeinsames Konto oder lass jede Person ihr eigenes verbinden.
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 Konnektoren.
  2. Klicke auf Connector hinzufügen.
  3. Suche nach Google Workspace oder einem einzelnen Dienst wie Google Kalender und klicke darauf.
  4. Wähle Gemeinsamer Connector aus und klicke dann auf Weiter.
  5. Gib einen Verbindungsname ein.
  6. Wähle unter Wer hat Zugriff aus, wo die Verbindung genutzt werden kann: Apps und Super-Agent (Standard), Nur Apps oder Nur Super-Agent.
  7. Wähle unter Berechtigungen den Zugriff aus, den deine App braucht:
    • Nur Lesen: Deine App kann Daten ansehen. Das ist der Standard.
    • Lesen & schreiben: Deine App kann Daten senden, erstellen oder ändern.
    • Benutzerdefiniert: Wähle die optionalen Berechtigungen aus, die deine App braucht. Erforderliche Berechtigungen bleiben ausgewählt.
  8. Klicke auf Connector hinzufügen. 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.

Scopes und Berechtigungen

Scopes bestimmen, worauf deine App in Google zugreifen und was sie ändern kann. Nutze die Dienstkarten unten, um nur die Berechtigungen zu wählen, die deine App braucht.
Erforderlicher Scope emailBase44 fragt immer den Scope email an, um das verbundene Google-Konto zu identifizieren. Diese erforderliche Berechtigung bleibt ausgewählt:
  • Gemeinsamer Connector: Unter Berechtigungen, wenn du Benutzerdefiniert wählst.
  • App-Nutzer-Connector: Unter Scopes.

Gmail

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

Der umfassende Scope calendar verwaltet jeden Kalender. Wähle einen engeren Scope, wenn deine App nur Termine oder Verfügbarkeit liest.
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

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

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

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

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.

Google Workspace

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
  • Kalender: calendar.readonly, calendar.settings.readonly, calendar.events
  • Kontaktanfragen: contacts.readonly
  • Drive: drive.readonly, drive
  • Doku: documents.readonly, documents
  • Sheets: spreadsheets.readonly, spreadsheets
Die Dienstkarten oben erklären, was diese Scopes erlauben.
Zugriff: Deine App arbeitet mit den Daten des Google-Kontos, das die Verbindung autorisiert.

Verifizierung mit deinem eigenen OAuth-Client

Wenn du deinen eigenen OAuth-Client nutzt, gehört dir die OAuth-App. Du reichst ihre Verifizierung bei Google ein. Gemeinsame Google-Connectors und OAuth von Base44 verwalten lassen 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 Google deine App genehmigt, kann Google die Zahl der Personen begrenzen, die sich verbinden können. 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 umfasst deinen Code und die Plattform, auf der deine App läuft. Prüfe die Entwicklerdokumentation von Google auf aktuelle Anforderungen, Zeiträume und Ausnahmen, bevor du deinen Launch planst.

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.

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.
Wenn du deinen eigenen OAuth-Client nutzt, startet er 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.
Registriere die Callback-URL deiner Verbindung als autorisierte Redirect-URI in deinem Google-OAuth-Client:
Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der englischen Version.