Google Meet REST API – Übersicht

Mit der Google Meet REST API können Sie Videokonferenzen für Google Meet erstellen und verwalten. Außerdem bietet sie Ihren Nutzern einen direkten Einstiegspunkt in Ihrer App.

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

  • Erstellen Sie einen Besprechungsraum, um Nutzer per Video zu verbinden.
  • Konferenzraum oder Konferenz anhand des Ressourcennamens abrufen
  • Liste der Teilnehmer und Teilnehmersitzungen abrufen
  • Besprechungsartefakte abrufen (Aufzeichnungen, Transkripte und Transkripteinträge)

Sie können Meet-Ereignisse auch über die Google Workspace Events API abonnieren. Wenn Sie über Änderungen informiert werden möchten, können Sie einen bestimmten Besprechungsraum oder alle Besprechungsräume abonnieren, die einem bestimmten Nutzer gehören. Weitere Informationen finden Sie unter Ereignisse mit der Google Workspace Events API abonnieren und Google Meet-Ereignisse abonnieren.

Anwendungsfälle

Apps können mit der Meet REST API integriert werden, um die folgenden Aufgaben auszuführen:

  • Vor einer Konferenz: Sie können die Konferenz nach Bedarf anpassen, indem Sie den Konferenzraum erstellen. Außerdem können Sie die eingeladenen Personen verwalten und die Einstellungen vorab konfigurieren.

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

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

Beispiele für die Verwendung der Meet REST API:

  • Vertrieb und Kontoverwaltung

    • Informationen zu Besprechungen und Teilnehmern zu Dokumentationszwecken abrufen
    • Besprechungsartefakte abrufen und in Konten posten
    • Führen Sie Transkripte und Aufnahmen durch KI-Modelle, um Coaching und Analysen zur Verkaufseffektivität zu generieren.

  • Lernen und Entwicklung

    • Videokonferenzen für das Training erstellen und vorkonfigurieren.
    • Weisen Sie Trainern und Sitzungsleitern die Rolle „Co-Organisator“ zu.
    • Aufzeichnungen abrufen, mit denen sich Schüler/Studenten die Kursmaterialien auch nach dem Kurs noch einmal ansehen können

  • Entwickler-Operationen

    • Videokonferenzen erstellen, um sofort mit Teammitgliedern in Kontakt zu treten
    • Sie können andere Stakeholder zu laufenden Videokonferenzen einladen, indem Sie Informationen zu Videokonferenzen und Teilnehmern in Echtzeit teilen.
    • Transkriptionsdaten durch KI-Modelle laufen lassen, um die richtigen nächsten Schritte zu generieren
Sie können in einem Chatbereich eine dynamische Videokonferenz mit Ihren Kollegen erstellen und daran teilnehmen.
Abbildung 1. Sie können in einem Chatbereich eine dynamische Videokonferenz mit Ihren Kollegen 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 Chat-Anwendungsfälle.

Allgemeine Begriffe

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

Artefakt
Eine Datei, die von Meet im Zusammenhang mit einer Videokonferenz generiert wurde, z. B. Aufzeichnungen und Transkripte. Normalerweise 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 Informationen zur Teilnahme an einer Videokonferenz enthält. Meet ist möglicherweise die Konferenzlösung für die Veranstaltung.
Anrufen
Eine Sitzung mit Meet oder um andere darüber zu informieren, dass ein Anruf beginnt oder gerade läuft, und ihnen die sofortige Teilnahme zu ermöglichen.
Konferenz
Eine Konferenz ist eine Instanz eines Anrufs in einem Konferenzraum. Nutzer betrachten dieses Szenario in der Regel als ein einziges Meeting.
Co-Moderator:in
Eine Person in einem Anruf, der von einem Organisator Berechtigungen zur Verwaltung des Organisators gewährt wurden, mit Ausnahme der Möglichkeit, den ursprünglichen Organisator zu entfernen.
Moderator:in
Die Person, die einen Anruf erstellt hat (Organisator der Videokonferenz) oder die Person, die den Anruf steuert. Der Organisator einer Videokonferenz kann die Videokonferenz zwar organisieren, aber nicht anwesend sein, wenn sie stattfindet. Ein Organisator kann auch Co-Organisatoren die Berechtigungen eines Organisators delegieren.
Besprechungscode

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

Konferenzcodes 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 finden Sie unter Weitere Informationen zu Besprechungscodes in Google Meet.

Name der Videokonferenz

Eine eindeutige, servergenerierte ID, mit der ein Videokonferenzraum identifiziert wird. Die Groß- und Kleinschreibung wird berücksichtigt. Beispiel: jQCFfuBOdN5z. Die Konferenz-ID wird im Feld name einer spaces-Ressource zurückgegeben.

Organisator der Videokonferenz

Der Nutzer, der den Konferenzraum erstellt hat. Dieser Nutzer kann auch als Organisator der Videokonferenz betrachtet werden. Möglicherweise ist die Person nicht während des Anrufs anwesend oder ist nicht der Leiter der Videokonferenz. Es kann nur einen Organisator geben.

Konferenzraum

Ein virtueller Ort oder ein dauerhaftes Objekt (z. B. ein Konferenzraum), an dem eine Konferenz stattfindet. In einem Gruppenbereich kann immer nur eine aktive Videokonferenz stattfinden. In einem Gruppenbereich können Nutzer auch andere Nutzer treffen und gemeinsam genutzte Ressourcen finden.

URI der Videokonferenz

Eine anklickbare URL, über die ein Anruf gestartet oder beigetreten wird. Jeder Anruf hat eine eindeutige URL, die aus https://meet.google.com/ gefolgt vom Meetingcode besteht. Beispiel: https://meet.google.com/abc-mnop-xyz

Teilnehmer

Eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet, sich als Zuschauer ansieht oder ein mit einem Anruf verbundenes Raumgerät. Es gibt eine conferenceRecords.participants-Ressource für jede Person. 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. Wenn der Teilnehmer demselben Anruf mehrmals über dasselbe Teilnehmer-Geräte-Paar beitritt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.