In diesem Leitfaden wird erläutert, wie Sie mithilfe der Google Meet REST API Details zu den verschiedenen Besprechungsartefakten abrufen, die von einer Konferenz generiert wurden.
Ein Artefakt ist eine Datei oder Daten, die von Google Meet in Reaktion auf eine Konferenz generiert werden. Dazu gehören Videos und andere Artefakte wie Transkripte.
Wenn Teilnehmer Artefakte erstellen möchten, müssen sie diese vor Ende der Videokonferenz in Meet generieren. Transkripte sind unabhängig von Aufzeichnungen und Sie müssen die Besprechung nicht aufzeichnen, um ein Transkript zu erstellen. Weitere Informationen finden Sie unter Videokonferenzen aufzeichnen und Transkripte in Google Meet verwenden.
Wenn Sie Inhaber oder Teilnehmer eines Besprechungsraums sind, können Sie die Methoden get()
und list()
für die Ressourcen recordings
, transcripts
und transcripts.entries
aufrufen, um Artefakte abzurufen.
Wenn Sie die Authentifizierung und Autorisierung mit Nutzeranmeldedaten durchführen, können Google Meet-Apps auf Nutzerdaten zugreifen und im Namen des authentifizierten Nutzers Vorgänge ausführen. Wenn Sie sich mit der domainweiten Delegierung authentifizieren, können Sie das Dienstkonto einer Anwendung für den Zugriff auf die Daten Ihrer Nutzer autorisieren, ohne dass jeder Nutzer seine Einwilligung geben muss.
Aufbewahrung von Artefakten
Nach dem Ende einer Videokonferenz werden Aufzeichnungen und Transkripte in Google Drive des Organisators gespeichert. Standardmäßig werden Meet-Artefakte gemäß den Drive-Regeln aufbewahrt.
Transkripteinträge, die über die Meet REST API bereitgestellt werden, werden 30 Tage nach Ende der Konferenz gelöscht.
Sie können die Aufbewahrung von Meet-Artefakten auch separat mithilfe von Meet-spezifischen Aufbewahrungsregeln in Google Vault verwalten. Weitere Informationen finden Sie unter Aufbewahrungsregeln für Google Meet festlegen.
Aufnahmen
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Aufzeichnungen in einem Konferenzdatensatz abrufen.
Meet hat Zugriff auf die Aufzeichnungs-ID, nachdem die Aufzeichnungsdatei generiert wurde. Es ist möglich, dass ein Nutzer die Aufzeichnungsdatei aus Google Drive löscht, der eindeutige Name aber trotzdem in Meet zurückgegeben wird.
Die recordings
-Ressource enthält sowohl die DriveDestination
- als auch die State
-Objekte.
Das DriveDestination
-Objekt enthält den Exportspeicherort in Google Drive, an dem die Aufnahme als MP4-Datei gespeichert wird. Verwenden Sie den Feldwert exportUri
des Objekts, um die Aufzeichnung herunterzuladen oder in einem Browser abzuspielen. Wenn Sie mit der Google Drive API vertraut sind, entspricht der Wert des Felds file
dem id
in der Ressource files
. Weitere Informationen finden Sie unter Dateien herunterladen und exportieren.
Das State
-Objekt enthält den Status der Aufzeichnungssitzung. So können Sie abfragen, ob die Aufzeichnung gestartet wurde, ob die Aufzeichnung beendet ist, die Aufzeichnungsdatei aber noch nicht bereit ist, oder ob die Aufzeichnungsdatei generiert und zum Herunterladen bereit ist.
Details zu einer Aufnahme abrufen
Wenn Sie Details zu einer bestimmten Aufnahme abrufen möchten, verwenden Sie die Methode get()
auf der Ressource recordings
mit dem Pfadparameter name
. Wenn Sie den Namen der Aufnahme nicht kennen, können Sie mit der Methode list()
alle Aufnahmenamen auflisten.
Die Methode gibt eine Instanz einer recordings
-Ressource zurück.
Im folgenden Codebeispiel wird gezeigt, wie eine bestimmte Aufnahme abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Aufnahmenamen durch den Namen der jeweiligen Aufnahme-ID in einem Konferenzprotokoll.
Alle Aufnahmen auflisten
Wenn Sie Details zu allen Aufnahmen in einem Konferenzprotokoll auflisten möchten, verwenden Sie die Methode list()
auf der Ressource recordings
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}
.
Die Methode gibt eine Liste von Konferenzaufzeichnungen zurück, sortiert nach startTime
in aufsteigender Reihenfolge, als Instanz einer recordings
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Im folgenden Codebeispiel wird gezeigt, wie alle Aufnahmen in einem Konferenzprotokoll aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenz-Eintrags.
Transkripte
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Konferenztranskripten in einem Konferenzdatensatz abrufen.
Meet hat Zugriff auf die Transkript-ID, sobald die Transkriptdaten generiert wurden. Es ist möglich, dass ein Nutzer die Transkriptdatei aus Drive löscht, der eindeutige Name aber trotzdem in Meet zurückgegeben wird.
Die transcripts
-Ressource enthält sowohl die DocsDestination
- als auch die State
-Objekte.
Das DocsDestination
-Objekt enthält den Exportspeicherort in Google Drive, an dem die Transkriptdatei in Google Docs gespeichert wird. Wenn du den Inhalt abrufen oder das Transkript in einem Browser aufrufen möchtest, verwende den Feldwert exportUri
des Objekts. Wenn Sie mit der Google Docs API vertraut sind, entspricht der Wert des Felds document
dem documentId
in der Ressource documents
.
Das State
-Objekt enthält den Status der Transkriptsitzung. So kannst du abfragen, ob die Transkriptsitzung gestartet wurde, ob die Transkriptsitzung beendet wurde, die Transkriptdatei aber noch nicht bereit ist, oder ob die Transkriptdatei generiert und zum Download bereit ist.
Details zu einem Transkript abrufen
Wenn Sie Details zu einem bestimmten Transkript abrufen möchten, verwenden Sie die Methode get()
auf der Ressource transcripts
mit dem Pfadparameter name
. Wenn Sie den Namen des Transkripts nicht kennen, können Sie mit der Methode list()
alle Transkriptnamen auflisten.
Die Methode gibt eine Instanz einer transcripts
-Ressource zurück.
Im folgenden Codebeispiel wird gezeigt, wie ein bestimmtes Transkript abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Transkriptnamen durch den Namen der jeweiligen Transkript-ID in einem Konferenzprotokoll.
Alle Transkripte auflisten
Wenn Sie Details zu allen Transkripten in einem Konferenzprotokoll auflisten möchten, verwenden Sie die Methode list()
für die Ressource transcripts
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}
.
Die Methode gibt eine Liste von Konferenzprotokollen zurück, sortiert nach startTime
in aufsteigender Reihenfolge, als Instanz einer transcripts
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Das folgende Codebeispiel zeigt, wie alle Transkripte in einem Konferenzprotokoll aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenz-Eintrags.
Transkripteinträge
In den folgenden Abschnitten wird beschrieben, wie Sie die Rede jedes Teilnehmers während einer Konferenztranskriptsitzung als Transkripteinträge abrufen.
Der Transkripteintrag enthält den transkribierten Text der Stimme des Teilnehmers, maximal 10.000 Wörter. Der gesprochene Text languageCode
(z. B. en-US
) ist auch als IETF BCP 47-Syntax enthalten.
Jeder Transkripteintrag ist mit einem participant
-Namen in der Konferenz verknüpft. Informationen zum Abrufen von Teilnehmerdetails finden Sie unter Details zu einem Teilnehmer abrufen.
Die Daten der Transkripteinträge sind 30 Tage nach Ende der Konferenz verfügbar.
Die von der Meet REST API zurückgegebenen Transkripteinträge stimmen möglicherweise nicht mit der Transkription in der Docs-Transkriptdatei überein. Das passiert, wenn die Transkriptdatei nach der Generierung geändert wird.
Details zu einem Transkripteintrag abrufen
Wenn Sie Details zu einem bestimmten Transkripteintrag abrufen möchten, verwenden Sie die Methode get()
für die Ressource transcripts.entries
mit dem Pfadparameter name
. Wenn Sie den Namen des Transkripteintrags nicht kennen, können Sie mit der Methode list()
alle Transkriptnamen auflisten.
Die Methode gibt eine Instanz einer transcripts.entries
-Ressource zurück.
Im folgenden Codebeispiel wird gezeigt, wie ein bestimmter Transkripteintrag abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Namen des Transkripteintrags durch den Namen der ID des jeweiligen Transkripteintrags.
Alle Transkripteinträge auflisten
Wenn du Details zu allen Transkripteinträgen in einem Transkript auflisten möchtest, verwende die Methode list()
auf der Ressource transcripts.entries
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Die Methode gibt eine Liste strukturierter Transkripteinträge pro Konferenztranskript zurück, sortiert nach startTime
in aufsteigender Reihenfolge, als Instanz einer transcripts.entries
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Im folgenden Codebeispiel wird gezeigt, wie alle Transkripteinträge in einem Transkript aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzeintrags und den Namen des Transkripts.
Paginierung anpassen
Übergeben Sie die folgenden Abfrageparameter, um die Paginierung von Aufnahmen, Transkripten und Transkripteinträgen anzupassen:
pageSize
: Die maximale Anzahl der zurückzugebenden Elemente. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10 Elemente zurückgegeben. Der Höchstwert ist 100. Werte über 100 werden automatisch in 100 geändert.pageToken
: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.
Weitere Informationen
- Videokonferenzen aufzeichnen
- Transkripte mit Google Meet verwenden
- Google Meet-Daten mit Vault aufbewahren
- Meet-Funktionen als Administrator anpassen