Konferenzräume und Teilnehmer konfigurieren

Ein Besprechungsraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem Konferenzen abgehalten werden. Außerdem können Nutzer in einem Besprechungsraum zusammenarbeiten und gemeinsame Ressourcen finden.

Wenn Sie mit der spaces.create Methode einen Besprechungsraum erstellen, wird eine Instanz der spaces Ressource zurückgegeben. Die Ressource enthält das SpaceConfig Objekt das die Konfiguration für den Besprechungsraum ist. Außerdem enthält sie das ActiveConference Objekt, das einen Link zur aktuellen conferenceRecords Ressource im Besprechungsraum darstellt. Weitere Informationen zum Verwalten eines Besprechungs raums finden Sie unter Besprechungs rä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 Besprechung teilnehmen, die Moderationsmodi, die Funktion einschränkungen und die Berechtigungen, die Nutzer beim Beitritt zu einer Besprechung erhalten.

Auf Besprechungsräume zugreifen

Wenn Sie festlegen möchten, wer ohne Anklopfen an einer Besprechung teilnehmen kann, legen Sie das accessType Feld mit dem AccessType Objekt fest. Sie können aus mehreren Einstellungen auswählen, ob Teilnehmer automatisch zugelassen werden sollen. Standardmäßig wird die Standardeinstellung für den Zugriff des Nutzers verwendet.

Wenn Sie die Einstiegspunkte definieren möchten, die für die Teilnahme an Besprechungen in einem Besprechungs raum verwendet werden können, legen Sie das entryPointAccess Feld mit dem EntryPointAccess Objekt 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 Besprechungsraum erstellt wurde.

Besprechungsräume moderieren

Wenn Sie eine Besprechung moderieren möchten, können Sie das moderation Feld mit dem Moderation Objekt festlegen. Wenn der moderation Modus auf on gesetzt ist, hat der Organisator der Besprechung die Kontrolle über die Besprechung. Dazu stehen ihm Funktionen wie die Co-Organisator-Verwaltung (siehe spaces.members) und Funktionseinschränkungen über das moderationRestrictions Feld zur Verfügung. Weitere Informationen zu Mitgliedern finden Sie unter Mitglieder von Bereichen verwalten.

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

Wenn Sie die Funktionseinschränkungen für das moderationRestrictions Feld festlegen möchten, verwenden Sie die RestrictionType um chatRestriction, reactionRestriction und presentRestriction anzuwenden. Legen Sie HOSTS_ONLY fest, um die Berechtigungen auf den Organisator und den Co-Organisator der Besprechung anzuwenden, oder NO_RESTRICTION, um sie auf alle Teilnehmer anzuwenden.

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

Teilnahmebericht erstellen

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

Automatische Artefakte verwalten

Organisatoren von Besprechungen, aber nicht Co-Organisatoren, können die automatische Aufzeichnung, automatische Transkripte und intelligente Notizen im Besprechungsraum vorkonfigurieren. Wenn diese Einstellungen aktiviert sind, wird der Besprechungsraum 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 Besprechungs raums oder nach der Erstellung des Besprechungsraums 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.

Wenn Sie automatische Artefakte festlegen möchten, verwenden Sie das ArtifactConfig Objekt im SpaceConfig Objekt. ArtifactConfig besteht aus den Feldern recordingConfig, transcriptionConfig und smartNotesConfig.

Jedes Feld ist einem ähnlichen Objekt zugeordnet, z. B. RecordingConfig, TranscriptionConfig, und SmartNotesConfig . Wenn Sie die einzelnen Objekte festlegen möchten, verwenden Sie die AutoGenerationType , um das Konfigurationsobjekt on oder off zu setzen.

Informationen zum Abrufen der Artefakte, die während einer Konferenz erstellt wurden, finden Sie unter Mit Artefakten arbeiten.

Unterschied zwischen Transkripten und intelligenten Notizen

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

In der folgenden Tabelle sind die Unterschiede aufgeführt:

Funktion	Transkripte	Intelligente Notizen
Übersicht	Eine wörtliche Aufzeichnung.	Eine kurze Zusammenfassung der wichtigsten Punkte, die von Gemini generiert wurde.
Detailgrad	100% Detailgrad. Alles Gesagte wird aufgezeichnet.	Übersicht. Konzentriert sich auf Entscheidungen und Aufgaben.
Anwendungsbeispiel	Einhaltung gesetzlicher Vorschriften, Überprüfung genauer Zitate und Barrierefreiheit für Nutzer.	Ermöglicht es Teilnehmern, die zu spät kommen, sich schnell auf den neuesten Stand zu bringen. Automatisiert die Protokollierung und die Projektverfolgung.
Echtzeitnutzung	Wird für Untertitel verwendet. Die Datei wird nach dem Anruf generiert.	Sie können die Zusammenfassung während des Anrufs in der Seitenleiste sehen.
Ausgabe	Ein langes Google Docs-Dokument mit Sprechernamen und Zeitstempeln.	Ein kurzes Google Docs-Dokument mit Besprechungsnotizen mit Abschnitten und Aufzählungszeichen.
Citation	Enthält den vollständigen Text, der verlinkt werden kann.	Enthält Quellenangaben (Zeitstempel), die auf den jeweiligen Moment im Transkript verweisen, wenn sowohl Transkripte als auch intelligente Notizen aktiviert sind. Weitere Informationen finden Sie unter Wenn beide Funktionen aktiviert sind.

Wenn beide Funktionen aktiviert sind

Jede Funktion kann separat verwendet werden. Transkripte und intelligente Notizen können aber auch gleichzeitig verwendet werden, um bessere Artefakte nach der Besprechung zu erstellen.

Wenn beide Funktionen aktiviert sind, werden in den generierten intelligenten Notizen Quellenangaben angezeigt. Diese befinden sich im Bereich „Details“ und führen zu bestimmten Zeitstempeln im Besprechungstranskript. Wenn Sie auf die Quellenangaben klicken, gelangen Sie direkt an die entsprechende Stelle im Transkript und können so das Gesagte besser nachvollziehen.

Während der Besprechung sehen die Teilnehmer Hinweise darauf, dass beide Funktionen aktiv sind. Sie müssen für die Dauer der Besprechung aktiv bleiben, damit klickbare Quellenangaben generiert werden können. Obwohl die Dateien miteinander verknüpft sind, generiert das System weiterhin zwei separate Dokumente im Google Drive des Organisators. Beide Dateien werden auch automatisch an den Google Kalender-Termin angehängt.

OAuth-Bereiche für Einstellungen

Für das Festlegen oder Aufrufen von Besprechungseinstellungen sind die folgenden OAuth-Bereiche erforderlich:

Anwendungsbeispiel	Bereichscode
Automatische Artefakterstellung für Bereiche festlegen, 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 vor der Besprechung für einen Besprechungsraum abrufen oder auflisten, der von einer Drittanbieter-App erstellt wurde.	`https://www.googleapis.com/auth/meetings.space.created` `https://www.googleapis.com/auth/meetings.space.readonly`
Die 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 von Bereichen verwalten

Ein Mitglied eines Bereichs ist ein Nutzer, der für eine Rolle im Besprechungsraum konfiguriert ist. Diese Nutzer können dem Besprechungsraum beitreten, ohne eine Berechtigung zum Verbinden anzufordern (auch bekannt als „Anklopfen“).

Organisatoren von Besprechungen können den Besprechungsraum automatisch betreten. Sie können aber auch konfigurieren, dass zusätzliche Mitglieder ohne Anklopfen an der Besprechung teilnehmen können. Außerdem können Mitglieder so konfiguriert werden, dass sie eine Role in der Besprechung haben, z. B. COHOST. Dadurch haben sie dieselben Möglichkeiten zur Verwaltung der Besprechung wie der Organisator. Weitere Informationen zum Zugriff auf einen Besprechungsraum ohne Anklopfen finden Sie unter AccessType.

Die spaces.members Ressource 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. Für jede Person gibt es eine conferenceRecords.participants Ressource.

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 Besprechungsraum anzugeben. Bei den Methoden zum Löschen und Abrufen werden die Ergebnisse mit dem Feld name nach dem Besprechungsraum und dem Mitgliedsnamen gefiltert. Alle Methoden mit Ausnahme von „Löschen“ geben eine Instanz der Ressource spaces.members zurück.

Alle Methoden mit Ausnahme von „Löschen“ unterstützen den fields Parameter in SystemParameterContext. Wenn der fields Parameter weggelassen wird, ist die API-Antwort standardmäßig "name,email,role,user".

Der fields Parameter verwendet eine FieldMask für die Antwortfilterung. Eine Feldmaske ist eine Möglichkeit für API-Aufrufer, Felder aufzulisten, die eine Anfrage zurückgeben soll. Es ist eine durch Kommas getrennte Liste von Feldern, mit der angegeben wird, dass nur bestimmte Felder in einem Objekt verwendet werden, während die anderen Felder unverändert bleiben. Durch die Verwendung einer Feldmaske kann die API unnötige Arbeit vermeiden und die Leistung verbessern. Eine Feldmaske wird für die Methoden zum Erstellen, Abrufen und Auflisten verwendet. Weitere Informationen zu Feldmasken finden Sie unter Feldmasken verwenden in der Google Sheets API.