En esta guía, se explica cómo obtener detalles sobre los diferentes artefactos de reuniones 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 de forma independiente 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 de usuario permiten que las apps de Google Meet accedan a los datos del usuario y realicen operaciones en nombre del usuario autenticado. La autenticación con la delegación en todo el dominio te permite autorizar la cuenta de servicio de una aplicación para que acceda a los datos de tus usuarios sin necesidad de que cada usuario dé su consentimiento.
Retención de artefactos
Después de que 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 conservan 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 finaliza la conferencia.
También puedes administrar la retención de los artefactos de Meet por separado con reglas de retención específicas de Meet en Google Vault. Para obtener más información, consulta Cómo conservar 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 la 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 que el nombre único siga apareciendo 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 a 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 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 de acceso name
. Si no conoces el nombre de la grabación, puedes listar todos los nombres de las grabaciones con el método list()
.
El método devuelve una instancia de un recurso recordings
.
En la siguiente muestra de código, se indica cómo recuperar una grabación específica:
Java
Node.js
Python
Reemplaza el nombre de la grabación por el ID de grabación específico en un registro de conferencia.
Cómo ver todas las grabaciones
Para enumerar los detalles de todas las grabaciones en un registro de conferencia, usa el método list()
en el recurso recordings
con el parámetro de ruta de acceso parent
. Formato:
conferenceRecords/{conferenceRecord}
.
El método devuelve 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 el siguiente ejemplo de código, se muestra cómo enumerar todas las grabaciones en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor principal 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 conferencias.
Meet tiene acceso al ID de la 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 que el nombre único siga apareciendo 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 navegar por la transcripción en un navegador, usa el valor del campo exportUri
del objeto. Si conoces la API de Google Docs, 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 se inició la sesión de transcripción, si finalizó, pero el archivo de transcripción no está listo, o si se generó el archivo de transcripción 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 de acceso name
. Si no conoces el nombre de la transcripción, puedes listar todos los nombres de transcripciones con el método list()
.
El método devuelve una instancia de un recurso transcripts
.
En el siguiente ejemplo 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 ID de la transcripción específica en un registro de conferencia.
Enumera todas las transcripciones
Para enumerar los detalles de todas las transcripciones en un registro de conferencia, usa el método list()
en el recurso transcripts
con el parámetro de ruta de acceso parent
. Formato:
conferenceRecords/{conferenceRecord}
.
El método devuelve 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 el siguiente ejemplo de código, se muestra cómo enumerar todas las transcripciones en un registro de conferencia:
Java
Node.js
Python
Reemplaza el valor principal 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 conferencia.
La entrada de la 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 la transcripción está conectada a un nombre de participant
en la conferencia. Para recuperar los detalles de un participante, 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 devuelve la API de REST de Meet podrían no coincidir con la transcripción que se encuentra en el archivo de transcripción de Documentos. Esto ocurre cuando el archivo de transcripción se modifica después de su 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 de acceso name
. Si no conoces el nombre de la entrada de la transcripción, puedes listar todos los nombres de transcripciones con el método list()
.
El método devuelve 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 la transcripción por el ID de entrada de la transcripción específico en una transcripción.
Enumera todas las entradas de la 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 de acceso parent
. Formato:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
El método devuelve 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 la transcripción:
Java
Node.js
Python
Reemplaza el valor principal por el nombre del registro de la conferencia y el nombre de la transcripción.
Cómo personalizar la paginación
Pasa los siguientes parámetros de búsqueda para personalizar la paginación de las grabaciones, las transcripciones y las entradas de transcripciones:
pageSize
: Es la cantidad máxima de elementos que se devolverán. El servicio puede devolver menos que este valor. Si no se especifica, se devolverán, como máximo, 10 elementos. El valor máximo es 100, y los valores superiores a 100 se cambian automáticamente a 100.pageToken
: Es un token de página, recibido de una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.
Temas relacionados
- Graba una videoconferencia
- Usa las transcripciones en Google Meet
- Cómo retener datos de Google Meet con Vault
- Personaliza las funciones de Meet como administrador