Przestrzeń spotkań to wirtualna lokalizacja lub trwały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. Pokój spotkań pomaga też użytkownikom spotykać się i znajdować udostępnione zasoby.
Gdy utworzysz pokój spotkań za pomocą metody spaces.create, zwraca on instancję zasobu spaces. Zasób zawiera obiekt SpaceConfig, który jest konfiguracją zaplecza konferencyjnego. Zawiera on też obiekt ActiveConference, który jest linkiem do bieżącego zasobu conferenceRecords w przestrzeni konferencyjnej.
W kolejnych sekcjach znajdziesz szczegółowe informacje na temat konfigurowania sali konferencyjnej za pomocą kilku nowych obiektów i metod w wersji beta.
Konfigurowanie moderowania i dostępu do spotkań
Dzięki nowym obiektom w wersji beta możesz teraz ustawiać tryby moderowania, ograniczenia funkcji i uprawnienia, które użytkownicy otrzymują po dołączeniu do spotkania. Te parametry są ustawiane za pomocą zaktualizowanego obiektu SpaceConfig.
Pole moderation to wstępnie skonfigurowany tryb moderowania spotkania, którego domyślne ustawienia są kontrolowane przez zasady użytkownika. Używa obiektu Moderation. Gdy tryb moderowania jest włączony, właściciel spotkania ma kontrolę nad spotkaniem dzięki funkcjom takim jak zarządzanie współgospodarzami (patrz spaces.members) i ograniczenia funkcji (patrz moderationRestrictions). Więcej informacji o członkach znajdziesz w artykule Zarządzanie członkami pokoju.
Pole moderationRestrictions nakłada ograniczenia moderacji na spotkanie, gdy opcja moderation jest włączona. Używa obiektu ModerationRestrictions. Ograniczenia określają, kto ma uprawnienia do wysyłania wiadomości na czacie i reakcji oraz do udostępniania ekranu, a także czy należy ograniczyć domyślną rolę przypisaną użytkownikom jako widzom. Pole moderationRestrictions korzysta z ustawienia RestrictionType, aby zastosować pierwsze 3 ograniczenia. RestrictionType można zastosować do właściciela spotkania i współgospodarza lub do wszystkich uczestników. Użytkownicy z rolą DefaultJoinAsViewerType mają ostatecznie przyznane uprawnienia, w ramach których domyślnie dołączają jako współtwórcy, ale gospodarze mogą też ograniczyć ich do roli widzów.
Pole firstJoinerType określa, czy użytkownicy mogą dołączyć do konferencji w tym pokoju spotkań przed gospodarzem. Określa, którzy użytkownicy mogą dołączyć do spotkania jako pierwsi, a którzy są w stanie oczekiwania. Używa obiektu FirstJoinerType.
Zarządzanie użytkownikami w pokoju
Organizator spotkania może zawsze dołączyć do spotkania bez proszenia o zaakceptowanie, ale teraz możesz skonfigurować członków, którzy również mogą dołączyć do spotkania bez proszenia. Dodatkowo członkowie mogą mieć przypisaną rolę na spotkaniu, na przykład COHOST, która daje im takie same uprawnienia do zarządzania spotkaniem jak właścicielowi. Więcej informacji o dostępie do pokoju spotkań bez pukania znajdziesz w artykule AccessType.
Zasób spaces.members zawiera pola name, user i role.
Pamiętaj, że członek to nie to samo co uczestnik. Uczestnikiem jest osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda jako widz lub jest urządzeniem w sali konferencyjnej połączonym z rozmową. Każda osoba ma do dyspozycji jeden zasób:
conferenceRecords.participants
Użytkownicy pokoju mogą zarządzać innymi użytkownikami pokoju na te sposoby:
Każda metoda przyjmuje parametr ścieżki z metodami create i list, używając pola parent do oznaczania przestrzeni spotkań, oraz metodami delete i get, używając pola name do filtrowania wyników na podstawie przestrzeni spotkań i nazwy członka.
Wszystkie metody oprócz delete obsługują parametr fields w SystemParameterContext. Jeśli parametr fields zostanie pominięty, odpowiedź interfejsu API będzie domyślnie wynosić "name,email,role,user".
Parametr fields korzysta z FieldMask do filtrowania odpowiedzi. Pole FieldMask umożliwia wywołującym interfejs API podawanie pól, które mają być zwracane przez żądanie. Jest to lista pól oddzielonych przecinkami, która określa, które pola w obiekcie mają być używane, a które nie.
Użycie maski pola pozwala interfejsowi API uniknąć niepotrzebnej pracy i zwiększa wydajność. Maska pola jest używana w metodach create, get i list. Więcej informacji o maskach pól znajdziesz w artykule Używanie masek pól w interfejsie Sheets API.