Przestrzeń konferencyjna to wirtualna lokalizacja lub trwały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. Zaplecze konferencyjne pomaga też użytkownikom spotykać się i znajdować udostępnione zasoby.
Gdy tworzysz pokój spotkań za pomocą metody spaces.create(), zwraca ona 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. Więcej informacji o zarządzaniu pomieszczeniem do spotkań znajdziesz w artykule Praca z pomieszczeniami do spotkań.
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, organizator spotkania ma kontrolę nad spotkaniem za pomocą funkcji takich 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 gospodarza i współgospodarza spotkania 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 o zaakceptowanie.
Dodatkowo można skonfigurować uprawnienia użytkowników na spotkaniu, takie jak COHOST, które dają im te same możliwości zarządzania spotkaniem co organizatorowi. 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 tworzenia i wyświetlania, używając pola parent do oznaczania miejsca spotkania, oraz metodami usuwania i pobierania, używając pola name do filtrowania wyników na podstawie miejsca spotkania 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 ustawiona na "name,email,role,user".
Parametr fields korzysta z FieldMask do filtrowania odpowiedzi. FieldMask to sposób na podanie przez wywołujących interfejs API listy 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.
Zarządzanie automatycznymi artefaktami
Organizatorzy spotkań, ale nie współgospodarze, mogą wstępnie skonfigurować automatyczne nagrywanie, automatyczne transkrypcje i „robienie notatek dla mnie” w przestrzeni spotkania. Gdy te ustawienia są włączone, automatycznie rejestruje się pokój konferencyjny, generuje się transkrypcja, a notatki ze spotkania są automatycznie przechwytywane i porządkowane w Dokumentach Google. Każda funkcja jest niezależna i jest ustawiana osobno dla każdej sali konferencyjnej. Napisy do nagrań są dostępne tylko w języku angielskim.
Automatyczne artefakty możesz skonfigurować wcześniej, gdy tworzysz salę spotkań lub po jej utworzeniu. Ta funkcja umożliwia też konfigurowanie automatycznych artefaktów dla spotkań utworzonych w Kalendarzu Google. Obie metody wymagają zakresu OAuth meetings.space.settings. Więcej informacji znajdziesz w sekcji Zakresy uprawnień OAuth.
Autorskie artefakty są ustawiane za pomocą obiektu ArtifactConfig w obiekcie SpaceConfig, który jest częścią zasobu spaces. ArtifactConfig składa się z pól recordingConfig, transcriptionConfig i smartNotesConfig.
Każde pole jest mapowane na podobny obiekt, np. RecordingConfig, TranscriptionConfig i SmartNotesConfig. Każdy obiekt jest ustawiany za pomocą typu z wartościami logicznymi AutoGenerationType, aby włączyć lub wyłączyć obiekt konfiguracji.
Zakresy protokołu OAuth dla ustawień
Aby ustawić ustawienia spotkań lub uzyskać do nich dostęp, musisz mieć te zakresy uprawnień OAuth:
| Zastosowanie | Kod zakresu |
|---|---|
| Ustaw automatyczne generowanie artefaktów w przypadku pokoi utworzonych przez inne aplikacje. | https://www.googleapis.com/auth/meetings.space.settings |
| Pobieranie i wyświetlanie artefaktów z konferencji utworzonych przez inne aplikacje. | https://www.googleapis.com/auth/meetings.space.readonly |
| Pobieranie lub wyświetlanie innych ustawień przed spotkaniem w pokoju spotkań utworzonym przez aplikację innej firmy. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| odczytywać i edytować ustawienia wszystkich sal konferencyjnych, do których użytkownik ma dostęp za pomocą dowolnej innej aplikacji, np. Kalendarza; | https://www.googleapis.com/auth/meetings.space.settings |
Więcej informacji o zakresach OAuth znajdziesz w artykule Zakresy uprawnień interfejsu Meet REST API.