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

google.workspace.meet.conference.v2.started

Im Konferenzraum beginnt eine Konferenz.

conferenceRecord

google.workspace.meet.conference.v2.ended

Eine Konferenz endet im Konferenzraum.

conferenceRecord

google.workspace.meet.participant.v2.joined

Ein Teilnehmer nimmt an einer aktiven Konferenz im Konferenzraum teil.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Ein Teilnehmer verlässt eine aktive Konferenz im Konferenzraum.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

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

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Für eine Konferenz im Konferenzraum wird eine Transkriptdatei erstellt.

conferenceRecord.transcript

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.

google.workspace.meet.conference.v2.started

Schließt Ressourcendaten aus
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Ein Teilnehmer nimmt im Meet-Konferenzraum an einer Konferenz teil.

google.workspace.meet.participant.v2.joined

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"
    }
}