Subskrybowanie wydarzeń w Google Meet

Na tej stronie znajdziesz opis zdarzeń w Google Meet, które Twoja aplikacja może subskrybować za pomocą interfejsu Google Workspace Events API. Po określeniu typów zdarzeń, których potrzebujesz, utwórz subskrypcję, aby zacząć otrzymywać zdarzenia z Meet.

Więcej informacji o tworzeniu aplikacji dla Meet znajdziesz w artykule Omówienie interfejsu Google Meet REST API.

Obsługiwane wydarzenia w Meet

Subskrypcje Google Workspace umożliwiają otrzymywanie zdarzeń dotyczących tych typów zmian w Meet:

  • Konferencja rozpoczyna się lub kończy w pokoju spotkań.
  • Uczestnik dołącza do konferencji lub ją opuszcza.
  • Dla konferencji generowane jest nagranie.
  • Dla konferencji generowana jest transkrypcja.

Zasoby, które możesz monitorować pod kątem zdarzeń

Aby odbierać zdarzenia, musisz określić zasób Meet do monitorowania, który jest nazywany zasobem docelowym subskrypcji.

Interfejs Google Workspace Events API obsługuje te zasoby docelowe w przypadku Meet:

Zasób docelowy Format Ograniczenia (w odpowiednich przypadkach)
Miejsce spotkań //meet.googleapis.com/spaces/SPACE

gdzie SPACE to identyfikator w nazwie zasobu zasobu space interfejsu Meet REST API. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.
Użytkownik //cloudidentity.googleapis.com/users/USER

gdzie USER to identyfikator w polu signedinUser.user zasobu participant interfejsu Meet REST API. Więcej informacji znajdziesz w artykule Praca z uczestnikami.

Subskrypcja otrzymuje zdarzenia dotyczące wszystkich miejsc spotkań, których użytkownik jest właścicielem. Zwykle właściciel sali konferencyjnej jest też organizatorem wydarzenia w Kalendarzu Google powiązanego z salą konferencyjną.

Typy zdarzeń do tworzenia subskrypcji

Podczas tworzenia subskrypcji zasobu Meet używasz pola eventTypes[] do określania typów zdarzeń, które chcesz otrzymywać. Typy zdarzeń są sformatowane zgodnie ze specyfikacją CloudEvents, np. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Aby na przykład otrzymywać zdarzenia dotyczące nowych uczestników konferencji w pokoju Meet, określ typ zdarzenia jako google.workspace.meet.participant.v2.joined. Więcej informacji o tym, jak działają zdarzenia, znajdziesz w artykule Struktura zdarzeń Google Workspace.

W tabeli poniżej znajdziesz obsługiwane typy zdarzeń, ich opis oraz zmieniony zasób Meet, który jest reprezentowany w danych zdarzenia:

Typ wydarzenia Opis Zasób Meet

google.workspace.meet.conference.v2.started

Konferencja rozpoczyna się w przestrzeni spotkania.

conferenceRecord

google.workspace.meet.conference.v2.ended

Konferencja kończy się w przestrzeni spotkań.

conferenceRecord

google.workspace.meet.participant.v2.joined

Uczestnik dołącza do aktywnej konferencji w pokoju spotkań.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Uczestnik opuszcza aktywne spotkanie w przestrzeni spotkania.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

W przestrzeni spotkań generowany jest plik nagrania konferencji.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

W przestrzeni spotkania generowany jest plik transkrypcji konferencji.

conferenceRecord.transcript

Dane zdarzenia

W tej sekcji opisujemy dane zdarzeń i przykładowe ładunki zdarzeń w przestrzeniach spotkań w Meet.

Gdy subskrypcja Google Workspace otrzyma zdarzenie z Meet, pole data będzie zawierać ładunek zdarzenia. Ten ładunek zawiera informacje o zmienionym zasobie Google Workspace. Jeśli na przykład subskrybujesz zdarzenia dotyczące nowych transkrypcji w pokoju, ładunek tych zdarzeń zawiera informacje o zasobie transcript, który uległ zmianie.

Dane zasobu w ładunku zdarzenia

W tabeli poniżej znajdziesz przykłady ładunków JSON w przypadku subskrypcji miejsca spotkań w Meet. W przykładach używany jest identyfikator rekordu konferencji (np. conferenceRecords/AAA-BBB-CCC-DDD-EEE) do identyfikowania miejsca spotkania. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.

W przypadku każdego zdarzenia, które otrzymuje subskrypcja, ładunek pojawia się w polu data zdarzenia:

Przykład Typ wydarzenia Ładunek JSON

Rozpoczyna się konferencja w przestrzeni spotkań Meet.

google.workspace.meet.conference.v2.started
Wyklucza dane zasobów
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Uczestnik dołącza do konferencji w przestrzeni spotkania Meet.

google.workspace.meet.participant.v2.joined
Wyklucza dane zasobów
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Nagranie jest generowane w przypadku konferencji w przestrzeni spotkań Meet. google.workspace.meet.recording.v2.fileGenerated
Wyklucza dane zasobów
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Transkrypcja jest generowana w przestrzeni spotkań Meet. google.workspace.meet.transcript.v2.fileGenerated
Wyklucza dane zasobów
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}