Konferenzräume und Teilnehmer konfigurieren

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

Wenn Sie mit der spaces.create Methode einen Konferenzraum erstellen, wird eine Instanz der spaces Ressource zurückgegeben. Die Ressource enthält das SpaceConfig Objekt das die Konfiguration für den Konferenzraum ist. Außerdem enthält sie das ActiveConference Objekt, das ein Link zur aktuellen conferenceRecords Ressource im Konferenzraum ist. 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 Konferenzraum 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

Legen Sie mit dem AccessType Objekt das accessType Feld fest, um zu bestimmen, wer ohne Anklopfen an einem Konferenzraum teilnehmen kann. Sie können zwischen mehreren Einstellungen wählen, ob Teilnehmer automatisch zugelassen werden sollen. Standardmäßig wird das Feld auf die Standardeinstellungen für den Zugriff des Nutzers festgelegt.

Legen Sie mit dem EntryPointAccess Objekt das entryPointAccess Feld fest, um die Einstiegspunkte zu definieren, die für die Teilnahme an Besprechungen in einem Besprechungs raum verwendet werden können. 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 Konferenzraum erstellt wurde.

Besprechungsräume moderieren

Wenn Sie eine Besprechung moderieren möchten, können Sie mit dem Moderation Objekt das moderation Feld 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 Bereich Mitglieder verwalten.

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

Verwenden Sie die RestrictionType , um die Funktionseinschränkungen für das Feld moderationRestrictions festzulegen und 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 mit DefaultJoinAsViewerType das boolesche defaultJoinAsViewerType Feld fest. Wenn defaultJoinAsViewerType auf on gesetzt ist, nehmen Nutzer als Zuschauer teil. Wenn off festgelegt ist, nehmen Nutzer als Beitragende teil. Die Standardeinstellung ist off. Wenn für einen Nutzer in spaces.members eine explizite Rolle festgelegt ist, nimmt der Nutzer mit dieser Rolle teil.

Teilnahmebericht erstellen

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

Automatische Artefakte verwalten

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

Sie können die automatischen Artefakte entweder beim Erstellen eines Konferenzraums oder nachdem der Konferenzraum erstellt wurde 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 ArtifactConfig Objekt im SpaceConfig Objekt, um automatische Artefakte festzulegen. ArtifactConfig besteht aus den Feldern recordingConfig, transcriptionConfig und smartNotesConfig.

Jedes Feld ist einem ähnlichen Objekt zugeordnet, z. B. RecordingConfig, TranscriptionConfig, und SmartNotesConfig . Verwenden Sie die AutoGenerationType, um jedes Objekt festzulegen und das Konfigurationsobjekt auf 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 erstellt wurde.
Detailgrad	100% Detailgrad. Alles Gesagte wird aufgezeichnet.	Allgemein. Konzentriert sich auf Entscheidungen und Aufgaben.
Anwendungsbeispiel	Einhaltung gesetzlicher Vorschriften, Überprüfung genauer Zitate und Barrierefreiheit für Nutzer.	Ermöglicht 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 erstellt.	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, werden im Google Drive des Organisators weiterhin zwei separate Dokumente erstellt. 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 Konferenzraum 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 eines Bereichs verwalten

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

Organisatoren von Besprechungen können den Konferenzraum automatisch betreten. Sie können aber auch konfigurieren, dass zusätzliche Mitglieder der Besprechung ohne Anklopfen beitreten können. Außerdem kann für Mitglieder eine Role in der Besprechung konfiguriert werden, z. B. COHOST. Dadurch haben sie dieselben Möglichkeiten zur Verwaltung der Besprechung wie der Organisator. Weitere Informationen zum Zugriff auf einen Konferenzraum 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, 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 eines Bereichs mit den folgenden Methoden verwalten:

Jede Methode verwendet einen Pfadparameter. Bei den Methoden zum Erstellen und Auflisten wird das Feld parent verwendet, um den Konferenzraum anzugeben. Bei den Methoden zum Löschen und Abrufen werden die Ergebnisse mit dem Feld name nach dem Konferenzraum und dem Mitgliedsnamen gefiltert. Alle Methoden außer „Löschen“ geben eine Instanz der Ressource spaces.members zurück.

Alle Methoden außer „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 FieldMask 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 nur bestimmte Felder in einem Objekt verwendet werden können, 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 zum Erstellen, Abrufen und Auflisten verwendet. Weitere Informationen zu Feldmasken finden Sie unter Feldmasken verwenden in der Google Sheets API.