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 aplikacji.

Interfejs Meet REST API umożliwia:

  • Utwórz miejsce spotkań, aby umożliwić użytkownikom łączenie się za pomocą 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. Więcej informacji znajdziesz w artykułach Subskrybowanie zdarzeń za pomocą interfejsu Google Workspace Events API i Subskrybowanie zdarzeń w Google Meet.

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 dołączenie 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ż zintegrować z aplikacją inne interfejsy Google Workspace API, takie jak Chat API, aby jeszcze bardziej usprawnić współpracę. Więcej informacji znajdziesz w artykule Przykłady zastosowań czatu.

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. 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łą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.
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.
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 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 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ł 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 niego dołącza. 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 participants zasób. 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.