Auf dieser Seite werden die Google Meet-Ereignisse beschrieben, die Ihre App mit der Google Workspace Events API abonnieren kann. Nachdem Sie entschieden haben, welche Arten von Ereignissen Sie benötigen, erstellen Sie ein Abo, um Ereignisse von Google Meet zu erhalten.
Weitere Informationen zum Entwickeln von Apps für Google Meet findest du in der Übersicht über die Google Meet REST API.
Unterstützte Meet-Zielressourcen
Damit Sie Meet-Ereignisse empfangen können, unterstützt die Google Workspace Events API Abos für die folgenden Ressourcen:
- Konferenzräume, dargestellt als
space
-Ressourcen. - Nutzer, dargestellt als Ressourcen vom Typ
user
der Cloud Identity API
Unterstützte Meet-Ereignisse
Mit Google Workspace-Abos können Sie Termine zu folgenden Arten von Änderungen in Meet erhalten:
- Eine Konferenz beginnt oder endet in einem Konferenzraum.
- Ein Teilnehmer nimmt an einer Konferenz teil oder verlässt sie.
- Für eine Konferenz wird eine Aufzeichnung generiert.
- Für eine Konferenz wird ein Transkript generiert.
Wenn Sie ein Abo für eine Meet-Ressource erstellen, geben Sie im Feld eventTypes[]
an, welche Arten von Ereignissen Sie erhalten möchten. Ereignistypen werden gemäß der CloudEvents-Spezifikation formatiert, z. B. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
Wenn Sie beispielsweise Termine zu neuen Teilnehmern einer Konferenz in einem Meet-Raum erhalten möchten, geben Sie den Ereignistyp auf google.workspace.meet.participant.v2.joined
an. Weitere Informationen zur Funktionsweise von Ereignissen finden Sie unter Struktur von Google Workspace-Ereignissen.
In der folgenden Tabelle werden die unterstützten Ereignistypen, eine Beschreibung und die geänderte Meet-Ressource angezeigt, die in den Ereignisdaten dargestellt ist:
Ereignistyp | Beschreibung | Meet-Ressource |
---|---|---|
|
Im Konferenzraum beginnt eine Konferenz. |
|
|
Eine Konferenz endet im Konferenzraum. |
|
|
Ein Teilnehmer nimmt an einer aktiven Konferenz im Konferenzraum teil. |
|
|
Ein Teilnehmer verlässt eine aktive Konferenz im Konferenzraum. |
|
|
Für eine Konferenz im Konferenzraum wird eine Aufzeichnungsdatei generiert. |
|
|
Für eine Konferenz im Konferenzraum wird eine Transkriptdatei erstellt. |
|
Ereignisdaten
In diesem Abschnitt werden Ereignisdaten und Beispielnutzlasten für Ereignisse in Meet-Konferenzräumen beschrieben.
Wenn Ihr Google Workspace-Abo ein Ereignis von Meet empfängt, enthält das Feld data
die Nutzlast für das Ereignis. Diese Nutzlast enthält Informationen über die Google Workspace-Ressource, die sich geändert hat. Wenn Sie beispielsweise Ereignisse zu neuen Transkripten in einem Gruppenbereich abonniert haben, enthält die Nutzlast für diese Ereignisse Informationen zur geänderten Ressource transcript
.
Ressourcendaten in der Ereignisnutzlast
Die folgende Tabelle enthält Beispiele für JSON-Nutzlasten für ein Abo für einen Meet-Konferenzraum. In den Beispielen wird die Konferenz conferenceRecords/AAA-BBB-CCC-DDD-EEE
verwendet, die im Gruppenbereich stattfindet. Für jedes Ereignis, das das Abo empfängt, wird die Nutzlast im Feld data
des Ereignisses angezeigt:
Beispiel | Ereignistyp | JSON-Nutzlast |
---|---|---|
Eine Konferenz beginnt für den Meet-Konferenzraum. |
|
Schließt Ressourcendaten aus
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
Ein Teilnehmer nimmt im Meet-Konferenzraum an einer Konferenz teil. |
|
Schließt Ressourcendaten aus
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
Für eine Konferenz im Meet-Konferenzraum wird eine Aufzeichnung erstellt. | google.workspace.meet.recording.v2.fileGenerated |
Schließt Ressourcendaten aus
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
Für eine Konferenz im Meet-Konferenzbereich wird ein Transkript erstellt. | google.workspace.meet.transcript.v2.fileGenerated |
Schließt Ressourcendaten aus
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |