Miejsce spotkań to wirtualne miejsce lub trwały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. Przestrzeń do spotkań pomaga też użytkownikom spotykać się i znajdować wspólne zasoby.
Gdy utworzysz miejsce spotkania za pomocą metody spaces.create, zwróci ona instancję zasobu spaces. Zasób zawiera obiekt SpaceConfig, który jest konfiguracją miejsca spotkań. Zawiera też obiekt
ActiveConference
będący linkiem do bieżącego
conferenceRecords
zasobu w przestrzeni spotkań. Więcej informacji o zarządzaniu pomieszczeniem do spotkań znajdziesz w artykule Tworzenie pomieszczeń do spotkań i zarządzanie nimi.
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak skonfigurować przestrzeń spotkań za pomocą tych obiektów i metod.
Ustawianie moderowania i dostępu do spotkania
Za pomocą obiektu SpaceConfig możesz określić, jak użytkownicy dołączają do spotkania, tryby moderowania, ograniczenia funkcji i uprawnienia, które użytkownicy otrzymują po dołączeniu do spotkania.
Dostęp do sal konferencyjnych
Aby określić, kto może dołączyć do przestrzeni spotkania bez wysyłania prośby o dołączenie, ustaw pole accessType za pomocą obiektu AccessType.
Możesz wybrać różne ustawienia dotyczące automatycznego zezwalania uczestnikom na dołączanie do spotkania. Domyślnie w tym polu są wyświetlane domyślne ustawienia dostępu użytkownika.
Aby zdefiniować punkty wejścia, których można używać do dołączania do spotkań hostowanych w przestrzeni spotkań, ustaw pole entryPointAccess za pomocą obiektu EntryPointAccess. Ustaw wartość ALL, aby zezwolić na wszystkie punkty wejścia, lub CREATOR_APP_ONLY, aby ograniczyć punkty wejścia tylko do tych, które należą do projektu Google Cloud, w którym utworzono miejsce spotkania.
Generowanie raportu o obecności
Aby utworzyć raport o obecności w pokoju spotkań, ustaw pole logiczne
attendanceReportGenerationType za pomocą obiektu
AttendanceReportGenerationType. Jeśli raport zostanie poproszony, Google Meet zapisze go na Dysku Google organizatora spotkania i wyśle e-maila.
Moderowanie przestrzeni spotkań
Aby moderować spotkanie, możesz ustawić pole logiczne moderation za pomocą obiektu Moderation.
Gdy tryb moderation jest on, organizator spotkania ma kontrolę nad spotkaniem dzięki funkcjom takim jak zarządzanie współgospodarzami (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, gdy spotkanie jest moderowane (moderation to on), ustaw pole moderationRestrictions za pomocą obiektu ModerationRestrictions. Ograniczenia określają, kto ma uprawnienia w pokoju spotkania do wysyłania wiadomości na czacie lub reakcji albo do udostępniania ekranu.
Aby ustawić ograniczenia funkcji w polu moderationRestrictions, użyj wyliczenia RestrictionType, aby zastosować wartości chatRestriction, reactionRestriction i presentRestriction. Ustaw HOSTS_ONLY, aby zastosować uprawnienia zarówno do organizatora spotkania, jak i współorganizatora, lub NO_RESTRICTION, aby zastosować je do wszystkich uczestników.
Aby ograniczyć domyślną rolę przypisywaną użytkownikom do roli przeglądającego, ustaw pole logiczne
defaultJoinAsViewerType
za pomocą wyliczenia
DefaultJoinAsViewerType. Jeśli defaultJoinAsViewerType ma wartość 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 w spaces.members ustawiono dla użytkownika konkretną rolę, dołączy on do spotkania z tą rolą.
Zarządzanie automatycznymi artefaktami
Organizatorzy spotkań, ale nie współgospodarze, mogą wstępnie skonfigurować automatyczne nagrywanie, automatyczne transkrypcje i funkcję „zrób za mnie notatki” w przestrzeni spotkania. Gdy te ustawienia są włączone, przestrzeń spotkania jest nagrywana, generowane są transkrypcje, a notatki ze spotkania są automatycznie zapisywane i porządkowane w Dokumentach Google. Każda funkcja jest niezależna i jest ustawiana dla każdej przestrzeni spotkań. Napisy do nagrań są dostępne tylko w języku angielskim.
Automatyczne artefakty możesz skonfigurować wstępnie podczas tworzenia pokoju spotkań lub po jego utworzeniu. Ta funkcja umożliwia też konfigurowanie automatycznych artefaktów w przypadku spotkań utworzonych w Kalendarzu Google. Obie metody wymagają zakresu OAuth meetings.space.settings. Więcej informacji znajdziesz w artykule Zakresy OAuth dla ustawień.
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ć każdy obiekt, użyj wyliczenia logicznego AutoGenerationType, aby przełączać obiekt konfiguracji on lub off.
Zakresy protokołu OAuth dla ustawień
Ustawianie ustawień spotkań i uzyskiwanie do nich dostępu wymaga tych zakresów OAuth:
| Przypadek użycia | Kod zakresu |
|---|---|
| Ustaw automatyczne generowanie artefaktów w przestrzeniach utworzonych przez inne aplikacje. | https://www.googleapis.com/auth/meetings.space.settings |
| Pobieranie lub 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 przestrzeni spotkań utworzonej przez aplikację innej firmy. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Odczytywanie i edytowanie ustawień wszystkich przestrzeni spotkań, do których użytkownik ma dostęp w innych aplikacjach, np. w Kalendarzu. | https://www.googleapis.com/auth/meetings.space.settings |
Więcej informacji o zakresach OAuth znajdziesz w artykule Zakresy interfejsu Meet REST API.
Zarządzanie osobami w pokoju
Organizatorzy spotkań mogą zawsze dołączyć do spotkania bez proszenia o zaakceptowanie, ale możesz też skonfigurować dodatkowych uczestników, którzy będą mogli dołączyć do spotkania bez proszenia o zaakceptowanie.
Dodatkowo można skonfigurować role uczestników spotkania, np. COHOST, która daje im takie same możliwości zarządzania spotkaniem jak organizatorowi. Więcej informacji o dostępie do pomieszczenia 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. Uczestnik to osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda jako widz lub korzysta z urządzenia w sali połączonego z rozmową. Każda osoba ma 1 conferenceRecords.participants zasób.
Użytkownikami pokoju możesz zarządzać w ten sposób:
Każda metoda przyjmuje parametr ścieżki. Metody create i list używają pola parent do oznaczenia przestrzeni spotkań, a metody delete i get używają pola name do filtrowania wyników na podstawie przestrzeni spotkań i nazwy członka.
Wszystkie metody z wyjątkiem metody delete obsługują parametr fields w SystemParameterContext.
Jeśli pominiesz parametr fields, domyślna odpowiedź interfejsu API to "name,email,role,user".
Parametr fields korzysta z parametru FieldMask do filtrowania odpowiedzi. FieldMask to sposób, w jaki wywołujący interfejs API mogą wyświetlać listę pól, które powinny być zwracane przez żądanie. Jest to lista pól rozdzielonych przecinkami, która służy do określania, że w obiekcie mają być używane tylko wybrane pola, a pozostałe pola mają pozostać bez zmian.
Użycie FieldMask pozwala interfejsowi API uniknąć niepotrzebnej pracy i zwiększa wydajność. Maska pola jest używana w metodach tworzenia, pobierania i wyświetlania listy. Więcej informacji o maskach pól znajdziesz w artykule Używanie maski pól w dokumentacji interfejsu Google Sheets API.