In diesem Leitfaden wird erläutert, wie Sie mithilfe der Google Meet REST API Details zu den verschiedenen Besprechungsartefakten abrufen, die von einer Videokonferenz generiert werden.
Ein Artefakt ist eine Datei oder ein Datensatz, der von Google Meet als Reaktion auf eine Videokonferenz generiert wird. Dazu gehören Videos und andere Artefakte wie Transkripte.
Teilnehmer müssen Artefakte in Meet generieren, bevor die Videokonferenz endet. Transkripte funktionieren unabhängig von Aufzeichnungen. 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 Eigentümer 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.
Durch die Authentifizierung und Autorisierung mit Nutzeranmeldedaten können Google Meet-Apps auf Nutzerdaten zugreifen und Vorgänge im Namen des authentifizierten Nutzers ausführen. Durch die Authentifizierung mit domainweiter Delegierung können Sie das Dienstkonto einer Anwendung autorisieren, auf die Daten Ihrer Nutzer zuzugreifen, ohne dass jeder Nutzer seine Einwilligung geben muss.
Aufbewahrung von Artefakten
Nach dem Ende einer Videokonferenz speichert Meet Aufzeichnungen und Transkripte in Google Drive des Organisators. Standardmäßig werden Meet-Artefakte gemäß den Google Drive-Regeln aufbewahrt.
Transkriptionsbeiträge, die von der Meet REST API bereitgestellt werden, werden 30 Tage nach Ende der Videokonferenz gelöscht.
Sie können die Aufbewahrung von Meet-Artefakten auch separat mit Meet-spezifischen Aufbewahrungsregeln in Google Vault verwalten. Weitere Informationen finden Sie unter Google Meet-Daten mit Vault aufbewahren.
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 weiterhin in Meet zurückgegeben wird.
Die Ressource recordings
enthält sowohl die Objekte DriveDestination
als auch State
.
Das DriveDestination
-Objekt enthält den Exportspeicherort in Drive, an dem die Aufzeichnung als MP4-Datei gespeichert wird. Verwenden Sie den Feldwert exportUri
des Objekts, um die Aufzeichnung herunterzuladen oder in einem Browser wiederzugeben. Wenn Sie mit der Google Drive API vertraut sind, entspricht der Feldwert file
dem Wert 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 wurde, die Aufzeichnungsdatei aber noch nicht fertig ist, oder ob die Aufzeichnungsdatei generiert wurde und zum Herunterladen bereit ist.
Details zu einer Aufnahme abrufen
Wenn Sie Details zu einer bestimmten Aufzeichnung abrufen möchten, verwenden Sie die Methode get()
für die Ressource recordings
mit dem Pfadparameter name
. Wenn Sie den Namen der Aufzeichnung nicht kennen, können Sie mit der Methode list()
alle Namen der Aufzeichnungen auflisten.
Die Methode gibt eine Instanz einer recordings
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie eine bestimmte Aufnahme abrufen:
Java
Node.js
Python
Ersetzen Sie den Aufzeichnungsnamen durch den Namen der jeweiligen Aufzeichnungs-ID in einem Konferenzdatensatz.
Alle Aufnahmen auflisten
Wenn Sie Details zu allen Aufzeichnungen in einer Konferenzaufzeichnung auflisten möchten, verwenden Sie die Methode list()
für die Ressource recordings
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}
.
Die Methode gibt eine Liste von Konferenzaufzeichnungen zurück, die nach startTime
in aufsteigender Reihenfolge sortiert sind, als Instanz einer recordings
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Das folgende Codebeispiel zeigt, wie Sie alle Aufzeichnungen in einem Konferenzdatensatz auflisten:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzdatensatzes.
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 weiterhin in Meet zurückgegeben wird.
Die Ressource transcripts
enthält sowohl die Objekte DocsDestination
als auch State
.
Das DocsDestination
-Objekt enthält den Exportspeicherort in Drive, an dem die Google-Dokumente-Transkriptdatei gespeichert wird. Verwenden Sie den Feldwert exportUri
des Objekts, um die Inhalte abzurufen oder das Transkript in einem Browser aufzurufen. 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 Transkriptionssitzung. So können Sie abfragen, ob die Transkriptsitzung gestartet wurde, ob die Transkriptsitzung beendet wurde, die Transkriptdatei aber noch nicht fertig ist, oder ob die Transkriptdatei generiert wurde und zum Herunterladen bereit ist.
Details zu einem Transkript abrufen
Wenn Sie Details zu einem bestimmten Transkript abrufen möchten, verwenden Sie die Methode get()
für die 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.
Das folgende Codebeispiel zeigt, wie Sie ein bestimmtes Transkript abrufen:
Java
Node.js
Python
Ersetzen Sie den Namen des Transkripts durch den Namen der jeweiligen Transkript-ID in einem Konferenzdatensatz.
Alle Transkripte auflisten
Wenn Sie Details zu allen Transkripten in einer Konferenzaufzeichnung 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 Konferenztranskripten zurück, die nach startTime
in aufsteigender Reihenfolge sortiert sind, als Instanz einer transcripts
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Das folgende Codebeispiel zeigt, wie Sie alle Transkripte in einem Konferenzdatensatz auflisten:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzdatensatzes.
Transkripteinträge
In den folgenden Abschnitten wird beschrieben, wie Sie die Sprache der einzelnen Teilnehmer während einer Konferenztranskriptionssitzung als Transkriptionseinträge erhalten.
Der Transkript-Eintrag enthält den transkribierten Text der Stimme des Teilnehmers mit bis zu 10.000 Wörtern. Der gesprochene Text languageCode
(z. B. en-US
) ist auch als IETF BCP 47-Syntax enthalten.
Jeder Transkript-Eintrag ist mit einem participant
-Namen in der Videokonferenz verknüpft. Informationen zum Abrufen von Teilnehmerdetails finden Sie unter Details zu einem Teilnehmer abrufen.
Daten zu Transkripten sind 30 Tage nach dem Ende der Videokonferenz verfügbar.
Die von der Meet REST API zurückgegebenen Transkriptions-Einträge stimmen möglicherweise nicht mit der Transkription in der Docs-Transkriptionsdatei überein. Das passiert, wenn die Transkriptdatei nach der Generierung geändert wird.
Details zu einem Transkriptionsbeitrag abrufen
Wenn Sie Details zu einem bestimmten Transkriptions-Eintrag abrufen möchten, verwenden Sie die Methode get()
für die Ressource transcripts.entries
mit dem Pfadparameter name
. Wenn Sie den Namen des Transkript-Eintrags nicht kennen, können Sie mit der Methode list()
alle Transkriptnamen auflisten.
Die Methode gibt eine Instanz einer transcripts.entries
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie einen bestimmten Transkriptionsbeitrag abrufen:
Java
Node.js
Python
Ersetzen Sie den Namen des Transkript-Eintrags durch die ID des jeweiligen Transkript-Eintrags in einem Transkript.
Alle Transkripteinträge auflisten
Wenn Sie Details zu allen Transkripteinträgen in einem Transkript auflisten möchten, verwenden Sie die Methode list()
für die Ressource transcripts.entries
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Die Methode gibt eine Liste strukturierter Transkriptions-Einträge pro Konferenztranskript zurück, die nach startTime
in aufsteigender Reihenfolge sortiert sind, als Instanz einer transcripts.entries
-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
Das folgende Codebeispiel zeigt, wie Sie alle Transkriptions-Einträge in einem Transkript auflisten:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen der Konferenzaufzeichnung und den Namen des Transkripts.
Seitenumbruch anpassen
Übergeben Sie die folgenden Abfrageparameter, um die Paginierung von Aufzeichnungen, Transkripten und Transkripteinträgen anzupassen:
pageSize
: Die maximale Anzahl der zurückzugebenden Elemente. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Falls nicht angegeben, werden maximal 10 Elemente zurückgegeben. Der Höchstwert ist 100. Werte über 100 werden automatisch auf 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