Google Meet-Termine abonnieren

Auf dieser Seite werden die Google Meet-Ereignisse beschrieben, die Ihre App abonnieren kann mithilfe der Google Workspace Events API. Nachdem Sie entschieden haben, Ereignistypen, die Sie benötigen, Abo, um die entsprechenden Funktionen zu erhalten aus Google Meet.

Weitere Informationen zum Entwickeln von Apps für Google Meet finden Sie unter Google Meet REST API. Übersicht.

Unterstützte Meet-Ereignisse

Mit Google Workspace-Abos erhalten Sie Ereignisse zu den folgenden Änderungsarten in Meet:

  • A konferenz in einem Konferenzraum beginnt oder endet.
  • A Teilnehmer einer Konferenz beitritt oder sie verlässt.
  • A aufzeichnung für eine Konferenz generiert wird.
  • A Transkript für eine Konferenz generiert wird.

Ressourcen, die Sie auf Ereignisse überwachen können

Um Termine zu erhalten, geben Sie eine Meet-Ressource an, die überwacht werden soll, Sie 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 Ressourcenname der space-Ressource der Meet REST API. Weitere Informationen finden Sie unter Wie Meet erkennt einen Konferenzraum.
Nutzer //cloudidentity.googleapis.com/users/USER

Dabei ist USER die ID im signedinUser.user der participant-Ressource für die Meet REST API. Weitere Informationen finden Sie unter Mit Teilnehmern zusammenarbeiten

Das Abo erhält Ereignisse zu Konferenzräumen, User ist einer der folgenden:

  • Der Eigentümer des Konferenzraums.
  • Den Organizer des mit dem Konferenzraum verknüpften Google Kalender-Termins.

Ereignistypen zum Erstellen von Abos

Wenn Sie ein Abo für eine Meet-Ressource erstellen, verwenden Sie das eventTypes[] geben Sie an, welche Ereignistypen Sie erhalten möchten. Ereignistypen sind die gemäß der CloudEvents-Spezifikation formatiert sind, wie z. B. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION Um beispielsweise Termine über neue Konferenzteilnehmer für eine für den Meet-Bereich haben, geben Sie als Termintyp an: google.workspace.meet.participant.v2.joined Weitere Informationen dazu, wie Ereignisse zu arbeiten, siehe Struktur von Google Workspace Ereignisse.

In der folgenden Tabelle sind die unterstützten Ereignistypen, eine Beschreibung und die geänderte Meet-Ressource, die in den Ereignisdaten dargestellt ist:

Ereignistyp Beschreibung Meet-Ressourcen

google.workspace.meet.conference.v2.started

Eine Konferenz beginnt im Konferenzraum.

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 wird im Konferenzraum eine Aufzeichnungsdatei generiert.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

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

conferenceRecord.transcript

Ereignisdaten

In diesem Abschnitt werden Ereignisdaten und Beispielnutzlasten für Ereignisse in Meet-Konferenzräume

Wenn Ihr Google Workspace-Abo ein Ereignis empfängt von Die data enthält die Nutzlast für das Ereignis. Diese Nutzlast enthält Informationen zum Geänderte Google Workspace-Ressource. Wenn Sie beispielsweise Ereignisse zu neuen Transkripten in einem Gruppenbereich, enthält die Nutzlast für diese Ereignisse Informationen über die transcript Ressource, die sich geändert hat.

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, die im Gruppenbereich stattfinden. Für jedes Ereignis die das Abo empfängt, wird die Nutzlast im Feld data der Ereignis:

Beispiel Ereignistyp JSON-Nutzlast

Eine Konferenz für den Meet-Konferenzraum wird gestartet.

google.workspace.meet.conference.v2.started

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

google.workspace.meet.participant.v2.joined

Ohne Ressourcendaten
{
    "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
Ohne Ressourcendaten
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Für eine Konferenz im Meet-Konferenzraum wird ein Transkript generiert. google.workspace.meet.transcript.v2.fileGenerated
Ohne Ressourcendaten
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}