Omówienie interfejsu Google Meet API typu REST

Interfejs API Google Meet typu REST pozwala tworzyć spotkania w Google Meet i nimi zarządzać. Zapewnia użytkownikom punkty wejścia bezpośrednio z aplikacji.

Interfejs Meet REST API umożliwia:

  • Utwórz miejsce spotkań.
  • Znajdź salę lub konferencję według nazwy zasobu.
  • Uzyskaj listę uczestników i sesji uczestników.
  • Dostęp do elementów spotkania (nagrań, transkrypcji i transkrypcji).

Poniżej znajduje się lista typowych terminów używanych w tym interfejsie API:

Artefakt
Plik wygenerowany przez Google Meet w odpowiedzi na rozmowę wideo, np. nagrania i transcripts. Zwykle artefakt jest gotowy do pobrania zaraz po zakończeniu konferencji.
Wydarzenie w kalendarzu
Wydarzenie w Kalendarzu Google z wieloma uczestnikami, zazwyczaj tworzone przez organizatora spotkania, zawierające informacje dla uczestników. W takim przypadku rozwiązaniem może być Meet.
Zadzwoń do nas
sesję w Meet, a także powiadomienie innych osób o rozpoczęciu lub trwającej rozmowie, aby umożliwić im natychmiastowe dołączenie;
Konferencja
Rozmowa wideo to wystąpienie połączenia w miejscu spotkań. Użytkownicy zwykle uznają taki scenariusz za 1 spotkanie.
Osoba prowadząca
osoba, która utworzyła rozmowę (organizator spotkania), lub osoba, która kontroluje rozmowę. Pamiętaj, że organizator spotkania może go zorganizować, ale nie może być obecny podczas spotkania. Gospodarz może też przekazać uprawnienia gospodarza współgospodarzowi.
Kod spotkania
Niepowtarzalny ciąg 10 znaków do pisania w miejscu spotkań, który jest używany w adresie URL do dołączania do spotkania. Na przykład abc-mnop-xyz. Kodów spotkań nie należy przechowywać przez długi czas, ponieważ mogą zostać oddzielone od miejsca spotkań i w przyszłości można ich używać w różnych salach. Zazwyczaj kody spotkań wygasają po 365 dniach od ostatniego użycia. Więcej informacji o kodach spotkań w Google Meet znajdziesz w artykule Informacje o kodach spotkań.
Nazwa spotkania
Unikalny identyfikator generowany przez serwer, który identyfikuje miejsce spotkań. Identyfikator spotkania jest zwracany w polu name zasobu spaces.
Organizator spotkania
Użytkownik, który utworzył miejsce spotkań. Taki użytkownik może być również właścicielem spotkania. Może nie być obecny podczas rozmowy lub być gospodarzem spotkania. Spotkanie może mieć tylko jeden organizator.
Miejsce spotkań
wirtualne miejsce lub stały obiekt (np. sala konferencyjna), w którym odbywają się konferencje. W danym momencie w jednym miejscu może się odbywać tylko jedna aktywna konferencja. Przestrzeń konferencyjna ułatwia też użytkownikom spotkania się i znajdowanie udostępnionych materiałów.
Uczestnik
Osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda film jako widz albo jest z urządzenia w pomieszczeniu połączonego z rozmową. Każda osoba ma 1 zasób conferenceRecords.participants. Gdy uczestnik dołącza do rozmowy, otrzymuje unikalny identyfikator.
Sesja z uczestnikami
Unikalny identyfikator sesji tworzony dla każdej pary urządzenia uczestnika, która dołącza do rozmowy. Na każdą sesję przypada 1 zasób conferenceRecords.participants.participantSessions. Jeśli uczestnik dołączy do tej samej rozmowy kilka razy z tej samej pary urządzenia i uczestnik, otrzyma unikalny identyfikator sesji.

Uwierzytelnianie i autoryzacja związane z interfejsem API

Zakresy autoryzacji to uprawnienia, o które prosisz użytkowników o autoryzację dostępu aplikacji do treści spotkania. Gdy ktoś zainstaluje Twoją aplikację, użytkownik zostanie poproszony o zweryfikowanie tych zakresów. Ogólnie staraj się wybierać możliwie najwęższy zakres i unikaj wysyłania żądań dotyczących zakresów, których aplikacja nie wymaga. Użytkownicy znacznie łatwiej przyznają dostęp do ograniczonych, jasno opisanych zakresów.

Interfejs Meet REST API obsługuje te zakresy OAuth 2.0:

Kod zakresu Opis Wykorzystanie
https://www.googleapis.com/auth/meetings.space.readonly Zezwalaj aplikacjom na odczytywanie metadanych dotyczących wszystkich miejsc spotkań, do których użytkownik ma dostęp. Poufne
https://www.googleapis.com/auth/meetings.space.created Zezwalaj aplikacjom na tworzenie, modyfikowanie i odczytywanie metadanych sal konferencyjnych utworzonych przez Twoją aplikację. Poufne
https://www.googleapis.com/auth/drive.readonly Zezwalaj aplikacjom na pobieranie plików z nagraniami i transkrypcjami z interfejsu Google Drive API. Z ograniczeniem

Więcej informacji o konkretnych zakresach protokołu OAuth 2.0 znajdziesz w artykule Zakresy OAuth 2.0 dla interfejsów API Google.

  • Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Programowanie w Google Workspace.

  • Aby dowiedzieć się, jak utworzyć miejsce na spotkania za pomocą interfejsu Meet REST API, przeczytaj przewodnik Praca z salami konferencyjnymi.