Omówienie sal konferencyjnych w Google Meet

Ilustracja interfejsu Google Meet REST API

Z tego przewodnika dowiesz się, jak tworzyć spotkania w Google Meet i nimi zarządzać za pomocą interfejsu Google Meet REST API.

Miejsce spotkań to wirtualne miejsce lub trwały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. W danym momencie w jednym miejscu może się odbywać tylko 1 aktywna konferencja. Miejsce spotkań pomaga też użytkownikom spotykać się i znajdować udostępnione zasoby.

Aby dowiedzieć się, jak pracować z miejscami spotkań, przeczytaj artykuł Tworzenie miejsc spotkań i zarządzanie nimi. Aby dowiedzieć się, jak programowo skonfigurować miejsce spotkań, przeczytaj artykuł Konfigurowanie miejsc spotkań i członków.

Jak wywoływać metody miejsca spotkań

W tabeli poniżej znajdziesz informacje o rolach wymaganych do korzystania z metod miejsca spotkań:

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

Jak Meet identyfikuje miejsce spotkań

Interfejs Google Meet REST API generuje zasób spaces dla każdego miejsca spotkań. Zasób spaces oferuje wiele punktów wejścia do dołączenia do konferencji.

W tabeli poniżej pokazano, jak zidentyfikować miejsce spotkań i do niego dołączyć:

Nazwa pola Opis
name Nazwa pokoju. Ciąg znaków {space} to identyfikator zasobu pokoju w formacie spaces/{space}. Jest to unikalny identyfikator wygenerowany przez serwer, w którym rozróżniana jest wielkość liter. Na przykład, spaces/jQCFfuBOdN5z.
meetingCode Alias nazwy pokoju. {meetingCode} to unikalny ciąg znaków, który można wpisać. Nie jest w nim rozróżniana wielkość liter. Ma format spaces/{meetingCode}. Na przykład, spaces/abc-mnop-xyz. Maksymalna długość to 128 znaków. Jest częścią meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Metody dostępu do telefonu w tym miejscu spotkań. Obiekt phoneAccess zawiera informacje wymagane do dołączenia do konferencji przez telefon, w tym regionalne numery telefonów dla miejsca spotkań i kod PIN przypisany do tego numeru. Kod PIN składa się tylko z cyfr dziesiętnych, a jego długość może się różnić. Na przykład "pin": 19707127300.

Podobnie jak w interfejsie Meet, zasób spaces zawiera ograniczony zestaw numerów do dołączania przez telefon. Dodatkowe numery telefonów dla miejsca spotkań możesz zobaczyć, dodając {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 (Session Initiation Protocol) w tym miejscu spotkań. Adres SIP zawiera informacje o tym, jak sprzęt do wideokonferencji innych firm może znaleźć konferencję w Meet i do niej dołączyć. Obiekt gatewaySipAccess zawiera identyfikator URI i numeryczny kod dostępu. Meet obsługuje schemat URI SIP .

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

  • Aby uzyskać szczegółowe informacje o miejscu spotkań, możesz użyć aliasu spaces/{space} lub spaces/{meetingCode}. Więcej informacji znajdziesz w artykule Pobieranie miejsca spotkań.

  • Aby zaktualizować szczegóły miejsca spotkań, możesz użyć tylko spaces/{space}. Więcej informacji znajdziesz w artykule Aktualizowanie miejsca spotkań.

  • Aby zakończyć aktywną konferencję w miejscu spotkań, możesz użyć tylko spaces/{space}. Więcej informacji znajdziesz w artykule Kończenie aktywnej konferencji.

Cykl życia miejsca spotkań

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

Cykl życia miejsca spotkań.
Rysunek 1. Cykl życia miejsca spotkań.

  1. Wywołaj spaces.create. Miejsce spotkań zostanie utworzone, a zwrócony obiekt spaces będzie zawierać ciąg znaków meetingUri. Następnie meetingUri zostanie udostępniony uczestnikom.

  2. Sprawdź nowe miejsce spotkań. Aby sprawdzić stan konferencji, wywołaj metodę spaces.get.

    Zamiast sprawdzać, możesz też subskrybować wydarzenia w Meet aby otrzymywać powiadomienia push .

  3. Rozpocznij konferencję. Gdy pierwszy uczestnik kliknie meetingUri w miejscu spotkań, rozpocznie się konferencja. Obiekt activeConference zostanie wypełniony, a ciąg znaków activeConference.conferenceRecord zostanie ustawiony.

  4. (Opcjonalnie) Pobierz dane konferencji. Podczas aktywnej konferencji możesz uzyskać dostęp do niektórych wartości conferenceRecord. Aby zobaczyć wszystkich uczestników konferencji, wywołaj na przykład conferenceRecords.participants.list metodę. Możesz też uzyskać dostęp do tych informacji przez maksymalnie 30 dni po konferencji.

  5. (Opcjonalnie) Zakończ konferencję. Podczas konferencji właściciel spotkania może wywołać spaces.endActiveConference metodę, aby programowo zakończyć aktywną konferencję dla wszystkich uczestników.

  6. Konferencja się kończy. Gdy ostatni uczestnik opuści konferencję, zostanie ona zakończona.

  7. Sprawdź artefakty po konferencji. Konferencja się zakończyła (STATE=ENDED), ale artefakty nie zostały jeszcze wygenerowane. Wypełnione są też pola startTime i endTime konferencji. Musisz sprawdzać punkt końcowy artefaktu, dopóki w obiekcie artefaktu STATE nie będzie mieć wartości FILE_GENERATED.

    Zamiast sprawdzać, możesz też subskrybować wydarzenia w Meet, aby otrzymywać powiadomienia push.

  8. Pobierz artefakty po konferencji. Po wygenerowaniu artefaktów, takich jak nagrania i transkrypcje, możesz je pobrać. Aby na przykład pobrać nagranie według identyfikatora nagrania, wywołaj conferenceRecords.recordings.get metodę.

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