Konferenzräume und Teilnehmer konfigurieren

Ein Konferenzraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Besprechungsraum), in dem Konferenzen abgehalten werden. Ein Konferenzraum hilft Nutzern auch, sich zu treffen und gemeinsame Ressourcen zu finden.

Wenn Sie einen Besprechungsbereich mit der Methode spaces.create erstellen, wird eine Instanz einer spaces-Ressource zurückgegeben. Die Ressource enthält das SpaceConfig-Objekt, das die Konfiguration für den Konferenzraum ist. Sie enthält auch das ActiveConference-Objekt, das einen Link zur aktuellen conferenceRecords-Ressource im Besprechungsbereich enthält. Weitere Informationen zum Verwalten eines Besprechungsraums finden Sie unter Besprechungsräume erstellen und verwalten.

In den folgenden Abschnitten wird beschrieben, wie Sie einen Besprechungsraum mit diesen Objekten und Methoden konfigurieren.

Moderation und Besprechungszugriff festlegen

Über das Objekt SpaceConfig können Sie festlegen, wie Nutzer an einer Videokonferenz teilnehmen, welche Moderationsmodi verwendet werden, welche Funktionen eingeschränkt sind und welche Berechtigungen Nutzer erhalten, wenn sie an einer Videokonferenz teilnehmen.

Auf Besprechungsbereiche zugreifen

Wenn Sie festlegen möchten, wer einem Besprechungsbereich ohne Anklopfen beitreten kann, legen Sie das Feld accessType mit dem Objekt AccessType fest. Sie können aus mehreren Einstellungen auswählen, ob Teilnehmer automatisch zugelassen werden sollen. Das Feld wird standardmäßig auf die Standardzugriffseinstellungen des Nutzers gesetzt.

Wenn Sie die Einstiegspunkte definieren möchten, die für die Teilnahme an Videokonferenzen in einem Besprechungsraum verwendet werden können, legen Sie das Feld entryPointAccess mit dem Objekt EntryPointAccess fest. Legen Sie ALL fest, um alle Einstiegspunkte zuzulassen, oder CREATOR_APP_ONLY, um die Einstiegspunkte auf die zu beschränken, die dem Google Cloud-Projekt gehören, mit dem der Besprechungsbereich erstellt wurde.

Konferenzräume moderieren

Um eine Besprechung zu moderieren, können Sie das Feld moderation mit dem Objekt Moderation festlegen. Wenn der Modus moderation auf on eingestellt ist, hat der Organisator der Videokonferenz die Kontrolle über die Videokonferenz. Er kann beispielsweise Co‑Organisatoren verwalten (siehe spaces.members) und Funktionen über das Feld moderationRestrictions einschränken. Weitere Informationen zu Mitgliedern finden Sie unter Bereichsmitglieder verwalten.

Wenn Sie Funktionseinschränkungen definieren möchten, wenn die Videokonferenz moderiert wird (moderation ist on), legen Sie das Feld moderationRestrictions mit dem Objekt ModerationRestrictions fest. Die Einschränkungen definieren, wer im Besprechungsbereich die Berechtigung hat, Chatnachrichten oder Reaktionen zu senden oder den Bildschirm zu teilen.

Um die Funktionseinschränkungen für das Feld moderationRestrictions festzulegen, verwenden Sie RestrictionType, um chatRestriction, reactionRestriction und presentRestriction anzuwenden. Legen Sie HOSTS_ONLY fest, um die Berechtigungen sowohl auf den Organisator als auch auf den Co-Moderator anzuwenden, oder NO_RESTRICTION, um sie auf alle Teilnehmer anzuwenden.

Wenn Sie die Standardrolle, die Nutzern als Betrachter zugewiesen wird, einschränken möchten, legen Sie das boolesche Feld defaultJoinAsViewerType mit dem DefaultJoinAsViewerType fest. Wenn defaultJoinAsViewerType on ist, treten Nutzer als Zuschauer bei. Wenn off, treten Nutzer als Beitragende bei. Die Standardeinstellung ist off. Wenn für einen Nutzer in spaces.members eine explizite Rolle festgelegt ist, wird der Nutzer mit dieser Rolle hinzugefügt.

Teilnahmebericht erstellen

Wenn Sie einen Anwesenheitsbericht für den Besprechungsraum erstellen möchten, legen Sie das Feld attendanceReportGenerationType mit dem Objekt AttendanceReportGenerationType fest. Wenn ein Bericht angefordert wird, speichert Google Meet den Teilnahmebericht im Google Drive des Besprechungsorganisators und sendet auch eine E-Mail.

Automatische Artefakte verwalten

Organisatoren von Videokonferenzen, aber nicht Co-Organisatoren, können die automatische Aufzeichnung, automatische Transkripte und Smart Notes im Besprechungsbereich vorkonfigurieren. Wenn diese Einstellungen aktiviert sind, wird der Besprechungsbereich aufgezeichnet, Transkripte werden erstellt und Besprechungsnotizen werden automatisch erfasst und in Google Docs organisiert. Jede Funktion ist unabhängig und wird pro Besprechungsraum festgelegt. Untertitel für Aufzeichnungen sind nur auf Englisch verfügbar.

Sie können die automatischen Artefakte entweder beim Erstellen eines Besprechungsbereichs oder nach dem Erstellen des Besprechungsbereichs vorkonfigurieren. Für beide Methoden ist der OAuth-Bereich meetings.space.settings erforderlich. Weitere Informationen finden Sie unter OAuth-Bereiche für Einstellungen.

Sie können auch automatische Artefakte für Besprechungen einrichten, die in Google Kalender erstellt wurden.

Verwenden Sie das Objekt ArtifactConfig im Objekt SpaceConfig, um automatische Artefakte festzulegen. ArtifactConfig besteht aus den Feldern recordingConfig, transcriptionConfig und smartNotesConfig.

Jedes Feld wird einem ähnlichen Objekt wie RecordingConfig, TranscriptionConfig und SmartNotesConfig zugeordnet. Verwenden Sie zum Festlegen der einzelnen Objekte den Befehl AutoGenerationType, um das Konfigurationsobjekt on oder off umzuschalten.

Informationen zum Abrufen der während einer Konferenz erstellten Artefakte finden Sie unter Mit Artefakten arbeiten.

Unterschied zwischen Transkripten und Smart Notes

Sowohl Besprechungstranskripte als auch Smart Notes (auch bekannt als „Notizen für mich erstellen“) erfassen Informationen aus Ihrer Besprechung. Diese Funktionen dienen jedoch unterschiedlichen Zwecken und erzeugen unterschiedliche Artefakte.

In der folgenden Tabelle sehen Sie die Unterschiede:

Funktion Transkripte Intelligente Notizen
Übersicht Eine wörtliche Aufzeichnung. Eine von Gemini generierte kurze Zusammenfassung der wichtigsten Punkte.
Detaillierungsgrad 100% Detail. Alles, was gesagt wird, wird aufgeschrieben. Auf hoher Ebene. Konzentriert sich auf Entscheidungen und Aufgaben.
Anwendungsbeispiel Rechtliche Konformität, Überprüfung von genauen Zitaten und Nutzerfreundlichkeit. Ermöglicht es Teilnehmern, die zu spät kommen, sich sofort auf den neuesten Stand zu bringen, und automatisiert die Protokollierung und Projektverfolgung.
Nutzung in Echtzeit Wird für Untertitel verwendet. Die Datei wird nach dem Anruf generiert. Während des Anrufs können Sie in der Seitenleiste sehen, wie die Zusammenfassung erstellt wird.
Ausgabe Ein langes Google Docs-Dokument mit Sprechernamen und Zeitstempeln. Ein übersichtliches Google-Dokument mit Besprechungsnotizen, das in Abschnitte und Stichpunkte unterteilt ist.
Zitation Enthält den vollständigen Text, auf den verlinkt werden kann. Enthält Zitationen (Zeitstempel), die zur Kontextualisierung auf den entsprechenden Moment im Transkript verweisen, wenn sowohl Transkripte als auch Smart Notes aktiviert sind. Weitere Informationen finden Sie unter Wenn beide Funktionen aktiviert sind.

Wenn beide Funktionen aktiviert sind

Die einzelnen Funktionen können separat verwendet werden. Transkripte und intelligente Notizen können aber auch gleichzeitig verwendet werden, um bessere Artefakte nach der Besprechung zu erstellen.

Wenn beide aktiviert sind, werden in den generierten Smart Notes-Dokumenten Quellenangaben angezeigt. Diese befinden sich im Bereich „Details“ und führen zu bestimmten Zeitstempeln im Besprechungstranskript. Wenn Sie auf die Quellenangaben klicken, landen Sie direkt an der entsprechenden Stelle im Transkript und können so das Gesagte besser nachvollziehen.

Während des Meetings sehen die Teilnehmer Hinweise darauf, dass beide Funktionen aktiv sind. Sie müssen während der gesamten Videokonferenz aktiv bleiben, damit klickbare Zitationen generiert werden können. Obwohl die Dateien miteinander verknüpft sind, werden im Google Drive des Hosts zwei separate Dokumente erstellt. Beide Dateien werden auch automatisch an den Google Kalender-Termin angehängt.

OAuth-Bereiche für Einstellungen

Zum Festlegen oder Aufrufen von Besprechungseinstellungen sind die folgenden OAuth-Bereiche erforderlich:

Anwendungsfall Umfangscode
Legen Sie die automatische Artefaktgenerierung für Bereiche fest, die von anderen Apps erstellt wurden. https://www.googleapis.com/auth/meetings.space.settings
Artefakte aus Konferenzen abrufen oder auflisten, die von anderen Apps erstellt wurden. https://www.googleapis.com/auth/meetings.space.readonly
Andere Einstellungen für Besprechungsräume abrufen oder auflisten, die von einer Drittanbieter-App erstellt wurden. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Einstellungen für alle Besprechungsräume lesen und bearbeiten, auf die ein Nutzer über eine andere App wie Google Kalender zugreifen kann. https://www.googleapis.com/auth/meetings.space.settings

Weitere Informationen zu OAuth-Bereichen finden Sie unter Meet REST API-Bereiche.

Mitglieder des Gruppenbereichs verwalten

Ein Mitglied eines Gruppenbereichs ist ein Nutzer, der für eine Rolle im Besprechungsbereich konfiguriert ist. Diese Nutzer können dem Besprechungsbereich beitreten, ohne eine Verbindungsanfrage zu senden (auch als „Anklopfen“ bezeichnet).

Videokonferenzorganisatoren können den Videokonferenzbereich automatisch betreten. Sie können aber auch konfigurieren, dass zusätzliche Mitglieder der Videokonferenz ohne Anklopfen beitreten. Außerdem kann Mitgliedern eine Role in der Videokonferenz zugewiesen werden, z. B. COHOST. Dadurch haben sie dieselben Möglichkeiten zur Verwaltung der Videokonferenz wie der Organisator. Weitere Informationen zum Zugriff auf einen Besprechungsbereich ohne Anklopfen finden Sie unter AccessType.

Die Ressource spaces.members enthält die Felder name, user und role.

Ein Mitglied ist nicht dasselbe wie ein Teilnehmer. Ein Teilnehmer ist eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet, als Zuschauer teilnimmt oder ein Raumgerät, das mit einem Anruf verbunden ist. Es gibt eine conferenceRecords.participants-Ressource für jede Person.

Sie können Mitglieder von Bereichen mit den folgenden Methoden verwalten:

Jede Methode verwendet einen Pfadparameter. Bei den Methoden zum Erstellen und Auflisten wird das Feld parent verwendet, um den Besprechungsbereich anzugeben. Bei den Methoden zum Löschen und Abrufen wird das Feld name verwendet, um die Ergebnisse nach Besprechungsbereich und Mitgliedsname zu filtern. Alle Methoden mit Ausnahme von „delete“ geben eine Instanz der spaces.members-Ressource zurück.

Alle Methoden mit Ausnahme von „delete“ unterstützen den Parameter fields im SystemParameterContext. Wenn der Parameter fields nicht angegeben wird, wird in der API-Antwort standardmäßig "name,email,role,user" verwendet.

Der Parameter fields basiert auf einer FieldMask für die Antwortfilterung. Mit einer FieldMask können API-Aufrufer Felder auflisten, die in einer Anfrage zurückgegeben werden sollen. Es handelt sich um eine durch Kommas getrennte Liste von Feldern, mit der angegeben wird, dass nur bestimmte Felder in einem Objekt verwendet werden sollen, während die anderen Felder unverändert bleiben. Durch die Verwendung einer FieldMask kann die API unnötige Arbeit vermeiden und die Leistung verbessern. Eine Feldmaske wird für die Methoden „create“, „get“ und „list“ verwendet. Weitere Informationen zu Feldmasken finden Sie in der Google Sheets API unter Feldmasken verwenden.