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 do spotkań, aby łączyć użytkowników za pomocą wideo.
  • 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).

Wydarzenia w Meet możesz też subskrybować za pomocą interfejsu Google Workspace Event API. Aby otrzymywać powiadomienia o zmianach, zasubskrybuj dane miejsce spotkań lub wszystkie sale należące do określonego użytkownika. Więcej informacji znajdziesz w artykułach Subskrybowanie wydarzeń przy użyciu interfejsu Google Workspace Event API i Subskrybowanie wydarzeń w Google Meet.

Przykłady zastosowań

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

  • Przed konferencją: dostosuj sposób obsługi konferencji do swoich potrzeb, tworząc przestrzeń do spotkań. Możesz też zarządzać zaproszonymi osobami i wstępnie konfigurować ustawienia.

  • Podczas rozmowy wideo: możesz pobierać informacje o rozmowie, aby zmieniać sposób działania aplikacji na podstawie zwróconych metadanych.

  • Po zakończeniu rozmowy wideo: pobierz artefakty rozmowy wideo, takie jak nagranie i transkrypcja.

Oto kilka przykładów:

  • Sprzedaż i zarządzanie kontem

    • Pobieranie informacji o spotkaniach i uczestnikach do celów nagrywania.
    • Pobieraj elementy spotkania i publikuj je na kontach.
    • Przeprowadzaj transkrypcje i nagrania z wykorzystaniem modeli AI, aby generować coaching i analizę skuteczności sprzedaży.

  • Nauka i programowanie

    • Tworzenie i wstępne konfigurowanie spotkań na potrzeby trenowania.
    • Przypisz role współgospodarzy szkoleniom i osobom prowadzącym sesje.
    • Odzyskaj nagrania, dzięki którym uczniowie będą mogli przeglądać materiały po zakończeniu kursu.

  • Operacje dla programistów

    • Twórz spotkania, aby błyskawicznie łączyć się z członkami zespołu.
    • Pozwól innym zainteresowanym osobom na dołączanie do trwających spotkań, udostępniając informacje o spotkaniach w czasie rzeczywistym i uczestnikom.
    • uruchamiać transkrypcję za pomocą modeli AI, aby wygenerować prawidłowe kolejne kroki.
tworzyć dynamiczne spotkania ze współpracownikami i dołączać do nich w pokoju czatu,
Rysunek 1. tworzyć dynamiczne spotkania ze współpracownikami i dołączać 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 typowych terminów używanych w tym interfejsie API:

Artefakt
Plik wygenerowany przez Meet w odpowiedzi na konferencję, 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 przypadku tego wydarzenia doskonałym rozwiązaniem do prowadzenia konferencji 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 przykład rozmowy w miejscu spotkania. Użytkownicy zazwyczaj traktują taki scenariusz jako jedno spotkanie.
Osoba współprowadząca
Osoba biorąca udział w rozmowie, która otrzymała od hosta 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 je kontroluje. Pamiętaj, że organizator spotkania może je zorganizować, ale nie może być obecny podczas spotkania. Gospodarz może też przekazać uprawnienia gospodarza współgospodarzowi.
Kod spotkania
Unikalny 10-znakowy ciąg znaków do wpisywania używany w pokoju spotkania 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. Mogą nie być obecni 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 odbywa się konferencja. 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 przeglądający lub z urządzenia w pomieszczeniu połączonego z rozmową. Każda osoba ma 1 zasób conferenceRecords.participants. Gdy uczestnik dołącza do konferencji, otrzymuje on 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 wielokrotnie dołączy do tej samej rozmowy z użyciem tej samej pary urządzenia, każdemu uczestnikowi zostanie przypisany 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.