Google Meet REST API – Übersicht

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

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

  • Erstellen Sie einen Konferenzraum, um Nutzer per Video zu kontaktieren.
  • Sie können einen Konferenzraum oder eine Konferenz anhand des Ressourcennamens abrufen.
  • Eine Liste der Teilnehmer und Teilnehmersitzungen abrufen.
  • Artefakte für Videokonferenzen abrufen (Aufzeichnungen, Transkripte und Transkripteinträge).

Sie können Meet-Ereignisse auch über die Google Workspace Events API abonnieren. Um über Änderungen informiert zu werden, können Sie einen bestimmten Konferenzraum oder alle Konferenzräume eines bestimmten Nutzers abonnieren. Weitere Informationen finden Sie unter Veranstaltungen mit der Google Workspace Events API abonnieren und Google Meet-Veranstaltungen abonnieren.

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 einen Konferenzraum erstellen. Sie können Eingeladene auch verwalten und die Einstellungen vorkonfigurieren.

  • Während einer Konferenz: Rufen Sie Konferenzinformationen ab, um die App-Nutzung basierend auf den zurückgegebenen Metadaten zu ändern.

  • Nach einer Konferenz: Rufen Sie Konferenzartefakte ab, z. B. die Aufzeichnung und Transkription.

Hier einige Beispiele für Dinge, für die Sie die Meet REST API verwenden können:

  • Vertrieb und Kontoverwaltung

    • Besprechungs- und Teilnehmerinformationen zu Aufzeichnungszwecken abrufen.
    • Rufen Sie Elemente für Videokonferenzen ab und posten Sie sie in Ihrem Konto.
    • Führen Sie Transkriptionen und Aufzeichnungen über KI-Modelle aus, um Coaching und Analysen zur Effektivität des Vertriebs zu generieren.

  • Lernen und Entwicklung

    • Videokonferenzen für Schulungen erstellen und vorkonfigurieren
    • Weisen Sie Trainern und Sitzungsleitern Rollen als Co-Organisatoren zu.
    • Rufen Sie Aufzeichnungen ab, mit denen die Schüler oder Studenten sich nach Abschluss des Kurses das Material ansehen können.

  • Developer Operations

    • Sie können Videokonferenzen erstellen, um direkt mit Teammitgliedern in Kontakt zu treten.
    • Lassen Sie andere Stakeholder an laufenden Meetings teilnehmen, indem Sie Besprechungs- und Teilnehmerinformationen in Echtzeit teilen.
    • Führen Sie Transkriptionsdaten über KI-Modelle aus, um die richtigen nächsten Schritte zu generieren.
Sie können dynamische Videokonferenzen mit Kollegen in einem Chatbereich erstellen und daran teilnehmen.
Abbildung 1. Sie können dynamische Videokonferenzen mit Kollegen in einem Chatbereich 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 verbessern. Weitere Informationen finden Sie unter Anwendungsfälle für Chat.

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste der in dieser API verwendeten allgemeinen Begriffe:

Artefakt
Eine Datei, die von Meet als Reaktion auf eine Konferenz generiert wird, z. B. Aufzeichnungen und transcripts. In der Regel kann ein Artefakt kurz nach Ende einer Konferenz abgerufen werden.
Kalendertermin
Ein Termin in Google Kalender mit mehreren Teilnehmern, der in der Regel von einem Organisator erstellt wird und die Teilnahmeinformationen enthält. Möglicherweise ist Meet die Konferenzlösung für den Termin.
Call
Eine Sitzung, in der Meet verwendet wird oder um andere über den Beginn oder die Ausführung eines Anrufs zu informieren und ihnen zu ermöglichen, sofort teilzunehmen.
Konferenz
Eine Konferenz ist eine Instanz eines Anrufs in einem Konferenzraum. Nutzer betrachten dieses Szenario normalerweise als einzelne Besprechung.
Co-Moderator:in
Eine Person in einem Anruf, der von einem Host Berechtigungen zur Verwaltung durch den Organisator erteilt wurden, mit Ausnahme der Möglichkeit, den ursprünglichen Host zu entfernen.
Organisator
Die Person, die den Anruf erstellt hat (der Organisator der Videokonferenz) oder die Person, die den Anruf steuert. Ein Organisator kann die Besprechung organisieren, aber nicht anwesend sein. Ein Host kann Hostberechtigungen auch an einen Co-Organisator delegieren.
Besprechungscode

Ein typbarer, eindeutiger String mit 10 Zeichen für einen Konferenzraum, der im Besprechungs-URI eines Besprechungsraums verwendet wird. 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 möglicherweise von einem Konferenzraum getrennt werden und später für verschiedene Konferenzräume wiederverwendet werden können. In der Regel laufen Besprechungscodes 365 Tage nach der letzten Verwendung ab. Weitere Informationen finden Sie unter Besprechungscodes in Google Meet.

Name der Besprechung

Eine eindeutige, vom Server generierte ID, mit der ein Konferenzraum identifiziert wird. Dabei wird zwischen Groß- und Kleinschreibung berücksichtigt. Beispiel: jQCFfuBOdN5z. Die Besprechungs-ID wird im Feld name einer spaces-Ressource zurückgegeben.

Organisator einer Videokonferenz

Der Nutzer, der den Konferenzbereich erstellt hat Diese nutzende Person kann auch als Organisatorin des Meetings betrachtet werden. Der Nutzer ist möglicherweise während des Anrufs nicht anwesend oder der Organisator der Besprechung. Es kann nur einen Organisator geben.

Konferenzraum

Ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), an dem eine Konferenz stattfindet. Es kann jeweils nur eine aktive Konferenz an einem Ort abgehalten werden. Ein Konferenzraum bietet den Nutzern außerdem die Möglichkeit, gemeinsame Ressourcen zu finden.

Besprechungs-URI

Eine anklickbare URL, über die ein Anruf mit einem Nutzer gestartet oder diesem beigetreten wird. Jeder Aufruf 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 nimmt an einem Anruf teil oder verwendet den Companion-Modus, nutzt das Video als Zuschauer oder verwendet ein Raumgerät, das mit einem Anruf verbunden ist. Für jede Person gibt es eine conferenceRecords.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 conferenceRecords.participants.participantSessions-Ressource. Wenn der Teilnehmer mehrmals über dasselbe Teilnehmer-Geräte-Paar am selben Anruf teilnimmt, wird jedem Teilnehmer eine eindeutige Sitzungs-ID zugewiesen.

API-spezifische Autorisierungs- und Authentifizierungsinformationen

Autorisierungsbereiche sind die Berechtigungen, die Sie von Nutzern anfordern, damit Ihre App auf die Inhalte der Videokonferenz zugreifen kann. Wenn ein Nutzer Ihre Anwendung installiert, wird der Nutzer aufgefordert, diese Bereiche zu validieren. Im Allgemeinen sollten Sie den spezifischsten Bereich auswählen und vermeiden, Bereiche anzufordern, die Ihre Anwendung nicht benötigt. Nutzer gewähren leichter Zugriff auf eingeschränkte, 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 erlauben, die Metadaten aller Konferenzräume zu lesen, auf die der Nutzer Zugriff hat. Sensibel
https://www.googleapis.com/auth/meetings.space.created Apps erlauben, Metadaten zu Konferenzräumen zu erstellen, zu ändern und zu lesen, die von deiner App erstellt wurden. 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.