Google Meet REST API – Übersicht

Mit der Google Meet REST API können Sie Besprechungen für Google Meet erstellen und verwalten und Ihren Nutzern direkt über Ihre App Einstiegspunkte bieten.

Mit der Meet REST API haben Sie folgende Möglichkeiten:

  • Besprechungsräume erstellen und konfigurieren, damit Nutzer sich per Video austauschen können
  • Sie können die Zugriffsebenen für den Bereich, die Moderationseinstellungen und automatische Aufzeichnungen oder Transkripte vorkonfigurieren.
  • Mitglieder von Konferenzräumen verwalten und Co-Organisator-Rollen zuweisen
  • Eine aktive Konferenz in einem Konferenzraum programmgesteuert beenden.
  • Konferenzaufzeichnungen, Teilnahmeinformationen und Metadaten zur Teilnehmersitzung abrufen.
  • Besprechungsartefakte (Aufzeichnungen, Transkripte und Transkripteinträge) abrufen.

Sie können Meet-Ereignisse auch über die Google Workspace Events API abonnieren. Wenn Sie über Änderungen benachrichtigt werden möchten, können Sie einen bestimmten Konferenzraum oder alle Konferenzräume eines bestimmten Nutzers abonnieren. Weitere Informationen finden Sie unter:

Anwendungsfälle

Apps können in die Meet REST API eingebunden werden, um die folgenden Aufgaben auszuführen:

  • Vor einer Videokonferenz: Erstellen Sie Konferenzräume on demand, konfigurieren Sie Zugriffsrechte (offen, vertrauenswürdig oder eingeschränkt), wenden Sie Moderationsfunktionen an (Bildschirmfreigabe, Chat, Reaktionen, Mikrofon und Kamera), konfigurieren Sie die automatische Aufzeichnung oder automatische Transkription und weisen Sie den Mitgliedern des Konferenzraums Co-Organisator-Rollen zu.

  • Während einer Konferenz: Rufen Sie aktive Konferenzmetadaten und Teilnehmersitzungen ab, verwalten Sie Mitglieder dynamisch, hören Sie mit der Google Workspace Events API auf Echtzeit-Lebenszyklusereignisse oder beenden Sie die aktive Konferenz programmatisch.

  • Nach einer Videokonferenz: Konferenzaufzeichnungen und Anwesenheitslogs abrufen, Aufzeichnungen und Google Docs-Transkripte aus Google Drive herunterladen und auf detaillierte Transkript-Spracheinträge für Coaching, Compliance oder KI-Analyse zugreifen.

Hier einige Beispiele für die Verwendung der Meet REST API:

  • Vertrieb und Kontoverwaltung

    • Besprechungs- und Teilnehmerinformationen zu Aufzeichnungszwecken abrufen.
    • Besprechungsartefakte abrufen und in Konten posten
    • Transkriptionen und Aufzeichnungen durch KI-Modelle analysieren lassen, um Coaching- und Vertriebseffektivitätsanalysen zu erstellen.

  • Lernen und Entwicklung

    • Videokonferenzen für Trainings erstellen und vorkonfigurieren
    • Weisen Sie Trainern und Sitzungsleitern die Rolle des Co-Organisators zu.
    • Aufzeichnungen abrufen, damit Schüler und Studenten sich Materialien nach Kursende noch einmal ansehen können.

  • Kundensupport und Beratung

    • Sichere, eingeschränkte Besprechungsräume direkt über Helpdesk-Tickets oder Kundenportale erstellen
    • Konfigurieren Sie die Verwaltung durch den Organisator vorab so, dass nur Kundenservicemitarbeiter präsentieren oder die Teilnahme verwalten können.
    • Aktivieren Sie die automatische Aufzeichnung oder Transkription für die Qualitätssicherung und Compliance-Aufzeichnungen.
    • Aktive Videokonferenzen werden automatisch beendet, wenn Termine oder Support-Sitzungen abgeschlossen sind.

  • Entwicklerbetrieb

    • Videokonferenzen erstellen, um sich sofort mit Teammitgliedern auszutauschen
    • Andere Stakeholder können laufenden Besprechungen beitreten, indem Sie Echtzeitinformationen zur Besprechung und zu den Teilnehmern teilen.
    • Transkriptionsdaten durch KI-Modelle verarbeiten, um die richtigen nächsten Schritte zu generieren.
Erstellen Sie eine dynamische Besprechung mit Ihren Kollegen in einem Chatbereich und nehmen Sie daran teil.
Abbildung 1. Erstellen Sie eine dynamische Besprechung mit Ihren Kollegen in einem Chatbereich und nehmen Sie daran teil.

Sie können auch andere Google Workspace-APIs wie die Chat API in Ihre App einbinden, um die Zusammenarbeit noch weiter zu verbessern. Weitere Informationen finden Sie unter Chat-Anwendungsfälle.

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste der in dieser API verwendeten gängigen Begriffe:

Aktive Konferenz
Die laufende Videokonferenz findet in einem Konferenzraum statt. In einem Konferenzraum kann jeweils nur eine aktive Videokonferenz stattfinden. Nach dem Ende wird sie zu einem Eintrag des Konferenzverlaufs.
Artefakt
Eine Datei, die von Meet als Reaktion auf eine Konferenz generiert wurde, z. B. recordings und transcripts. Artefakte werden im Drive-Konto des Organisators der Videokonferenz gespeichert. Sie können in der Regel kurz nach dem Ende einer Konferenz abgerufen werden.
Kalendertermin
Ein Termin in Google Kalender mit mehreren Gästen, der in der Regel von einem Organisator erstellt wird und die Teilnahmeinformationen für eine Besprechung enthält. Meet ist möglicherweise die Videokonferenzlösung für den Termin.
Call
Eine Sitzung mit Meet starten oder andere darüber benachrichtigen, dass ein Anruf beginnt oder läuft, damit sie sofort teilnehmen können.
Co-Moderator:in
Eine Person in einem Anruf, der von einem Organisator Hostverwaltungsberechtigungen erteilt wurden, mit Ausnahme der Möglichkeit, den ursprünglichen Organisator zu entfernen.
Konferenz
Eine Konferenz ist eine Instanz eines Anrufs in einem Konferenzraum. Nutzer betrachten dieses Szenario in der Regel als eine einzelne Besprechung.
Conference-Bilanz
Eine eindeutige ID für jede Instanz einer Videokonferenz. Sie wird automatisch erstellt, wenn die Videokonferenz beginnt. Die Ressource conferenceRecords hat das Format conferenceRecords/{conferenceRecord}. Beispiel: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ
Einwählen
Per Telefon an einem Anruf teilnehmen oder einen gestreamten Anruf anhören
Moderator:in
Die Person, die einen Anruf (den Organisator der Videokonferenz) erstellt hat oder die den Anruf steuert. Der Organisator einer Videokonferenz kann die Videokonferenz organisieren, muss aber nicht anwesend sein, wenn sie stattfindet. Ein Organisator kann die Organisator berechtigungen auch an einen Co-Organisator delegieren.
Besprechungscode

Ein eindeutiger, eingabefähiger String mit 10 Zeichen für einen Konferenzraum, der im Besprechungs-URI eines Konferenzraums verwendet wird. Die Groß- und Kleinschreibung wird nicht berücksichtigt. Beispiel: abc-mnop-xyz. Die maximale Länge beträgt 128 Zeichen.

Besprechungscodes sollten nicht langfristig gespeichert werden, da sie von einem Konferenzraum getrennt und in Zukunft für andere Konferenzräume wiederverwendet werden können. Besprechungscodes laufen in der Regel 365 Tage nach der letzten Nutzung ab. Weitere Informationen zu Besprechungscodes in Google Meet

Besprechungsname

Eine eindeutige, vom Server generierte ID zur Identifizierung eines Konferenzraums. Dabei wird zwischen Groß- und Kleinschreibung unterschieden. Beispiel: jQCFfuBOdN5z. Die Besprechungs-ID wird im Feld name einer spaces-Ressource zurückgegeben. Weitere Informationen

Organisator der Videokonferenz

Der Nutzer, der den Konferenzraum erstellt hat. Dieser Nutzer kann auch als Inhaber der Videokonferenz betrachtet werden. Sie sind möglicherweise nicht während des Anrufs anwesend oder der Organisator der Besprechung. Es kann nur einen Organisator einer Besprechung geben.

Konferenzraum

Ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Besprechungsraum), an dem eine Konferenz stattfindet. In einem Bereich kann jeweils nur eine aktive Videokonferenz stattfinden. Ein Besprechungsbereich hilft Nutzern auch, sich zu treffen und gemeinsame Ressourcen zu finden.

Besprechungs-URI

Eine anklickbare URL, über die ein Nutzer einen Anruf starten oder daran teilnehmen kann. Jeder Anruf hat eine eindeutige URL, die aus https://meet.google.com/ gefolgt vom Meeting-Code besteht. Beispiel: https://meet.google.com/abc-mnop-xyz

Mitglied

Ein Nutzer, der einem Besprechungsbereich mit einer bestimmten Rolle (z. B. COHOST) explizit hinzugefügt wurde. Im Gegensatz zu einem Teilnehmer, der nur während einer Live-Videokonferenz anwesend ist, ist ein Mitglied dem persistenten Besprechungsbereich zugeordnet und behält seine Berechtigungen für mehrere Videokonferenzen in diesem Bereich.

Teilnehmer

Eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet und als Zuschauer teilnimmt, oder ein Raumgerät, das mit einem Anruf verbunden ist. Es gibt eine participants-Ressource für jede Person. Wenn ein Teilnehmer der Videokonferenz beitritt, wird ihm eine eindeutige ID zugewiesen.

Teilnehmersitzung

Eine eindeutige Sitzungs-ID, die für jedes Teilnehmergerät erstellt wird, das an einem Anruf teilnimmt. Für jede Sitzung gibt es eine participantSessions-Ressource. Wenn der Teilnehmer mehrmals über dasselbe Teilnehmergerät an derselben Videokonferenz teilnimmt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.

Aufzeichnung

Eine MP4-Videodatei und die zugehörigen Metadaten, die bei der Aufzeichnung einer Konferenz generiert werden. Aufzeichnungen werden im Google Drive des Organisators gespeichert und können als Besprechungsartefakte abgerufen werden.

SIP-Adresse

Eine Session Initiation Protocol-Adresse (SIP) enthält Informationen dazu, wie Videokonferenzhardware von Drittanbietern eine Meet-Konferenz finden und daran teilnehmen kann. Meet unterstützt das SIP-URI-Schema.

Transkript

Ein Textdokument, in dem die gesprochene Unterhaltung einer Besprechung festgehalten wird, die als Docs-Datei in den Drive-Speicher des Organisators der Besprechung exportiert wird.

Transkriptionseintrag

Ein diskretes Segment der transkribierten Sprache eines Teilnehmers in einer Konferenz. Jeder Eintrag enthält die Identität des Teilnehmers, den Zeitstempel, den gesprochenen Text und den Sprachcode und ist 30 Tage nach Ende der Videokonferenz verfügbar.