Google Meet-Termine abonnieren

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 finden Sie in der REST API-Übersicht für Google Meet.

Unterstützte Meet-Ereignisse

Mit Google Workspace-Abos können Sie Ereignisse zu den folgenden Arten von Änderungen in Meet erhalten:

  • Eine Konferenz beginnt oder endet in einem Besprechungsraum.
  • Ein Teilnehmer tritt einer Konferenz bei oder verlässt sie.
  • Für eine Konferenz wird eine Aufzeichnung erstellt.
  • Für eine Konferenz wird ein Transkript erstellt.

Ressourcen, die Sie auf Ereignisse überwachen können

Damit Ereignisse empfangen werden können, müssen Sie eine zu überwachende Meet-Ressource angeben. Diese wird als Zielressource des Abos bezeichnet.

Die Google Workspace Events API unterstützt die folgenden Zielressourcen für Meet:

Zielressource Format Einschränkungen (falls zutreffend)
Konferenzraum //meet.googleapis.com/spaces/SPACE

Dabei ist SPACE die ID im Ressourcennamen der Meet REST API-Ressource space. Weitere Informationen finden Sie unter So identifiziert Meet einen Besprechungsraum.
Nutzer //cloudidentity.googleapis.com/users/USER

Dabei ist USER die ID im Feld signedinUser.user der Meet REST API-Ressource participant. Weitere Informationen finden Sie unter Mit Teilnehmern arbeiten.

Das Abo empfängt Ereignisse zu Besprechungsräumen, in denen der Nutzer eine der folgenden Rollen hat:

  • Der Inhaber des Konferenzraums.
  • Der Organisator des Google Kalender-Termins, der mit dem Konferenzraum verknüpft ist.

Ereignistypen zum Erstellen von Abos

Wenn Sie ein Abo für eine Meet-Ressource erstellen, können Sie im Feld eventTypes[] angeben, 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 Ereignisse zu neuen Teilnehmern in einer Konferenz für einen Meet-Raum erhalten möchten, geben Sie den Ereignistyp als 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 sind die unterstützten Ereignistypen, eine Beschreibung und die geänderte Meet-Ressource aufgeführt, die in den Ereignisdaten dargestellt wird:

Ereignistyp Beschreibung Meet-Ressource

google.workspace.meet.conference.v2.started

Eine Konferenz beginnt im Besprechungsraum.

conferenceRecord

google.workspace.meet.conference.v2.ended

Eine Konferenz endet im Konferenzraum.

conferenceRecord

google.workspace.meet.participant.v2.joined

Ein Teilnehmer tritt einer aktiven Konferenz im Besprechungsraum bei.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Ein Teilnehmer verlässt eine aktive Konferenz im Besprechungsraum.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Für eine Konferenz im Besprechungsraum wird eine Aufzeichnungsdatei generiert.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Für eine Konferenz im Besprechungsraum wird eine Transkriptdatei generiert.

conferenceRecord.transcript

Ereignisdaten

In diesem Abschnitt werden Ereignisdaten und Beispielnutzlasten für Ereignisse in Meet-Veranstaltungsrä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 Payload enthält Informationen zur geänderten Google Workspace-Ressource. Wenn Sie beispielsweise Ereignisse zu neuen Transkripten in einem Gruppenbereich abonniert haben, enthält die Nutzlast für diese Ereignisse Informationen zur geänderten transcript-Ressource.

Ressourcendaten in der Ereignisnutzlast

Die folgende Tabelle enthält Beispiele für JSON-Nutzlasten für ein Abo eines Meet-Konferenzraums. 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 wird für den Meet-Konferenzraum gestartet.

google.workspace.meet.conference.v2.started

Ressourcendaten sind ausgeschlossen.
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Ein Teilnehmer nimmt über den Meet-Konferenzraum an einer Konferenz teil.

google.workspace.meet.participant.v2.joined

Ressourcendaten sind ausgeschlossen.
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
Eine Aufzeichnung wird für eine Konferenz im Meet-Konferenzraum erstellt. google.workspace.meet.recording.v2.fileGenerated
Ressourcendaten sind ausgeschlossen.
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Für eine Konferenz im Meet-Konferenzraum wird ein Transkript erstellt. google.workspace.meet.transcript.v2.fileGenerated
Ressourcendaten sind ausgeschlossen.
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}