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 użytkownikom punkty wejścia bezpośrednio z aplikacji.

Interfejs Meet REST API umożliwia:

  • Twórz i konfiguruj pokoje spotkań, aby umożliwić użytkownikom łączenie się za pomocą wideo.
  • Wstępnie skonfiguruj poziomy dostępu do przestrzeni, ustawienia moderowania oraz automatyczne nagrywanie lub transkrypcję.
  • zarządzać osobami w pokoju spotkania i przypisywać role współgospodarza;
  • kończyć aktywne konferencje programowo w przestrzeni spotkań;
  • Pobieranie rekordów konferencji, szczegółów obecności i metadanych sesji uczestników.
  • pobierać artefakty ze spotkań (nagrania, transkrypcje, wpisy w transkrypcjach i inteligentne notatki);

Możesz też subskrybować zdarzenia w Meet za pomocą interfejsu Google Workspace Events API. Aby otrzymywać powiadomienia o zmianach, możesz zasubskrybować określony pokój spotkań lub wszystkie pokoje spotkań należące do określonego użytkownika. Aby dowiedzieć się więcej, zobacz:

Przypadki użycia

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

  • Przed konferencją: twórz przestrzenie spotkań na żądanie, wstępnie konfiguruj ograniczenia dostępu (otwarte, zaufane lub ograniczone), stosuj elementy sterujące moderacją (udostępnianie ekranu, czat, reakcje, mikrofon i kamera), konfiguruj automatyczne nagrywanie lub automatyczną transkrypcję oraz przypisuj członków przestrzeni z rolami współgospodarzy.

  • Podczas konferencji: pobieraj aktywne metadane konferencji i sesje uczestników, dynamicznie zarządzaj członkami, nasłuchuj zdarzeń cyklu życia w czasie rzeczywistym za pomocą interfejsu Google Workspace Events API lub programowo kończ aktywną konferencję.

  • Po konferencji: pobieraj z Dysku Google zapisy konferencji i dzienniki obecności, nagrania, transkrypcje z Dokumentów Google i inteligentne notatki oraz uzyskuj dostęp do szczegółowych wpisów w transkrypcji, które mogą być przydatne w szkoleniach, zapewnianiu zgodności z przepisami lub analizie z wykorzystaniem AI.

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

  • Sprzedaż i zarządzanie kontem

    • pobierać informacje o spotkaniu i uczestnikach do celów dokumentacyjnych;
    • Pobieraj artefakty ze spotkań i publikuj je na kontach.
    • Przeprowadzaj transkrypcje i nagrania przez modele AI, aby generować analizy skuteczności sprzedaży i szkolenia.

  • Nauka i rozwój

    • Tworzenie i wstępne konfigurowanie spotkań na potrzeby szkoleń.
    • Przypisz role współgospodarza trenerom i osobom prowadzącym sesje.
    • Odtwarzanie nagrań, aby uczniowie mogli przejrzeć materiały po zakończeniu kursu.

  • Obsługa klienta i doradztwo

    • Twórz bezpieczne, ograniczone przestrzenie do spotkań bezpośrednio z zgłoszeń do działu pomocy lub portali klientów.
    • Wstępnie skonfiguruj zarządzanie uprawnieniami, aby tylko pracownicy zespołu pomocy mogli prezentować treści lub zarządzać listą uczestników.
    • Włącz automatyczne nagrywanie lub transkrypcję na potrzeby zapewniania jakości i dokumentacji zgodności.
    • Programowe kończenie aktywnych konferencji po zakończeniu spotkań lub sesji pomocy.

  • Operacje deweloperskie

    • tworzyć spotkania, aby błyskawicznie kontaktować się z członkami zespołu;
    • Umożliwiaj innym osobom dołączanie do trwających spotkań przez udostępnianie informacji o spotkaniu i uczestnikach w czasie rzeczywistym.
    • Przetwarzaj dane transkrypcji za pomocą modeli AI, aby generować prawidłowe kolejne kroki.
Twórz dynamiczne spotkania i dołączaj do nich w pokoju czatu.
Rysunek 1. Twórz dynamiczne spotkania i dołączaj do nich w pokoju czatu.

Możesz też zintegrować z aplikacją inne interfejsy Google Workspace API, takie jak Chat API, aby jeszcze bardziej ułatwić współpracę. Więcej informacji znajdziesz w artykule Przykłady zastosowań Google Chat.

Często spotykane terminy

Oto lista najczęstszych terminów używanych w tym interfejsie API:

Aktywna konferencja
Trwająca konferencja w przestrzeni do spotkań. W danym momencie w przestrzeni spotkania może się odbywać tylko 1 aktywna rozmowa wideo. Po zakończeniu rozmowy staje się ona zapisem historycznym.
Artefakt
Plik wygenerowany przez Meet w odpowiedzi na konferencję, np. recordings, transcripts i smartNotes. Artefakty są zapisywane na Dysku organizatora spotkania. Zwykle są one gotowe 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 dla uczestników spotkania. Meet może być rozwiązaniem konferencyjnym dla wydarzenia.
Call
sesję w Meet lub powiadomić inne osoby, że połączenie się rozpoczyna lub trwa, i umożliwić im natychmiastowe dołączenie;
Osoba współprowadząca
Osoba uczestnicząca w rozmowie, która otrzymała od gospodarza uprawnienia do zarządzania, z wyjątkiem możliwości usunięcia pierwotnego gospodarza.
Konferencja
Konferencja to instancja połączenia w przestrzeni spotkania. Użytkownicy zwykle traktują ten scenariusz jako jedno spotkanie.
Rekord konferencji
Unikalny identyfikator każdego wystąpienia konferencji. Jest on tworzony automatycznie po rozpoczęciu konferencji. Zasób conferenceRecords używa formatu conferenceRecords/{conferenceRecord}. Na przykład: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Dołączanie przez telefon
Aby wziąć udział w połączeniu przez telefon lub posłuchać transmitowanego połączenia.
Osoba prowadząca
Osoba, która utworzyła połączenie (organizator spotkania) lub osoba, która kontroluje połączenie. Pamiętaj, że organizator spotkania może je zorganizować, ale nie musi być obecny podczas jego trwania. Gospodarz może też przekazać uprawnienia gospodarza współgospodarzowi.
Kod spotkania

Unikalny ciąg 10 znaków, który można wpisać, w przypadku miejsca spotkania używanego w identyfikatorze URI spotkania miejsca spotkania. 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 w przyszłości mogą być ponownie użyte w innych pokojach spotkań. Zwykle 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 wygenerowany przez serwer, który służy do identyfikowania przestrzeni spotkań. Wielkość liter ma znaczenie. Na przykład: jQCFfuBOdN5z. Identyfikator spotkania jest zwracany w polu name zasobu spaces. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.

Organizator spotkania

Użytkownik, który utworzył pokój spotkań. Tego użytkownika można też uznać za właściciela spotkania. Mogą nie być obecni podczas rozmowy lub nie być organizatorami spotkania. Spotkanie może mieć tylko jednego organizatora.

Miejsce spotkań

Wirtualne miejsce lub trwały obiekt (np. sala konferencyjna), w którym odbywa się konferencja. W danym momencie w jednej przestrzeni może się odbywać tylko jedna aktywna rozmowa wideo. Pokój spotkań pomaga też użytkownikom spotykać się i znajdować wspólne zasoby.

Identyfikator URI spotkania

Klikalny adres URL, który rozpoczyna połączenie lub umożliwia dołączenie do niego. Każda rozmowa ma niepowtarzalny adres URL składający się z https://meet.google.com/ i kodu spotkania. Na przykład: https://meet.google.com/abc-mnop-xyz.

Członek

Użytkownik wyraźnie dodany do pokoju spotkań z przypisaną rolą (np.COHOST). W przeciwieństwie do uczestnika, który jest obecny tylko podczas konferencji na żywo, członek jest powiązany z trwałym pokojem spotkań i zachowuje swoje uprawnienia podczas wielu konferencji w tym pokoju.

Uczestnik

Osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda jako widz lub urządzenie w sali połączone z rozmową. Każda osoba ma 1 zasób participants. Gdy uczestnik dołącza do konferencji, przypisywany jest mu niepowtarzalny identyfikator.

Sesja uczestnika

Unikalny identyfikator sesji utworzony dla każdej pary uczestnik-urządzenie, która dołącza do połączenia. Każda sesja ma 1 zasób participantSessions. Jeśli uczestnik dołączy do tego samego połączenia kilka razy z tej samej pary uczestnik–urządzenie, każda sesja otrzyma unikalny identyfikator.

Nagrywanie

Plik wideo MP4 i powiązane z nim metadane wygenerowane podczas nagrywania konferencji. Nagrania są zapisywane na Dysku organizatora spotkania i można je pobrać jako artefakty spotkania.

Adres SIP

Adres Session Initiation Protocol (SIP) zawiera szczegółowe informacje o tym, jak sprzęt do wideokonferencji innych firm może znaleźć i dołączyć do konferencji w Meet. Meet obsługuje schemat URI SIP.

Inteligentna notatka

Zwięzłe podsumowanie najważniejszych punktów i działań z konferencji wygenerowane przez Gemini i wyeksportowane na Dysk organizatora spotkania jako plik Dokumentów.

Transkrypcja

Dokument tekstowy zawierający rozmowę ze spotkania, wyeksportowany na Dysk organizatora spotkania jako plik Dokumentów.

Wpis transkrypcji

Odrębny segment transkrypcji wypowiedzi uczestnika konferencji. Każdy wpis zawiera tożsamość uczestnika, sygnaturę czasową, wypowiedziany tekst i kod języka. Jest dostępny przez 30 dni od zakończenia konferencji.