Google Meet-Termine abonnieren

In diesem Dokument 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 Meet zu empfangen.

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

Weitere Informationen zum Entwickeln von Apps für Meet finden Sie in der Übersicht über die Google 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 Videokonferenz beginnt oder endet in einem Besprechungsraum.
• Ein Teilnehmer tritt einer Videokonferenz bei oder verlässt sie.
• Eine Aufzeichnung beginnt oder endet oder es wird eine Datei für eine Konferenz generiert.
• Eine smarte Notiz wird gestartet, beendet oder eine Datei wird für eine Konferenz generiert. science Entwicklervorschau
• Ein Transkript wird für eine Videokonferenz gestartet, beendet oder eine Datei wird dafür generiert.

Ressourcen, die Sie auf Ereignisse überwachen können

Wenn Sie Ereignisse empfangen möchten, geben Sie eine Meet-Ressource an, 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 mit dem 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 in einer Konferenz für einen Meet-Bereich 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 sehen Sie, welche Ereignistypen für Abonnements von Meet-Ressourcen unterstützt werden:

Ereignisdaten

In diesem Abschnitt werden Ereignisdaten und Beispiel-Payloads für Ereignisse in Meet-Besprechungsrä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 Bereich abonniert haben, enthält die Nutzlast für diese Ereignisse Informationen zur transcripts-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-Besprechungsbereich. In den Beispielen wird die Konferenzdatensatz-ID (z. B. conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) verwendet, um den Konferenzraum zu identifizieren. Weitere Informationen

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

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

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