Google Meet REST API – Übersicht

Mit der Google Meet REST API können Sie Besprechungen für Google Meet erstellen und verwalten. Außerdem bietet sie Ihren Nutzern Zugriffspunkte direkt über Ihre App.

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

  • Einen Besprechungsraum erstellen, um Nutzer per Video zu verbinden
  • Einen Besprechungsraum 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 Besprechungsraum oder alle Besprechungsrä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: Sie können den Besprechungsraum erstellen und so die Konferenz nach Bedarf anpassen. 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.

Hier 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 Coaching- und Vertriebseffektivitätsanalysen zu erstellen

  • Aus- und Weiterbildung

    • Besprechungen für Schulungen erstellen und vorkonfigurieren
    • Co-Moderatorrollen für Trainer und Sitzungsleiter zuweisen
    • Aufzeichnungen abrufen, damit Teilnehmer sich 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 Organisators 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 Teilnehmern, der in der Regel von einem Organisator der Videokonferenz erstellt wird und die Informationen zum Teilnehmen an 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 Besprechungsraum. 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-Moderator:in
Eine Person in einem Anruf , der von einem Moderator:in Host-Verwaltungsberechtigungen gewährt wurden, mit Ausnahme der Möglichkeit, den ursprünglichen Moderator:in zu entfernen.
Einwählen
Ein Telefon verwenden, um an einem Anruf teilzunehmen oder einen gestreamten Anruf anzuhören.
Moderator:in
Die Person, die einen Anruf erstellt hat (Organisator der Videokonferenz), oder die Person, die den Anruf steuert. Ein Organisator der Videokonferenz kann die Besprechung organisieren, muss aber nicht anwesend sein. Ein Moderator:in kann die Moderatorberechtigungen auch an einen Co-Moderator:in delegieren.
Besprechungscode

Eine eindeutige 10-stellige Zeichenfolge für einen Besprechungsraum, die in der Besprechungs-URI eines Besprechungsraums 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 Besprechungsraum getrennt werden und in Zukunft für andere Besprechungsrä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, die zur Identifizierung eines Besprechungsraums verwendet wird. 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.

Organisator der Videokonferenz

Der Nutzer, der den Besprechungsraum 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 Moderator:in der Besprechung. Es kann nur einen Organisator der Videokonferenz geben.

Besprechungsraum

Ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Besprechungsraum), in dem eine Konferenz stattfindet. In einem Raum kann jeweils nur eine aktive Konferenz stattfinden. Ein Besprechungsraum 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ät-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ät-Paar am selben Anruf teilnimmt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.

SIP-Adresse

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