Miejsce spotkań to wirtualne miejsce 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 na spotkanie za pomocą metody spaces.create, zwraca ona wystąpienie zasobu spaces. Zasób zawiera obiekt SpaceConfig, który jest konfiguracją miejsca spotkań. Zawiera też obiekt ActiveConference, który jest linkiem do bieżącego zasobu conferenceRecordsw przestrzeni spotkania. Więcej informacji o zarządzaniu pokojem do spotkań znajdziesz w artykule Tworzenie pokoi do spotkań i zarządzanie nimi.
W kolejnych sekcjach znajdziesz szczegółowe informacje o tym, jak skonfigurować salę konferencyjną za pomocą tych obiektów i metod.
Konfigurowanie moderowania i dostępu do spotkań
Za pomocą obiektu SpaceConfig możesz określić, jak użytkownicy dołączają do spotkania, jakie są tryby moderowania, ograniczenia funkcji i jakie uprawnienia otrzymują użytkownicy, gdy dołączają do spotkania.
Dostęp do sal konferencyjnych
Aby określić, kto może dołączyć do pokoju spotkań bez proszenia o zaakceptowanie, ustaw pole accessType za pomocą obiektu AccessType.
Możesz wybrać spośród kilku ustawień, czy automatycznie zezwalać uczestnikom na dołączanie. Domyślnie w polu są ustawione domyślne ustawienia dostępu użytkownika.
Aby zdefiniować punkty wejścia, których można używać do dołączania do spotkań prowadzonych w sali konferencyjnej, skonfiguruj pole entryPointAccess za pomocą obiektu EntryPointAccess. Ustaw na ALL, aby zezwolić na wszystkie punkty wejścia, lub na CREATOR_APP_ONLY, aby ograniczyć punkty wejścia tylko do tych należących do projektu Google Cloud, który utworzył przestrzeń spotkań.
Generowanie raportu o obecności
Aby utworzyć raport o obecności w pokoju spotkań, ustaw pole logiczne attendanceReportGenerationType za pomocą obiektu AttendanceReportGenerationType. Jeśli poprosisz o raport, Google Meet zapisze go na Dysku Google organizatora spotkania i wyśle e-maila.
Moderowanie sal konferencyjnych
Aby moderować spotkanie, możesz ustawić pole logiczne moderation za pomocą obiektu Moderation.
Gdy tryb moderation ma wartość on, gospodarz spotkania ma kontrolę nad spotkaniem, korzystając z funkcji takich jak zarządzanie współgospodarzem (patrz spaces.members) i ograniczenia funkcji za pomocą pola moderationRestrictions. Więcej informacji o użytkownikach znajdziesz w artykule Zarządzanie użytkownikami pokoju.
Aby zdefiniować ograniczenia funkcji podczas moderowania spotkania (wartość moderation to on), skonfiguruj pole moderationRestrictions za pomocą obiektu ModerationRestrictions. Ograniczenia określają, kto w pokoju spotkania ma uprawnienia do wysyłania wiadomości na czacie lub reakcji oraz do udostępniania ekranu.
Aby ustawić ograniczenia funkcji w polu moderationRestrictions, użyj enumeracji RestrictionType, aby zastosować wartości chatRestriction, reactionRestriction i presentRestriction. Ustaw wartość HOSTS_ONLY, aby zastosować uprawnienia zarówno do organizatora spotkania, jak i współprowadzącego, lub NO_RESTRICTION, aby zastosować je do wszystkich uczestników.
Aby ograniczyć domyślną rolę przypisaną użytkownikom do roli przeglądającego, użyj pola logicznego defaultJoinAsViewerType, korzystając z enumeracji DefaultJoinAsViewerType. Jeśli defaultJoinAsViewerType to on, użytkownicy dołączają jako widzowie. Jeśli off, użytkownicy dołączają jako współtwórcy. Wartość domyślna to off. Jeśli dla użytkownika w spaces.members ustawiona jest konkretna rola, użytkownik dołącza z tą rolą.
Zarządzanie artefaktami automatycznymi
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, przestrzeń spotkania jest nagrywana, generowane są transkrypcje, a notatki ze spotkania są automatycznie rejestrowane i organizowane w Dokumentach Google. Każda funkcja jest niezależna i 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.
Aby ustawić automatyczne artefakty, użyj obiektu ArtifactConfig w obiekcie SpaceConfig. ArtifactConfig składa się z pól recordingConfig, transcriptionConfig i smartNotesConfig.
Każde pole jest mapowane na podobny obiekt, np. RecordingConfig, TranscriptionConfig i SmartNotesConfig. Aby ustawić poszczególne obiekty, użyj typu z wartościami logicznymi AutoGenerationType, aby przełączyć obiekt konfiguracji on lub off.
Zakresy protokołu OAuth dla ustawień
Aby ustawić ustawienia spotkań lub uzyskać do nich dostęp, musisz mieć te zakresy OAuth:
| Przypadek użycia | 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 |
| Pobierz lub wyświetl inne ustawienia 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 zakresie uprawnień OAuth znajdziesz w artykule Zakresy uprawnień interfejsu Meet REST API.
Zarządzanie użytkownikami w pokoju
Organizatorzy spotkania mogą zawsze dołączać do spotkania bez pukania, ale możesz też skonfigurować dodatkowe osoby, które będą mogły dołączać do spotkania bez pukania.
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 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 pominiesz parametr fields, odpowiedź interfejsu API będzie domyślnie ustawiona na "name,email,role,user".
Parametr fields korzysta z FieldMask do filtrowania odpowiedzi. Pole FieldMask umożliwia wywołującym interfejs API określenie pól, które mają zostać zwrócone w ramach żądania. 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.