Omówienie interfejsu Google Meet API typu REST

Interfejs Google Meet REST API umożliwia tworzenie spotkań w Google Meet i zarządzanie nimi oraz oferuje punkty wejścia dla użytkowników bezpośrednio z Twojej aplikacji.

Za pomocą interfejsu Meet REST API możesz:

  • Utwórz pomieszczenie do spotkań, aby połączyć użytkowników za pomocą wideo.
  • Uzyskaj dostęp do sali konferencyjnej lub konferencji według nazwy zasobu.
  • uzyskać listę uczestników i ich sesji;
  • Pobieranie artefaktów spotkania (nagrania, transkrypcje i wpisy w transkrypcji).

Zdarzenia w Meet możesz też subskrybować za pomocą interfejsu Google Workspace Events API. Aby otrzymywać powiadomienia o zmianach, możesz subskrybować wybrany pokój spotkań lub wszystkie pokoje spotkań należące do określonego użytkownika. Więcej informacji znajdziesz w artykułach Subskrybowanie zdarzeń za pomocą interfejsu Events API w Google Workspace i Subskrybowanie zdarzeń Google Meet.

Przypadki użycia

Aplikacje mogą się integrować z interfejsem Meet REST API, aby wykonywać te czynności:

  • Przed konferencją: spersonalizuj konferencję, tworząc przestrzeń spotkań. Możesz też zarządzać zaproszonymi osobami i wstępnie konfigurować ustawienia.

  • Podczas konferencji: pobieranie informacji o konferencji w celu zmiany działania aplikacji na podstawie zwróconych metadanych.

  • Po konferencji: pobierz materiały z konferencji, takie jak nagranie i transkrypcja.

Oto kilka przykładów zastosowań interfejsu Meet REST API:

  • Sprzedaż i zarządzanie kontem

    • pobieranie informacji o spotkaniach i uczestnikach na potrzeby archiwizacji;
    • Pobierać artefakty spotkań i publikować je na kontach.
    • Przesyłanie transkrypcji i nagrania do modeli AI w celu generowania analizy skuteczności sprzedaży i coachingu.

  • Nauka i rozwój

    • Utwórz i wstępnie skonfiguruj spotkania na potrzeby szkolenia.
    • Przypisz role współgospodarza wykładowcom i prowadzącym sesje.
    • Pobierać nagrania, które umożliwiają uczniom powtórkę materiału po zakończeniu kursu.

  • Działania związane z programistami

    • tworzyć spotkania, aby błyskawicznie łączyć się z innymi pracownikami.
    • Udostępnianie informacji o bieżących spotkaniach i ich uczestnikach innym zainteresowanym osobom.
    • Prześlij dane transkrypcji do modeli AI, aby wygenerować poprawne następne kroki.
Tworzenie i dołączanie do dynamicznych spotkań ze współpracownikami w pokoju czatu.
Rysunek 1. Tworzenie i dołączanie do dynamicznych spotkań ze współpracownikami w pokoju czatu.

Aby jeszcze bardziej usprawnić współpracę, możesz też dodać do aplikacji inne interfejsy Google Workspace, takie jak Chat API. Więcej informacji znajdziesz w artykule Zastosowania czatu.

Często spotykane terminy

Oto lista typowych terminów używanych w tym interfejsie API:

Artefakt
Plik wygenerowany przez Meet w odpowiedzi na konferencję, np. nagrania i transkrypcje. Zwykle artefakt jest gotowy do pobrania wkrótce po zakończeniu konferencji.
wydarzenie w kalendarzu,
Wydarzenie w Kalendarzu Google z wieloma uczestnikami, zwykle utworzone przez organizatora spotkania, zawierające informacje o dołączeniu do spotkania. Meet może być rozwiązaniem konferencyjnym na potrzeby wydarzenia.
Call
sesji w Meet lub powiadomić innych, że połączenie się rozpoczęło lub trwa, i umożliwić im natychmiastowe dołączenie;
Konferencja
Konferencja to instancja połączenia w salach konferencyjnych. Użytkownicy zazwyczaj uważają, że w tym przypadku jest to jedno spotkanie.
Osoba współprowadząca
Uczestnik rozmowy, któremu gospodarz przyznał uprawnienia do zarządzania gospodarzem, z wyjątkiem możliwości usunięcia pierwotnego gospodarza.
Osoba prowadząca
Osoba, która utworzyła połączenie (organizator spotkania) lub osoba, która nim zarządza. Pamiętaj, że organizator spotkania może zorganizować spotkanie, ale nie musi być obecny, gdy się ono odbywa. Gospodarz może też przekazać uprawnienia gospodarza współgospodarzowi.
Kod spotkania

Unikalny ciąg znaków o długości 10 znaków, który można wpisać w pokoju spotkań i który jest używany w identyfikatorze URI spotkania pokoju spotkań. Wielkość liter nie ma znaczenia. Na przykład: abc-mnop-xyz. Maksymalna długość to 128 znaków.

Kodów spotkań nie należy przechowywać długoterminowo, ponieważ mogą one zostać odłączone od pokoju spotkań i wykorzystane ponownie w innych pokojach spotkań. Zazwyczaj kody spotkań wygasają po 365 dniach od ostatniego użycia. Więcej informacji znajdziesz w artykule Informacje o kodach spotkań w Google Meet.

Nazwa spotkania

Unikalny identyfikator generowany przez serwer, który służy do identyfikacji miejsca spotkania. Wielkość liter ma znaczenie. Na przykład: jQCFfuBOdN5z. Identyfikator spotkania jest zwracany w polu name zasobu spaces.

Organizator spotkania

Użytkownik, który utworzył pokój spotkań. Ten użytkownik może być też właścicielem spotkania. Nie muszą być obecni podczas rozmowy ani być organizatorem spotkania. Może być tylko jeden organizator spotkania.

Miejsce spotkań

Wirtualne miejsce lub trwały obiekt (np. sala konferencyjna), w którym odbywa się konferencja. W jednym miejscu może odbywać się tylko jedna aktywna rozmowa wideo. Zaplecze konferencyjne pomaga też użytkownikom spotykać się i znajdować udostępnione zasoby.

Identyfikator URI spotkania

Klikalny adres URL, który uruchamia lub łączy użytkownika z połączeniem. Każde połączenie ma unikalny adres URL, który składa się z https://meet.google.com/ i kodu spotkania. Na przykład: https://meet.google.com/abc-mnop-xyz.

Uczestnik

Osoba dołączająca do rozmowy lub korzystająca z trybu towarzyszącego, osoba oglądająca rozmowę jako widz lub urządzenie w sali konferencyjnej połączone z rozmową. Każda osoba ma do dyspozycji jeden zasób: conferenceRecords.participants Gdy uczestnik dołącza do rozmowy wideo, przypisujemy mu unikalny identyfikator.

Sesja uczestnika

Unikalny identyfikator sesji utworzony dla każdej pary uczestnik–urządzenie, która dołącza do wywołania. W przypadku każdej sesji jest jeden zasób conferenceRecords.participants.participantSessions. Jeśli uczestnik dołącza do tego samego połączenia kilka razy z użyciem tej samej pary uczestnik–urządzenie, każdemu z tych połączeń przypisany jest unikalny identyfikator sesji.