In diesem Dokument wird erläutert, wie Sie mit 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 Videoaufzeichnungen und andere Artefakte wie Transkripte.
Damit Artefakte erstellt werden können, müssen die Teilnehmer sie in Meet konfigurieren, bevor die Videokonferenz endet. Weitere Informationen finden Sie unter Automatische Artefakte verwalten.
Transkripte funktionieren unabhängig von Aufzeichnungen. Sie müssen die Videokonferenz nicht aufzeichnen, um ein Transkript zu erstellen. Wenn alle Teilnehmer die Videokonferenz verlassen haben, wird das Transkript automatisch beendet. Weitere Informationen finden Sie unter Videokonferenzen aufzeichnen und Transkripte in Google Meet verwenden.
Artefakte abrufen
Wenn Sie Inhaber oder Teilnehmer eines Besprechungsbereichs sind, können Sie die Methoden get und list für die Ressourcen recordings, transcripts, transcripts.entries und smart notes aufrufen, um Artefakte abzurufen. Weitere Informationen finden Sie in den folgenden Abschnitten.
Durch die Authentifizierung und Autorisierung mit Nutzeranmeldedaten können 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 im Google Drive-Konto 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 Feld 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 von Aufzeichnungen auflisten.
Die Methode gibt eine Instanz einer recordings-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie eine bestimmte Aufzeichnung 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 einem Konferenzdatensatz auflisten möchten, verwenden Sie die Methode list für die Ressource recordings mit dem Pfadparameter parent. Das Format dafür ist 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. Um die Inhalte abzurufen oder das Transkript in einem Browser aufzurufen, verwenden Sie den Feldwert exportUri des Objekts. Wenn Sie mit der Google Docs API vertraut sind, entspricht der Feldwert document dem Wert documentId in der Ressource documents.
Das State-Objekt enthält den Status der Transkriptionssitzung. So können Sie abfragen, ob die Transkriptionssitzung gestartet wurde, ob die Transkriptionssitzung beendet wurde, die Transkriptionsdatei aber noch nicht fertig ist, oder ob die Transkriptionsdatei 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 einem Konferenzdatensatz auflisten möchten, verwenden Sie die Methode list für die Ressource transcripts mit dem Pfadparameter parent. Das Format dafür ist 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 in IETF BCP 47-Syntax enthalten.
Jeder Transkript-Eintrag ist mit einem participant-Namen in der Videokonferenz verbunden. 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-Transkriptdatei überein. Das passiert, wenn die Transkriptdatei nach der Generierung geändert wird.
Details zu einem Transkriptionsbeitrag 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 Transkriptions-Eintrags nicht kennen, können Sie alle Namen von Transkriptions-Einträgen auflisten, indem Sie die Methode list verwenden.
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 Transkript-Einträ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. Das Format dafür ist 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.
Intelligente Notizen
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu intelligenten Notizen für Videokonferenzen in einem Konferenzdatensatz abrufen.
Meet hat Zugriff auf die ID der Smart-Notiz, sobald die Daten der Smart-Notiz generiert wurden. Es ist möglich, dass ein Nutzer die Datei mit den Smart Notes aus Drive löscht, der eindeutige Name aber weiterhin in Meet zurückgegeben wird.
Die Ressource smartNotes enthält das Objekt State.
Dieses Objekt enthält den Status der Smart Notes-Sitzung. So können Sie abfragen, ob die Sitzung für intelligente Notizen gestartet wurde, ob sie beendet wurde, die Datei mit intelligenten Notizen aber noch nicht fertig ist, oder ob die Datei mit intelligenten Notizen generiert wurde und zum Herunterladen bereit ist.
Die Ressource smartNotes enthält auch den Objekttyp DocsDestination. Dieses Objekt enthält den Exportspeicherort in Drive, an dem die Datei mit den Smart-Notizen für Google Docs gespeichert wird. Um die Inhalte abzurufen oder die Smart Notes in einem Browser aufzurufen, verwenden Sie den Feldwert exportUri des Objekts. Wenn Sie mit der Google Docs API vertraut sind, entspricht der Feldwert document dem documentId in der documents-Ressource.
Sie können Smart-Notizen mit den Methoden get und list verwalten.
Details zu intelligenten Notizen abrufen
Wenn Sie Details zu einer bestimmten Datei mit Smart Notes abrufen möchten, verwenden Sie die Methode get für die Ressource smartNotes mit dem Pfadparameter name. Wenn Sie den Namen der Smart Notes nicht kennen, können Sie mit der Methode list alle Smart Notes-Dateien auflisten.
Die Methode gibt eine Instanz einer smartNotes-Ressource zurück.
Alle intelligenten Notizen auflisten
Wenn Sie Details zu allen Dateien mit Smart Notes in einem Konferenzdatensatz auflisten möchten, verwenden Sie die Methode list für die Ressource smartNotes mit dem Pfadparameter parent. Das Format dafür ist conferenceRecords/{conferenceRecord}.
Die Methode gibt eine Liste von Dateien mit intelligenten Notizen für Videokonferenzen zurück, die nach startTime in aufsteigender Reihenfolge sortiert sind, als Instanz einer smartNotes-Ressource. Informationen zum Anpassen der Seitengröße finden Sie unter Paginierung anpassen .
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 zurück. Wenn 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.