En esta guía, se explica cómo obtener detalles sobre los diferentes artefactos de reunión que genera una conferencia con la API de REST de Google Meet.
Un artefacto es un archivo o datos que genera Google Meet en respuesta a una conferencia. Esto incluye videos y otros artefactos, como transcripciones.
Para producir artefactos, los participantes deben generarlos en Meet antes de que finalice la conferencia. Las transcripciones funcionan independientemente de las grabaciones y no es necesario grabar la reunión para generar una transcripción. Para obtener más información, consulta Cómo grabar una videoconferencia y Cómo usar transcripciones con Google Meet.
Si eres propietario o participante de un espacio de reunión, puedes llamar a los métodos get()
y list()
en los recursos recordings
, transcripts
y transcripts.entries
para recuperar artefactos.
La autenticación y autorización con credenciales del usuario permite que las apps de Google Meet accedan a los datos del usuario y realicen operaciones en su nombre. La autenticación con la delegación de autoridad en todo el dominio te permite autorizar a la cuenta de servicio de una aplicación para que acceda a los datos de tus usuarios sin que cada uno de ellos deba dar su consentimiento.
Retención de artefactos
Cuando finaliza una conferencia, Meet guarda las grabaciones y transcripciones en la unidad de Google Drive del organizador de la reunión. De forma predeterminada, los artefactos de Meet se retienen según las reglas de Drive.
Las entradas de transcripción que proporciona la API de REST de Meet se borran 30 días después de que termina la conferencia.
También puedes administrar la retención de artefactos de Meet por separado con las reglas de retención específicas de Meet en Google Vault. Para obtener más información, consulta Cómo conservar los datos de Google Meet con Vault.
Grabaciones
En las siguientes secciones, se detalla cómo obtener información sobre las grabaciones en un registro de conferencia.
Meet tiene acceso al ID de grabación después de que se genera el archivo de grabación. Es posible que un usuario borre el archivo de grabación de Google Drive, pero el nombre único se sigue mostrando en Meet.
El recurso recordings
incluye los objetos DriveDestination
y State
.
El objeto DriveDestination
contiene la ubicación de exportación en Drive, donde se guarda la grabación como un archivo MP4. Para descargar la grabación o reproducirla en un navegador, usa el valor del campo exportUri
del objeto. Si conoces la API de Google Drive, el valor del campo file
corresponde al id
en el recurso files
. Para obtener más información, consulta Cómo descargar y exportar archivos.
El objeto State
contiene el estado de la sesión de grabación. Esto te permite consultar si la grabación comenzó, si finalizó, pero el archivo de grabación aún no está listo, o si el archivo de grabación se generó y está listo para descargarse.
Obtén detalles sobre una grabación
Para obtener detalles sobre una grabación específica, usa el método get()
en el recurso recordings
con el parámetro de ruta name
. Si no conoces el nombre de la grabación, puedes enumerar todos los nombres de grabación con el método list()
.
El método muestra una instancia de un recurso recordings
.
En la siguiente muestra de código, se muestra cómo recuperar una grabación específica:
Java
Node.js
Python
Reemplaza el nombre de la grabación por el nombre del ID de grabación específico en un registro de conferencia.
Cómo ver todas las grabaciones
Para mostrar una lista de detalles sobre todas las grabaciones de un registro de conferencia, usa el método list()
en el recurso recordings
con el parámetro de ruta parent
. Formato: conferenceRecords/{conferenceRecord}
.
El método muestra una lista de grabaciones de conferencias, ordenadas por startTime
en orden ascendente, como una instancia de un recurso recordings
. Para ajustar el tamaño de la página, consulta Cómo personalizar la paginación .
En la siguiente muestra de código, se muestra cómo enumerar todas las grabaciones de un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia.
Transcripciones
En las siguientes secciones, se detalla cómo obtener información sobre las transcripciones de conferencias en un registro de conferencia.
Meet tiene acceso al ID de transcripción una vez que se generan los datos de la transcripción. Es posible que un usuario borre el archivo de transcripción de Drive, pero el nombre único se sigue mostrando en Meet.
El recurso transcripts
incluye los objetos DocsDestination
y State
.
El objeto DocsDestination
contiene la ubicación de exportación en Drive donde se guarda el archivo de transcripción de Documentos de Google. Para recuperar el contenido o explorar la transcripción en un navegador, usa el valor del campo exportUri
del objeto. Si conoces la API de Documentos de Google, el valor del campo document
corresponde al documentId
en el recurso documents
.
El objeto State
contiene el estado de la sesión de transcripción. Esto te permite consultar si la sesión de transcripción comenzó, si finalizó, pero el archivo de transcripción aún no está listo, o si se generó y está listo para descargarse.
Obtén detalles sobre una transcripción
Para obtener detalles sobre una transcripción específica, usa el método get()
en el recurso transcripts
con el parámetro de ruta name
. Si no conoces el nombre de la transcripción, puedes mostrar una lista de todos los nombres de las transcripciones con el método list()
.
El método muestra una instancia de un recurso transcripts
.
En la siguiente muestra de código, se muestra cómo recuperar una transcripción específica:
Java
Node.js
Python
Reemplaza el nombre de la transcripción por el nombre del ID de transcripción específico en un registro de conferencia.
Cómo ver todas las transcripciones
Para enumerar los detalles de todas las transcripciones de un registro de conferencia, usa el método list()
en el recurso transcripts
con el parámetro de ruta parent
. Formato: conferenceRecords/{conferenceRecord}
.
El método muestra una lista de transcripciones de conferencias, ordenadas por startTime
en orden ascendente, como una instancia de un recurso transcripts
. Para ajustar el tamaño de la página, consulta Cómo personalizar la paginación .
En la siguiente muestra de código, se muestra cómo enumerar todas las transcripciones en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia.
Entradas de transcripción
En las siguientes secciones, se detalla cómo obtener el discurso de cada participante como entradas de transcripción durante una sesión de transcripción de conferencias.
La entrada de transcripción contiene el texto transcrito de la voz del participante, hasta un máximo de 10,000 palabras. El texto hablado languageCode
(por ejemplo, en-US
) también se incluye como sintaxis IETF BCP 47.
Cada entrada de transcripción está conectada a un nombre participant
en la conferencia. Para recuperar los detalles de los participantes, consulta Cómo obtener detalles sobre un participante.
Los datos de entrada de la transcripción están disponibles durante 30 días después de que finaliza la conferencia.
Ten en cuenta que las entradas de transcripción que muestra la API de REST de Meet pueden no coincidir con la transcripción que se encuentra en el archivo de transcripción de Documentos. Esto ocurre cuando se modifica el archivo de transcripción después de la generación.
Obtén detalles sobre una entrada de transcripción
Para obtener detalles sobre una entrada de transcripción específica, usa el método get()
en el recurso transcripts.entries
con el parámetro de ruta name
. Si no conoces el nombre de la entrada de la transcripción, puedes mostrar una lista de todos los nombres de las transcripciones con el método list()
.
El método muestra una instancia de un recurso transcripts.entries
.
En la siguiente muestra de código, se muestra cómo recuperar una entrada de transcripción específica:
Java
Node.js
Python
Reemplaza el nombre de la entrada de transcripción por el nombre del ID de entrada de transcripción específico en una transcripción.
Muestra una lista de todas las entradas de transcripción
Para enumerar los detalles de todas las entradas de una transcripción, usa el método list()
en el recurso transcripts.entries
con el parámetro de ruta parent
. Formato: conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
El método muestra una lista de entradas de transcripción estructuradas por transcripción de conferencia, ordenadas por startTime
en orden ascendente, como una instancia de un recurso transcripts.entries
. Para ajustar el tamaño de la página, consulta Cómo personalizar la paginación .
En la siguiente muestra de código, se muestra cómo enumerar todas las entradas de una transcripción:
Java
Node.js
Python
Reemplaza el valor superior por el nombre del registro de la conferencia y el nombre de la transcripción.
Personaliza la paginación
Pasa los siguientes parámetros de consulta para personalizar la paginación de grabaciones, transcripciones y entradas de transcripciones:
pageSize
: Es la cantidad máxima de elementos que se mostrarán. Es posible que el servicio devuelva menos de este valor. Si no se especifica, se devuelven, como máximo, 10 elementos. El valor máximo es 100. Los valores superiores a 100 se cambian automáticamente a 100.pageToken
: Es un token de página, recibido desde una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.
Temas relacionados
- Graba una videoconferencia
- Cómo usar las transcripciones en Google Meet
- Cómo retener datos de Google Meet con Vault
- Cómo personalizar las funciones de Meet como administrador