Ein Konferenzraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem Konferenzen stattfinden. Ein Gruppenbereich hilft Nutzern auch, sich zu treffen und gemeinsame Ressourcen zu finden.
Wenn Sie einen Besprechungsraum 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 darstellt. Außerdem enthält sie das ActiveConference-Objekt, das einen Link zur aktuellen conferenceRecords-Ressource im Konferenzraum darstellt. Weitere Informationen zum Verwalten eines Besprechungsraums finden Sie unter Besprechungsräume erstellen und verwalten.
In den folgenden Abschnitten wird beschrieben, wie Sie einen Besprechungsraum mithilfe dieser Objekte und Methoden konfigurieren.
Moderation und Zugriff auf Videokonferenzen festlegen
Über das Objekt SpaceConfig können Sie festlegen, wie Nutzer an einer Videokonferenz teilnehmen, welche Moderationsmodi, Funktionsbeschränkungen und Berechtigungen Nutzer erhalten, wenn sie an einer Videokonferenz teilnehmen.
Auf Konferenzräume zugreifen
Wenn Sie festlegen möchten, wer einem Besprechungsraum beitreten kann, ohne anklopfen zu müssen, 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 enthält standardmäßig die Standardzugriffseinstellungen des Nutzers.
Wenn Sie die Einstiegspunkte festlegen möchten, über die an Videokonferenzen teilgenommen werden kann, die in einem Besprechungsraum gehostet werden, 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 diejenigen einzuschränken, die zum Google Cloud-Projekt gehören, in dem der Besprechungsraum erstellt wurde.
Teilnahmebericht erstellen
Wenn Sie einen Anwesenheitsbericht für den Besprechungsraum erstellen möchten, legen Sie das boolesche Feld attendanceReportGenerationType mit dem Objekt AttendanceReportGenerationType fest. Wenn ein Bericht angefordert wird, wird er in Google Meet im Google Drive-Konto des Organisators gespeichert und eine E-Mail wird gesendet.
Konferenzräume moderieren
Wenn Sie eine Videokonferenz moderieren möchten, können Sie das boolesche Feld moderation mit dem Objekt Moderation festlegen.
Wenn der moderation-Modus on ist, hat der Organisator der Videokonferenz die Kontrolle über die Videokonferenz mit Funktionen wie der Verwaltung von Co-Organisatoren (siehe spaces.members) und Funktionseinschränkungen über das Feld moderationRestrictions. Weitere Informationen zu Mitgliedern finden Sie unter Mitglieder des Gruppenbereichs verwalten.
Wenn Sie Funktionsbeschränkungen für den Fall festlegen möchten, dass die Videokonferenz moderiert wird (moderation ist on), legen Sie das Feld moderationRestrictions mit dem Objekt ModerationRestrictions fest. Mit den Einschränkungen wird festgelegt, wer im Besprechungsraum Chatnachrichten oder Reaktionen senden oder seinen Bildschirm teilen darf.
Wenn Sie die Featureeinschränkungen für das Feld moderationRestrictions festlegen möchten, verwenden Sie das Enum RestrictionType, um chatRestriction, reactionRestriction und presentRestriction anzuwenden. Legen Sie HOSTS_ONLY fest, um die Berechtigungen sowohl auf den Organisator als auch auf den Co-Organisator anzuwenden, oder NO_RESTRICTION, um sie auf alle Teilnehmer anzuwenden.
Wenn Sie die Standardrolle einschränken möchten, die Nutzern als Betrachter zugewiesen wird, legen Sie das boolesche Feld defaultJoinAsViewerType mit dem Enum DefaultJoinAsViewerType fest. Wenn defaultJoinAsViewerType on ist, nehmen Nutzer als Zuschauer teil. Wenn off, werden Nutzer als Mitbearbeiter hinzugefügt. Die Standardeinstellung ist off. Wenn für einen Nutzer in spaces.members eine explizite Rolle festgelegt ist, nimmt er mit dieser Rolle teil.
Automatische Artefakte verwalten
Nur Organisatoren von Videokonferenzen, nicht Co-Organisatoren, können die automatische Aufzeichnung, automatische Transkripte und die Funktion „Notizen für mich erstellen“ im Besprechungsraum vorab konfigurieren. Wenn diese Einstellungen aktiviert sind, wird der Besprechungsraum aufgezeichnet, Transkripte werden erstellt und Besprechungsnotizen werden automatisch in Google Docs erfasst und organisiert. Jede Funktion ist unabhängig und wird für jeden Besprechungsraum festgelegt. Untertitel für Aufzeichnungen sind nur auf Englisch verfügbar.
Sie können die automatischen Artefakte entweder beim Erstellen eines Besprechungsraums oder nach dem Erstellen konfigurieren. Mit dieser Funktion können Sie auch automatische Artefakte für Besprechungen einrichten, die über Google Kalender erstellt wurden. Für beide Methoden ist der OAuth-Bereich meetings.space.settings erforderlich. Weitere Informationen finden Sie unter OAuth-Bereiche für Einstellungen.
Verwenden Sie das Objekt ArtifactConfig unter dem Objekt SpaceConfig, um automatische Artefakte festzulegen. ArtifactConfig besteht aus den Feldern recordingConfig, transcriptionConfig und smartNotesConfig.
Jedes Feld wird einem ähnlichen Objekt zugeordnet, z. B. RecordingConfig, TranscriptionConfig und SmartNotesConfig. Verwenden Sie das boolesche Enum AutoGenerationType, um das Konfigurationsobjekt on oder off zu aktivieren oder zu deaktivieren.
OAuth-Bereiche für Einstellungen
Für das Festlegen oder den Zugriff auf die Einstellungen für Videokonferenzen sind die folgenden OAuth-Bereiche erforderlich:
| Anwendungsfall | Umfangscode |
|---|---|
| Automatische Artefakterzeugung für von anderen Apps erstellte Gruppenbereiche festlegen | https://www.googleapis.com/auth/meetings.space.settings |
| Artefakte aus Konferenzen abrufen oder auflisten, die mit anderen Apps erstellt wurden. | https://www.googleapis.com/auth/meetings.space.readonly |
| Andere Einstellungen für die Besprechungsvorbereitung eines Besprechungsraums abrufen oder auflisten, der mit einer Drittanbieter-App erstellt wurde | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Einstellungen für alle Besprechungsräume lesen und bearbeiten, auf die Nutzer über eine andere App wie Google Kalender zugreifen können | https://www.googleapis.com/auth/meetings.space.settings |
Weitere Informationen zu OAuth-Bereichen finden Sie unter Meet REST API-Bereiche.
Mitglieder des Gruppenbereichs verwalten
Organisatoren können die Videokonferenz immer ohne anzuklopfen betreten. Sie können aber auch zusätzliche Mitglieder so konfigurieren, dass sie ohne anzuklopfen teilnehmen dürfen.
Außerdem können Mitgliedern eine Rolle in der Videokonferenz zugewiesen werden, z. B. COHOST. Dadurch erhalten sie dieselben Berechtigungen zur Verwaltung der Videokonferenz wie der Organisator. Weitere Informationen zum Zugriff auf einen Besprechungsraum, ohne anzuklopfen, finden Sie unter AccessType.
Die Ressource spaces.members enthält die Felder name, user und role.
Ein Mitglied unterscheidet sich von einem Teilnehmer. Ein Teilnehmer ist eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet, sich als Zuschauer ansieht oder ein mit einem Anruf verbundenes Raumgerät ist. Für jede Person gibt es eine conferenceRecords.participants-Ressource.
Sie haben folgende Möglichkeiten, Mitglieder eines Gruppenbereichs zu verwalten:
Jede Methode nimmt einen Pfadparameter an. Bei den Methoden „create“ und „list“ wird das Feld parent verwendet, um den Besprechungsraum anzugeben. Bei den Methoden „delete“ und „get“ wird das Feld name verwendet, um die Ergebnisse anhand des Besprechungsraums und des Mitgliedsnamens zu filtern.
Alle Methoden mit Ausnahme von „delete“ unterstützen den Parameter fields in SystemParameterContext.
Wenn der Parameter fields weggelassen wird, wird in der API-Antwort standardmäßig "name,email,role,user" verwendet.
Der Parameter fields verwendet für die Antwortfilterung eine FieldMask. Mit einer Feldmaske können API-Caller Felder auflisten, 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 sollen, während die anderen unverändert bleiben.
Mit 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 im Hilfeartikel Feldmasken verwenden der Google Tabellen API.