Omówienie interfejsu Google Meet API typu REST

Interfejs Google Meet REST API umożliwia tworzenie spotkań w Google Meet i zarządzanie nimi. Oferuje też użytkownikom punkty wejścia bezpośrednio z aplikacji.

Za pomocą interfejsu Meet REST API możesz wykonywać te czynności:

  • Utwórz miejsce spotkań, aby komunikować się z użytkownikami za pomocą rozmów wideo.
  • Znajdź salę lub konferencję według nazwy zasobu.
  • Pobierz listę uczestników i sesji uczestników.
  • Pobierz materiały dotyczące spotkania (nagrania, transkrypcje i transkrypcje).

Możesz też subskrybować wydarzenia w Meet za pomocą interfejsu Google Workspace Events API. Aby otrzymywać powiadomienia o zmianach, możesz zasubskrybować określone miejsce spotkań lub wszystkie sale konferencyjne należące do określonego użytkownika. Więcej informacji znajdziesz w artykułach na temat subskrybowania wydarzeń za pomocą interfejsu Google Workspace Events API oraz subskrybowania wydarzeń w Google Meet.

Przykłady zastosowań

Aplikacje można zintegrować z interfejsem Meet REST API, aby wykonywać te czynności:

  • Przed konferencją: dostosuj przebieg rozmowy wideo przez utworzenie miejsca spotkań. Możesz też zarządzać zaproszonymi i wstępnie skonfigurować ustawienia.

  • Podczas rozmowy wideo: pobierz informacje dotyczące konferencji, aby zmienić działanie aplikacji na podstawie zwróconych metadanych.

  • Po rozmowie wideo: pobierz artefakty rozmowy, takie jak nagranie i transkrypcja.

Interfejs Meet REST API może służyć między innymi do tych celów:

  • Sprzedaż i zarządzanie kontem

    • Pobieranie informacji o spotkaniach i uczestnikach w celu nagrywania.
    • Pobierz artefakty spotkania i opublikuj je na kontach.
    • Przeprowadzaj transkrypcje i nagrania za pomocą modeli AI, aby generować analizy dotyczące skuteczności coachingu i sprzedaży.

  • Nauka i rozwój

    • Tworzenie i wstępne konfigurowanie spotkań na potrzeby trenowania.
    • Przypisz role współgospodarza do trenerów i osób prowadzących sesje.
    • Pobieranie nagrań, które umożliwiają uczniom przeglądanie materiałów po zakończeniu zajęć.

  • Dział operacyjny dewelopera

    • Twórz spotkania, aby błyskawicznie komunikować się z członkami zespołu.
    • Możesz umożliwić innym zainteresowanym dołączanie do trwających spotkań przez udostępnianie informacji o spotkaniach i uczestnikach w czasie rzeczywistym.
    • Uruchamianie danych transkrypcji za pomocą modeli AI w celu wygenerowania odpowiednich kolejnych kroków.
Twórz dynamiczne spotkania ze współpracownikami i dołączaj do nich w pokoju czatu.
Rysunek 1. Twórz dynamiczne spotkania ze współpracownikami i dołączaj do nich w pokoju czatu.

Aby jeszcze bardziej usprawnić współpracę, możesz dodać do swojej aplikacji inne interfejsy Google Workspace API, np. Chat API. Więcej informacji znajdziesz w artykule Przypadki użycia Google Chat.

Często spotykane terminy

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

Artefakt
Plik wygenerowany przez Meet w odpowiedzi na konferencję, w tym nagrania i transcripts. Zwykle artefakt jest gotowy do pobrania zaraz po zakończeniu rozmowy wideo.
Wydarzenie w kalendarzu
Wydarzenie w Kalendarzu Google z kilkoma uczestnikami, zwykle tworzone przez organizatora spotkania, zawierające informacje dla uczestników spotkania. Do obsługi konferencji tego wydarzenia możesz użyć Meet.
Call
Sesja przy użyciu Meet albo powiadomienie innych osób o rozpoczęciu lub trwającej rozmowie i umożliwienie im natychmiastowego dołączenia.
Konferencja
Rozmowa wideo to przykład połączenia w miejscu spotkań. Użytkownicy zwykle traktują taką sytuację jako jedno spotkanie.
Osoba współprowadząca
Osoba biorąca udział w rozmowie, której host przyznał uprawnienia do zarządzania uprawnieniami (oprócz możliwości usunięcia pierwotnego hosta).
Osoba prowadząca
Osoba, która utworzyła rozmowę (organizator spotkania) lub osoba, która ją kontroluje. Pamiętaj, że organizator spotkania może je zorganizować, ale nie może być na nim obecny. Gospodarz może też przekazać uprawnienia gospodarza współgospodarzowi.
Kod spotkania

Niepowtarzalny ciąg 10 znaków, który umożliwia typową nazwę pokoju konferencyjnego i jest używany w jego identyfikatorze URI. Wielkość liter nie jest rozróżniana. Przykład: abc-mnop-xyz. Maksymalna długość to 128 znaków.

Kodów spotkań nie należy przechowywać na dłuższą metę, ponieważ mogą zostać odłączone od miejsca spotkań i można je ponownie wykorzystać w innych salach spotkań w przyszłości. Zwykle kody spotkań wygasają po 365 dniach od ostatniego użycia. Więcej informacji znajdziesz w artykule Więcej informacji o kodach spotkań w Google Meet.

Nazwa spotkania

Unikalny identyfikator generowany przez serwer służący do identyfikowania pokoju spotkań. Wielkość liter jest rozróżniana. Na przykład: jQCFfuBOdN5z. Identyfikator spotkania jest zwracany w polu name zasobu spaces.

Organizator spotkania

Użytkownik, który utworzył pokoje do spotkań. Ten użytkownik może być też właścicielem spotkania. Może nie być obecna podczas rozmowy lub być gospodarzem spotkania. Może być tylko 1 organizator spotkania.

Miejsce spotkań

Miejsce wirtualne lub stały obiekt (np. sala konferencyjna), w którym odbywa się konferencja. W jednym miejscu może się odbywać tylko jedna aktywna konferencja. Miejsce spotkań pomaga też użytkownikom spotykać się ze współdzielonymi zasobami.

Identyfikator URI spotkania

Klikalny adres URL, który rozpoczyna połączenie użytkownika lub dołączy do niego. Każde wywołanie ma unikalny adres URL składający się z ciągu https://meet.google.com/, po którym następuje kod spotkania. Na przykład: https://meet.google.com/abc-mnop-xyz.

Uczestnik

Osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda rozmowę jako przeglądający lub korzysta z urządzenia w pokoju połączonego z rozmową. Każda osoba ma 1 zasób conferenceRecords.participants. Gdy uczestnik dołączy do konferencji, zostanie mu przypisany unikalny identyfikator.

Sesja uczestnika

Unikalny identyfikator sesji tworzony dla każdej pary uczestnik-urządzenie, która dołącza do połączenia. Na każdą sesję przypada 1 zasób conferenceRecords.participants.participantSessions. Jeśli uczestnik kilka razy dołączy do tej samej rozmowy z tej samej pary uczestnik-urządzenie, każdemu z nich zostanie przypisany unikalny identyfikator sesji.

informacje dotyczące autoryzacji i uwierzytelniania specyficznych dla interfejsu API;

Zakresy autoryzacji to uprawnienia, o które prosisz użytkowników w celu autoryzowania aplikacji w celu uzyskania dostępu do treści spotkania. Gdy ktoś instaluje Twoją aplikację, jest proszony o sprawdzenie tych zakresów. Należy wybierać najwęższy możliwy zakres i nie żądać zakresów, których aplikacja nie potrzebuje. Użytkownicy mogą łatwiej przyznawać dostęp do ograniczonych, jasno opisanych zakresów.

Interfejs Meet REST API obsługuje następujące zakresy protokołu OAuth 2.0:

Kod zakresu Opis Wykorzystanie
https://www.googleapis.com/auth/meetings.space.readonly Zezwalaj aplikacjom na odczytywanie metadanych o dowolnym miejscu spotkań, do którego ma dostęp użytkownik. Poufne
https://www.googleapis.com/auth/meetings.space.created Zezwalaj aplikacjom na tworzenie, modyfikowanie i odczytywanie metadanych pokojów spotkań 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 protokołu OAuth 2.0 dla interfejsów API Google.