Google Meet-Termine abonnieren

In diesem Dokument werden die Meet-Ereignisse beschrieben, die Ihre App mit der Google Workspace Events API abonnieren kann. Nachdem Sie sich für die gewünschten Ereignistypen entschieden haben, erstellen Sie ein Abo, um Ereignisse von Meet zu erhalten.

Sie können Ereignisse nicht nur abonnieren, sondern auch abfragen, indem Sie die Google Meet REST API aufrufen. Rufen Sie die Meet REST API auf, um regelmäßig Ereignisse abzurufen oder Ereignisse nachzuholen, die Sie aufgrund eines Ausfalls möglicherweise verpasst haben. Informationen dazu, wie Sie Meet-Ereignisse empfangen und darauf reagieren können, finden Sie in der Meet-Dokumentation unter Auf Ereignisse von Google Meet reagieren.

Weitere Informationen zur Entwicklung von Apps für Meet finden Sie in der Übersicht über die Meet REST API.

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 Konferenzraum.
• Ein Teilnehmer tritt einer Konferenz bei oder verlässt sie.
• Eine Aufzeichnung wird gestartet oder beendet oder es wird eine Datei für eine Konferenz generiert.
• Eine intelligente Notiz wird gestartet, beendet oder eine Datei wird für eine Konferenz generiert.
• Ein Transkript wird gestartet, beendet oder eine Datei wird für eine Konferenz generiert.

Ressourcen, die Sie auf Ereignisse überwachen können

Wenn Sie Ereignisse empfangen möchten, müssen Sie eine Meet-Ressource angeben, die überwacht werden soll. Diese wird als Zielressource des Abos bezeichnet.

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

Ereignistypen zum Erstellen von Abos

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 Ereignisse zu neuen Teilnehmern einer Konferenz für einen Meet-Bereich erhalten möchten, geben Sie den Ereignistyp 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 sehen Sie, welche Ereignistypen für Abos für Meet-Ressourcen unterstützt werden:

Ereignisdaten

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

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 ID des Konferenzdatensatzes (z. B. conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) verwendet, um den Konferenzraum zu identifizieren. Weitere Informationen finden Sie unter So identifiziert Meet einen Konferenzraum.

Für jedes Ereignis, das das Abo empfängt, wird die Nutzlast im Feld data des Ereignisses angezeigt:

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

• Kalendereingeladene und andere Teilnehmer, die zu einer Videokonferenz eingeladen wurden, können nur die folgenden Ereignisse empfangen: google.workspace.meet.conference.v2.started und google.workspace.meet.transcript.v2.fileGenerated.

Weitere Informationen

• Google Workspace Events API – Übersicht
• Struktur von Google Workspace-Ereignissen
• Google Workspace Events API-Bereiche auswählen
• Google Meet REST API – Übersicht
• Meet REST API-Bereiche auswählen
• Anleitung: Videokonferenzereignisse mit Python und der Google Meet REST API beobachten