Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Omówienie sal konferencyjnych w Google Meet

Tworzenie pokoju w Google Meet za pomocą metody spaces.create

Z tego przewodnika dowiesz się, jak interfejs Google Meet REST API umożliwia tworzenie spotkań w Google Meet i zarządzanie nimi.

Miejsce spotkań to wirtualne miejsce lub trwały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. W danym momencie w jednej przestrzeni może się odbywać tylko jedna aktywna rozmowa wideo. Pokój spotkań pomaga też użytkownikom spotykać się i znajdować wspólne zasoby.

Informacje o pracy z pomieszczeniami do spotkań znajdziesz w artykule Zarządzanie pomieszczeniami do spotkań. Aby dowiedzieć się, jak programowo skonfigurować pomieszczenie do spotkań, przeczytaj artykuł Konfigurowanie ustawień pomieszczenia do spotkań. Aby zarządzać użytkownikami przestrzeni do spotkań, przeczytaj artykuł Zarządzanie użytkownikami przestrzeni do spotkań.

Uprawnienia do metod w pokoju spotkań

W tabeli porównawczej poniżej znajdziesz szczegółowe informacje o rolach w spotkaniu wymaganych do korzystania z metod przestrzeni spotkań:

Metoda	Właściciele	Uczestnicy	Inne
`endActiveConference`
`get`
z ustawieniami,
z aktywną konferencją,
`patch`

Jak Meet identyfikuje miejsce spotkań

Interfejs Meet REST API generuje zasób spaces dla każdego miejsca spotkania. Zasób spaces oferuje wiele punktów wejścia do konferencji.

W tabeli poniżej pokazujemy, jak zidentyfikować i dołączyć do przestrzeni spotkań:

Nazwa pola	Opis
`name`	Nazwa pokoju. Ciąg znaków `{space}` to identyfikator zasobu pokoju sformatowany jako `spaces/{space}`. Jest to unikalny identyfikator generowany przez serwer, w którym wielkość liter ma znaczenie. Na przykład: `spaces/jQCFfuBOdN5z`.
`meetingCode`	Alias nazwy pokoju. `{meetingCode}` to unikalny ciąg znaków, który można wpisać. Wielkość liter nie jest rozróżniana. Jest sformatowany jako `spaces/{meetingCode}`. Na przykład: `spaces/abc-mnop-xyz`. Maksymalna długość to 128 znaków. Jest to część `meetingUri`:`https://meet.google.com/abc-mnop-xyz` Ostrzeżenie: `meetingCode` nie należy przechowywać długoterminowo, ponieważ może zostać odłączony od pokoju spotkań i w przyszłości może być ponownie użyty w innych pokojach spotkań. Zwykle `meetingCode` wygasa po 365 dniach od ostatniego użycia. Więcej informacji znajdziesz w artykule Informacje o kodach spotkań w Google Meet.
`phoneAccess`	Metody dostępu do tego miejsca spotkania przez telefon. Obiekt `phoneAccess` zawiera informacje wymagane do połączenia się z konferencją, w tym regionalne numery telefonów do przestrzeni spotkania i kod PIN przypisany do tego numeru telefonu. Kod PIN składa się tylko z cyfr dziesiętnych, a jego długość może być różna. Na przykład: `"pin": 19707127300`. Podobnie jak w interfejsie Meet, zasób `spaces` zawiera ograniczony zestaw numerów telefonu. Dodatkowe numery telefonów do sali spotkań możesz wyświetlić, dodając parametr `{meetingCode}` do tego adresu URL: `https://meet.google.com/tel/`. Na przykład: `https://meet.google.com/tel/abc-mnop-xyz`.
`gatewaySipAccess`	Metody dostępu do protokołu SIP w tym pokoju spotkań. Adres SIP zawiera szczegółowe informacje o tym, jak sprzęt do wideokonferencji innych firm może znaleźć i dołączyć do konferencji w Meet. Obiekt `gatewaySipAccess` zawiera identyfikator URI i numeryczny kod dostępu. Meet obsługuje schemat identyfikatora URI SIP.

Aby zarządzać przestrzenią spotkań, użyj tych wartości w polu name:

Aby uzyskać szczegółowe informacje o zapleczu konferencyjnym, możesz użyć symbolu spaces/{space} lub aliasu spaces/{meetingCode}. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do sali konferencyjnej.
Aby zaktualizować szczegóły miejsca spotkania, możesz użyć tylko spaces/{space}. Więcej informacji znajdziesz w artykule Aktualizowanie pomieszczenia do spotkań.
Aby zakończyć aktywną rozmowę wideo w przestrzeni spotkań, możesz użyć tylko spaces/{space}. Więcej informacji znajdziesz w artykule Kończenie aktywnej konferencji.
Aby zarządzać członkami pokoju spotkań, możesz używać tylko spaces/{space}. Alias {meetingCode} nie jest obsługiwany. Więcej informacji znajdziesz w artykule Zarządzanie członkami przestrzeni do spotkań.

Zakresy protokołu OAuth według przypadku użycia

W przewodniku Uwierzytelnianie za pomocą Meet znajdziesz listę wszystkich zakresów interfejsu Meet REST API i ich poziomów wrażliwości weryfikacji. W przypadku pracy z przestrzeniami spotkań wymagania dotyczące zakresu różnią się jednak w zależności od tego, czy przestrzeń została utworzona przez Twoją aplikację, czy przez aplikację zewnętrzną (np. Kalendarz Google).

Tabela poniżej zawiera wymagane zakresy OAuth w zależności od konkretnego przypadku użycia przestrzeni do spotkań:

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.created` `https://www.googleapis.com/auth/meetings.space.readonly`
Odczytywanie i edytowanie ustawień wszystkich przestrzeni spotkań, do których użytkownik ma dostęp w dowolnej innej aplikacji, np. w Kalendarzu.	`https://www.googleapis.com/auth/meetings.space.settings`

Pełną listę wszystkich obsługiwanych zakresów i ich poziomów wrażliwości autoryzacji znajdziesz w artykule Zakresy interfejsu Meet REST API.

Cykl życia miejsca spotkań

Podczas swojego cyklu życia miejsce spotkań przechodzi przez kilka stanów. Poniższy diagram przedstawia ogólne etapy cyklu życia przestrzeni spotkań:

Zadzwońspaces.create. Miejsce spotkania zostanie utworzone, a zwrócony obiekt spaces będzie zawierać ciąg znaków meetingUri. Następnie meetingUri jest rozdzielany między uczestników. Przed rozpoczęciem konferencji możesz skonfigurować ustawienia przestrzeni spotkań i zarządzać członkami przestrzeni spotkań.
Przeprowadź ankietę w nowym pokoju spotkań. Aby sprawdzić stan konferencji, wywołaj metodę spaces.get.

Zamiast ankiet możesz też subskrybować wydarzenia w Meet, aby otrzymywać powiadomienia push.
Rozpocznij konferencję. Gdy pierwszy uczestnik kliknie meetingUri w pokoju spotkania, rozpocznie się konferencja. Obiekt activeConference zostaje wypełniony, a ciąg znaków activeConference.conferenceRecord jest ustawiony.
(Opcjonalnie) Uzyskaj dane konferencji. Podczas aktywnej rozmowy wideo możesz uzyskać dostęp do niektórych conferenceRecord wartości. Na przykład wywołaj metodę conferenceRecords.participants.list aby wyświetlić wszystkich uczestników konferencji. Możesz też uzyskać dostęp do tych informacji do 30 dni po konferencji.
(Opcjonalnie) Zakończ rozmowę wideo. Podczas konferencji właściciel spotkania może wywołać metodę spaces.endActiveConference, aby programowo zakończyć aktywną konferencję dla wszystkich uczestników.
Konferencja się kończy. Gdy ostatni uczestnik opuści spotkanie, konferencja się zakończy.
Sprawdzanie dostępności artefaktów po konferencji Rozmowa wideo została zakończona (STATE=ENDED), ale artefakty nie zostały jeszcze wygenerowane. Pola startTime i endTime dotyczące konferencji również zostaną wypełnione. Musisz odpytywać punkt końcowy artefaktu, dopóki obiekt artefaktu nie będzie miał stanu STATE reads FILE_GENERATED.

Zamiast odpytywania możesz subskrybować wydarzenia w Meet, aby otrzymywać powiadomienia push.
Uzyskiwanie materiałów po konferencji Po wygenerowaniu artefaktów, takich jak nagrania, transkrypcje i inteligentne notatki, możesz je pobrać. Aby na przykład uzyskać nagranie według identyfikatora nagrania, wywołaj metodę conferenceRecords.recordings.get.

Gdy będzie gotowy, identyfikator URI obiektu artefaktu zostanie wypełniony i zwrócony jako część obiektu zasobu.