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

Mit der Meet REST API können Sie Folgendes tun:

  • Einen Konferenzraum erstellen, um Nutzer per Video zu verbinden.
  • Einen Konferenzraum oder eine Konferenz anhand des Ressourcennamens abrufen.
  • Eine Liste der Teilnehmer und Teilnehmersitzungen abrufen.
  • Besprechungsartefakte abrufen (Aufzeichnungen, Transkripte und Transkripteinträge).

Sie können auch Meet-Ereignisse mit der Google Workspace Events API abonnieren. Wenn Sie über Änderungen benachrichtigt werden möchten, können Sie einen bestimmten Konferenzraum oder alle Konferenzräume abonnieren, die zu einem bestimmten Nutzer gehören. 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 Konferenz: Passen Sie die Konferenz nach Bedarf an, indem Sie den Konferenzraum erstellen. Außerdem können Sie Eingeladene verwalten und die Einstellungen vorkonfigurieren.

  • Während einer Konferenz: Sie können Konferenzinformationen abrufen, um die App Nutzung basierend auf den zurückgegebenen Metadaten zu ändern.

  • Nach einer Konferenz: Sie können Konferenzartefakte wie die Aufzeichnung und das Transkript abrufen.

Einige Beispiele für die Verwendung der Meet REST API:

  • Vertrieb und Kontoverwaltung

    • Besprechungs- und Teilnehmerinformationen für Aufzeichnungszwecke abrufen.
    • Besprechungsartefakte abrufen und in Konten posten.
    • Transkripte und Aufzeichnungen mit KI-Modellen analysieren, um Analysen zur Coaching- und Vertriebseffektivität zu erstellen.

  • Lernen und Entwicklung

    • Besprechungen für Schulungen erstellen und vorkonfigurieren.
    • Trainern und Sitzungsleitern die Rolle des Co-Organisators zuweisen.
    • Aufzeichnungen abrufen, damit sich die Teilnehmer die Materialien nach dem Kurs ansehen können.

  • Entwicklerbetrieb

    • Besprechungen erstellen, um Teammitglieder sofort zu verbinden.
    • Andere Stakeholder an laufenden Besprechungen teilnehmen lassen, indem Sie Besprechungs- und Teilnehmerinformationen in Echtzeit freigeben.
    • Transkriptionsdaten mit KI-Modellen analysieren, um die richtigen nächsten Schritte zu ermitteln.
Sie können in einem Chatbereich eine dynamische Videokonferenz mit Ihren Kollegen erstellen und daran teilnehmen.
Abbildung 1 Dynamische Besprechungen mit Kollegen in einem Chatbereich erstellen und daran teilnehmen.

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 Anwendungsfälle für Google Chat.

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste der häufig verwendeten Begriffe in dieser API:

Artefakt
Eine Datei, die von Meet als Reaktion auf eine Konferenz generiert wurde, z. B. Aufzeichnungenrecordings und Transkriptetranscripts. Artefakte werden im Organisator der Videokonferenz Google Drive gespeichert. Sie können in der Regel kurz nach Ende einer Konferenz abgerufen werden.
Kalendertermin
Ein Termin in Google Kalender mit mehreren Gästen, der in der Regel von einem Organisator der Besprechung erstellt wird und die Teilnahmeinformationen einer Besprechung enthält. Meet ist möglicherweise die Konferenzlösung für den Termin.
Anruf
Eine Sitzung mit Meet oder eine Benachrichtigung für andere, dass ein Anruf beginnt oder läuft, damit sie sofort teilnehmen können.
Konferenz
Eine Konferenz ist eine Instanz eines Anrufs in einem Konferenzraum. Nutzer betrachten dieses Szenario in der Regel als eine einzelne Besprechung.
Konferenzaufzeichnung
Eine eindeutige ID für jede Instanz einer Konferenz. Sie wird automatisch erstellt, wenn die Konferenz beginnt. Die conferenceRecords Ressource verwendet das Format conferenceRecords/{conferenceRecord}. Beispiel: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Co-Organisator
Eine Person in einem Anruf , der vom Organisator Host-Verwaltungsberechtigungen gewährt wurden, mit Ausnahme der Möglichkeit, den ursprünglichen Organisator zu entfernen.
Einwählen
Ein Telefon verwenden, um an einem Anruf teilzunehmen oder einen gestreamten Anruf anzuhören.
Organisator
Die Person, die einen Anruf erstellt hat (Organisator der Besprechung), oder die Person, die den Anruf steuert. Ein Organisator der Videokonferenz kann die Besprechung organisieren, muss aber nicht anwesend sein. Ein Organisator kann Host-Berechtigungen auch an einen Co-Organisator delegieren.
Besprechungscode

Eine eindeutige 10-stellige Zeichenfolge für einen Konferenzraum, die in der 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 werden und in Zukunft für andere Konferenzräume wiederverwendet werden können. In der Regel laufen Besprechungscodes 365 Tage nach der letzten Verwendung ab. Weitere Informationen finden Sie unter Informationen zu Besprechungscodes in Google Meet.

Besprechungsname

Eine eindeutige, vom Server generierte ID zur Identifizierung eines Konferenzraums. Die Groß- und Kleinschreibung wird berücksichtigt. Beispiel: jQCFfuBOdN5z. Die Besprechungs-ID wird im name Feld einer spaces Ressource zurückgegeben. Weitere Informationen finden Sie unter So identifiziert Meet einen Besprechungs raum.

Besprechungsorganisator

Der Nutzer, der den Konferenzraum erstellt hat. Dieser Nutzer kann auch als Eigentümer der Besprechung betrachtet werden. Er ist möglicherweise nicht während des Anrufs anwesend oder der Organisator der Besprechung. Es kann nur einen Organisator der Besprechung geben.

Konferenzraum

Ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), in dem eine Konferenz stattfindet. In einem Raum kann jeweils nur eine aktive Konferenz stattfinden. Ein Konferenzraum hilft Nutzern auch, sich zu treffen und freigegebene Ressourcen zu finden.

Besprechungs-URI

Eine anklickbare URL, die einen Anruf startet oder einen Nutzer daran teilnehmen lässt. Jeder Anruf hat eine eindeutige URL, die aus https://meet.google.com/ gefolgt vom Besprechungscode besteht. Beispiel: https://meet.google.com/abc-mnop-xyz.

Teilnehmer

Eine Person, die an einem Anruf teilnimmt, den Companion Modus verwendet, als Zuschauer zusieht oder ein Raumgerät, das mit einem Anruf verbunden ist. Für jede Person gibt es eine participants Ressource. Wenn ein Teilnehmer an der Konferenz teilnimmt, wird ihm eine eindeutige ID zugewiesen.

Teilnehmersitzung

Eine eindeutige Sitzungs-ID, die für jedes Teilnehmer-Geräte-Paar erstellt wird, das an einem Anruf teilnimmt. Für jede Sitzung gibt es eine participantSessions Ressource. Wenn der Teilnehmer mehrmals mit demselben Teilnehmer-Geräte-Paar am selben Anruf teilnimmt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.

SIP-Adresse

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