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 Einstiegspunkte direkt über Ihre App.

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

  • Erstellen Sie einen Konferenzraum, um Nutzer per Video zu vernetzen.
  • Rufen Sie einen Konferenzraum oder eine Konferenz anhand des Ressourcennamens ab.
  • Eine Liste der Teilnehmer und Sitzungen abrufen.
  • Rufen Sie Elemente für die Videokonferenz ab (Aufzeichnungen, Transkripte und Transkripteinträge).

Sie können Meet-Veranstaltungen auch über die Google Workspace Events API abonnieren. Wenn Sie über Änderungen informiert 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 Termine mit der Google Workspace Events API abonnieren und Google Meet-Veranstaltungen abonnieren.

Anwendungsfälle

Mit der Meet REST API lassen sich Apps für die folgenden Aufgaben einbinden:

  • Vor einer Konferenz: Passen Sie die Konferenzumgebung nach Bedarf an. Sie können auch Eingeladene verwalten und die Einstellungen vorkonfigurieren.

  • Während einer Konferenz: Rufen Sie Konferenzinformationen ab, um die Anwendungserfahrung auf der Grundlage der zurückgegebenen Metadaten zu ändern.

  • Nach einer Konferenz: Rufen Sie Konferenzartefakte wie die Aufzeichnung und Transkription ab.

Sie können die Meet REST API beispielsweise für folgende Zwecke verwenden:

  • Vertrieb und Kontoverwaltung

    • Besprechungs- und Teilnehmerinformationen zu Aufzeichnungszwecken abrufen
    • Besprechungselemente abrufen und in Konten veröffentlichen
    • Transkriptionen und Aufzeichnungen mithilfe von KI-Modellen ausführen, um Coaching- und Vertriebseffizienzanalysen zu generieren

  • Lernen und Entwicklung

    • Sie können Videokonferenzen für Schulungen erstellen und vorkonfigurieren.
    • Schulungsleitern und Sitzungsleitern Rollen als Co-Organisator zuweisen
    • Rufen Sie Aufzeichnungen ab, damit Schüler und Studenten sich nach Kursende Materialien ansehen können.

  • Developer Operations

    • Sie können Besprechungen erstellen, um sofort mit den Teammitgliedern in Kontakt zu treten.
    • Lassen Sie andere Stakeholder an laufenden Meetings teilnehmen, indem Sie Besprechungs- und Teilnehmerinformationen in Echtzeit teilen.
    • Transkriptionsdaten über KI-Modelle ausführen, um die richtigen nächsten Schritte zu generieren
Dynamische Videokonferenzen in einem Chatbereich mit Ihren Kollegen erstellen und daran teilnehmen.
Abbildung 1. Dynamische Videokonferenzen in einem Chatbereich mit Ihren Kollegen erstellen und daran teilnehmen.

Sie können auch andere Google Workspace APIs wie die Chat API in Ihre Anwendung einbinden, um die Zusammenarbeit noch weiter zu optimieren. Weitere Informationen finden Sie unter Anwendungsfälle für Chat.

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste gebräuchlicher Begriffe, die in dieser API verwendet werden:

Artefakt
Eine Datei, die von Meet als Reaktion auf eine Konferenz generiert wird, z. B. Aufzeichnungen und transcripts. Normalerweise kann ein Artefakt kurz nach dem Ende einer Konferenz abgerufen werden.
Kalendertermin
Ein Termin in Google Kalender mit mehreren Teilnehmern, der in der Regel von einem Organisator der Videokonferenz erstellt wurde und die Teilnahmeinformationen einer Videokonferenz enthält. Meet kann die Lösung für Videokonferenzen für Ihre Veranstaltung sein.
Anruf
Eine Sitzung mit Meet oder um andere darüber zu informieren, dass ein Anruf beginnt oder gerade stattfindet, und um ihnen die Möglichkeit zu geben, sofort teilzunehmen.
Konferenz
Eine Konferenz ist eine Instanz eines Anrufs in einem Konferenzraum. Nutzer betrachten dieses Szenario in der Regel als eine einzige Besprechung.
Co-Moderator:in
Eine Person in einem Anruf, die von einem Organisator Berechtigungen zum Verwalten des Hosts erhalten hat, mit Ausnahme der Möglichkeit, den ursprünglichen Host zu entfernen.
Organisator
Die Person, die den Anruf erstellt hat (Organisator der Videokonferenz), oder die Person, die den Anruf steuert. Der Organisator einer Videokonferenz kann die Videokonferenz organisieren, ist aber nicht anwesend, wenn die Videokonferenz stattfindet. Ein Organisator kann auch Hostberechtigungen an einen Co-Organisator delegieren.
Besprechungscode
Ein typbarer, eindeutiger String mit 10 Zeichen für einen Konferenzbereich, der in der Teilnahme-URL eines Besprechungsbereichs verwendet wird. Beispiel: abc-mnop-xyz. Besprechungscodes sollten nicht langfristig gespeichert werden, da sie von einem Konferenzraum getrennt und später für andere Konferenzräume wiederverwendet werden können. Im Allgemeinen laufen Besprechungscodes 365 Tage nach der letzten Nutzung ab. Weitere Informationen finden Sie unter Weitere Informationen zu Besprechungscodes in Google Meet.
Name der Videokonferenz
Eine eindeutige, vom Server generierte ID, mit der ein Konferenzraum identifiziert wird. Die Besprechungs-ID wird im Feld name einer spaces-Ressource zurückgegeben.
Organisator der Videokonferenz
Der Nutzer, der den Konferenzbereich erstellt hat. Dieser Nutzer kann auch als Inhaber der Besprechung angesehen werden. Er ist möglicherweise während des Anrufs nicht anwesend oder ist der Organisator der Videokonferenz. Es kann nur einen Organisator für eine Videokonferenz geben.
Konferenzbereich
Ein virtueller Ort oder ein persistentes Objekt (z. B. ein Konferenzraum), an dem eine Konferenz stattfindet. Es kann jeweils nur eine aktive Konferenz in einem Raum stattfinden. Außerdem können sich Nutzer über einen Konferenzraum treffen und gemeinsam genutzte Ressourcen finden.
Teilnehmer
Eine Person, die einem Anruf beigetreten ist oder den Companion-Modus verwendet, als Betrachter schaut oder ein mit einem Anruf verbundenes Gerät im Raum nutzt. Für jede Person gibt es eine conferenceRecords.participants-Ressource. Wenn ein Teilnehmer der Konferenz beitritt, 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 conferenceRecords.participants.participantSessions-Ressource. Nimmt ein Teilnehmer mehrmals über dasselbe Teilnehmer-/Gerätepaar am selben Anruf teil, wird ihm eine eindeutige Sitzungs-ID zugewiesen.

API-spezifische Autorisierungs- und Authentifizierungsinformationen

Autorisierungsbereiche sind die Berechtigungen, die Nutzer autorisieren sollen, damit Ihre App auf den Besprechungsinhalt zugreifen kann. Wenn ein Nutzer Ihre Anwendung installiert, wird er aufgefordert, diese Bereiche zu validieren. Im Allgemeinen sollten Sie einen möglichst eng gefassten Bereich wählen und keine Bereiche anfordern, die Ihre Anwendung nicht benötigt. Nutzer gewähren leichter Zugriff auf begrenzte, klar beschriebene Bereiche.

Die Meet REST API unterstützt die folgenden OAuth 2.0-Bereiche:

Bereichscode Beschreibung Nutzung
https://www.googleapis.com/auth/meetings.space.readonly Apps dürfen Metadaten zu jedem Konferenzraum lesen, auf den der Nutzer Zugriff hat. Sensibel
https://www.googleapis.com/auth/meetings.space.created Apps dürfen Metadaten zu Besprechungsräumen, die von Ihrer App erstellt wurden, erstellen, ändern und lesen. Sensibel
https://www.googleapis.com/auth/drive.readonly Apps dürfen Aufzeichnungs- und Transkriptdateien aus der Google Drive API herunterladen. Eingeschränkt

Weitere Informationen zu bestimmten OAuth 2.0-Bereichen finden Sie unter OAuth 2.0-Bereiche für Google APIs.