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.

Za pomocą interfejsu Meet REST API możesz:

  • Utwórz miejsce spotkań, aby umożliwić użytkownikom nawiązywanie połączeń wideo.
  • Pobierz przestrzeń spotkań lub konferencję według nazwy zasobu.
  • Uzyskaj listę uczestników i sesji uczestników.
  • uzyskiwać artefakty ze spotkań (nagrania, transkrypcje i wpisy w transkrypcji);

Możesz też subskrybować wydarzenia 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ą: dostosuj konferencję do swoich potrzeb, tworząc miejsce spotkania. Możesz też zarządzać zaproszonymi osobami i wstępnie konfigurować ustawienia.

  • Podczas konferencji: pobieraj informacje o konferencji, aby zmieniać działanie aplikacji na podstawie zwróconych metadanych.

  • Po konferencji: pobieranie materiałów z konferencji, takich jak nagranie i transkrypcja.

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;
    • Pobieranie artefaktów ze spotkań i publikowanie ich na kontach.
    • Przeprowadzaj transkrypcje i nagrania przez modele AI, aby generować analizy skuteczności szkolenia i sprzedaży.

  • Nauka i rozwój

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

  • Operacje deweloperskie

    • tworzyć spotkania, aby błyskawicznie kontaktować się z członkami zespołu;
    • Umożliwiaj innym osobom zainteresowanym dołączanie do trwających spotkań, udostępniając informacje 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ż włączyć do aplikacji inne interfejsy Google Workspace API, takie jak Chat API, aby jeszcze bardziej usprawnić 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:

Artefakt
Plik wygenerowany przez Meet w odpowiedzi na konferencję, np. recordings i transcripts. Pliki są zapisywane na Dysku Google organizatora spotkania. Zwykle są one dostępne 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łączaniu do spotkania. Meet może być rozwiązaniem konferencyjnym dla wydarzenia.
Call
sesji w Meet lub powiadamiać innych, że połączenie się rozpoczyna lub trwa, i umożliwiać im natychmiastowe dołączenie;
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.
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 oryginalnego gospodarza.
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ć i który jest używany w przestrzeni spotkań w identyfikatorze URI spotkania. Wielkość liter nie jest rozróżniana. 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 przestrzeni spotkania i w przyszłości mogą być ponownie użyte w innych przestrzeniach 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ł miejsce spotkania. 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 spotkań), w którym odbywa się konferencja. W danej przestrzeni może się odbywać tylko 1 aktywna rozmowa wideo naraz. 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 dołącza do niego użytkownika. 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.

Uczestnik

Osoba dołączająca do rozmowy lub korzystająca z trybu towarzyszącego, oglądająca 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 jeden 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.