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.
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 poluname
zasobuspaces
.- 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.
Powiązane artykuły
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ć salę konferencyjną za pomocą interfejsu Meet REST API, przeczytaj przewodnik Praca z salami konferencyjnymi.
Więcej informacji o subskrybowaniu zdarzeń Google Workspace znajdziesz w artykule Subskrybowanie wydarzeń za pomocą interfejsu Google Workspace Events API.