Ein Konferenzraum ist ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem Konferenzen stattfinden. In einem Gruppenbereich können Nutzer auch andere Nutzer treffen und gemeinsam genutzte Ressourcen 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.
In den folgenden Abschnitten wird beschrieben, wie Sie einen Besprechungsraum mithilfe mehrerer neuer Betaobjekte und ‑methoden konfigurieren.
Moderation und Zugriff auf Videokonferenzen festlegen
Mit den neuen Betaobjekten können Sie jetzt Moderationsmodi, Funktionsbeschränkungen und die Berechtigungen festlegen, die Nutzer erhalten, wenn sie einer Videokonferenz beitreten. Sie werden über das aktualisierte SpaceConfig-Objekt festgelegt.
Das Feld moderation ist ein vorkonfigurierter Moderationsmodus für eine Videokonferenz. Die Standardeinstellung wird durch die Richtlinien des Nutzers gesteuert. Dabei wird das Moderation-Objekt verwendet. Wenn der Moderationsmodus aktiviert ist, hat der Organisator die Kontrolle über die Videokonferenz. Er kann beispielsweise Co-Hosts verwalten (siehe spaces.members) und Funktionsbeschränkungen festlegen (siehe moderationRestrictions). Weitere Informationen zu Mitgliedern finden Sie unter Gruppenmitglieder verwalten.
Wenn moderation aktiviert ist, werden im Feld moderationRestrictions Moderationsbeschränkungen für die Videokonferenz durchgesetzt. Dabei wird das ModerationRestrictions-Objekt verwendet. Mit den Einschränkungen wird festgelegt, wer Chatnachrichten und Reaktionen senden, seinen Bildschirm teilen und ob die Standardrolle für Zuschauer eingeschränkt werden soll. Das Feld moderationRestrictions benötigt ein RestrictionType, um die ersten drei Einschränkungen anzuwenden. Die RestrictionType kann auf den Organisator und Co-Organisator der Videokonferenz oder auf alle Teilnehmer angewendet werden. Mit der Option DefaultJoinAsViewerType wird die finale Berechtigung angewendet, bei der Nutzer standardmäßig als Mitwirkende beitreten, aber die Gastgeber auch festlegen können, dass Nutzer nur als Zuschauer beitreten dürfen.
Im Feld firstJoinerType wird festgelegt, ob Nutzer vor dem Organisator an Konferenzen in diesem Gruppenbereich teilnehmen können. Hier wird festgelegt, welche Nutzer zuerst an der Videokonferenz teilnehmen können und ob andere Nutzer in einem Wartestatus sind. Dabei wird das FirstJoinerType-Objekt verwendet.
Mitglieder des Gruppenbereichs verwalten
Der Organisator einer Videokonferenz konnte schon immer ohne anklopfen zu müssen teilnehmen. Jetzt können Sie auch Mitglieder konfigurieren, die ohne anklopfen zu müssen teilnehmen können. Außerdem können Mitgliedern eine Rolle in der Videokonferenz zugewiesen werden, z. B. COHOST, die ihnen dieselben Berechtigungen zur Verwaltung der Videokonferenz wie dem Organisator verleiht. Weitere Informationen dazu, wie Sie ohne anzuklopfen auf einen Besprechungsraum zugreifen, 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, den Companion-Modus verwendet, sich als Zuschauer ansieht oder ein mit einem Anruf verbundenes Raumgerät ist. Es gibt eine conferenceRecords.participants-Ressource für jede Person.
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" zurückgegeben.
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 Felder 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.