Usar las API de Graph para capturar transcripciones
Use las API de REST de Graph para obtener transcripciones de una reunión determinada. La aplicación captura las transcripciones en función del id. de usuario del organizador de la reunión y del id. de la reunión.
Para capturar transcripciones se usan las siguientes API:
List callTranscripts
Esta API se usa para obtener una lista de todos los objetos de callTranscript según el id. de usuario y el id. de reunión. Devuelve los metadatos de las transcripciones de la reunión, que contienen el id de transcripción y la fecha y hora de creación de dicha transcripción.
Solicitud HTTP
GET /me/onlineMeetings('{meetingId}')/transcripts
GET /users('{userId}')/onlineMeetings('{meetingId}')/transcripts
Parámetros de consulta opcionales
El método admite los $skipTokenparámetros de consulta y $top OData para ayudar a personalizar la respuesta.
Patrones de consulta admitidos
| Patrón | Compatible | Sintaxis | Notas |
|---|---|---|---|
| Paginación del lado servidor | ✓ | @odata.nextLink |
Obtener un token de continuación en la respuesta, cuando un conjunto de resultados abarca varias páginas. |
| Límite de página | ✓ | /transcripts?$top=20 |
Obtener transcripciones con tamaño de página en 20. El límite de página predeterminado es de 10. El límite máximo de páginas es de 100. |
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. |
Cuerpo de solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos callTranscript en el cuerpo de la respuesta.
Ejemplo: Lista de callTranscript
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts
Respuesta
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts",
"@odata.count": 3,
"@odata.nextLink": "https://graph.microsoft.com/beta/users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts?$skiptoken=MSMjMCMjMjAyMS0wOS0xNlQxMzo1OToyNy4xMjEwMzgzWg%3d%3d",
"value": [
{
"id": "MSMjMCMjZDAwYWU3NjUtNmM2Yi00NjQxLTgwMWQtMTkzMmFmMjEzNzdh",
"createdDateTime": "2021-09-17T06:09:24.8968037Z"
},
{
"id": "MSMjMCMjMzAxNjNhYTctNWRmZi00MjM3LTg5MGQtNWJhYWZjZTZhNWYw",
"createdDateTime": "2021-09-16T18:58:58.6760692Z"
},
{
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"createdDateTime": "2021-09-16T18:56:00.9038309Z"
}
]
}
Get callTranscript
La aplicación analiza la lista de identificadores de transcripción que se han recibido como respuesta de la API List callTranscripts para obtener el id. de transcripción necesario. Esta API se usa para obtener metadatos de transcripción únicos basados en el id. de usuario, el id. de reunión y el id. de transcripción.
Solicitud HTTP
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. |
Cuerpo de solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto callTranscript en el cuerpo de la respuesta.
Ejemplo: Obtener una llamadaTranscript
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4
Respuesta
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/$entity",
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
"createdDateTime": "2021-09-17T06:09:24.8968037Z"
}
Get callTranscript content
Esta API se usa para obtener la transcripción del id. de transcripción seleccionado que se obtuvo en la respuesta de la API Get callTranscript. Devuelve el contenido de la transcripción.
Solicitud HTTP
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
Parámetros de consulta opcionales
Este método admite el parámetro de $formatconsulta OData que permite la personalización de la respuesta.
Los tipos de formato admitidos son text/vtt para vtt o application/vnd.openxmlformats-officedocument.wordprocessingml.document para el formato docx.
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. |
| Aceptar | text/vtt OR application/vnd.openxmlformats-officedocument.wordprocessingml.document. Opcional. |
Cuerpo de solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y contiene bytes para el objeto callTranscript en el cuerpo de la respuesta. El encabezado content-type especifica el tipo de contenido de la transcripción.
Ejemplos
Ejemplo: Obtención de un contenido callTranscript
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Respuesta
La respuesta contiene bytes para la transcripción en el cuerpo. El encabezado content-type especifica el tipo de contenido de la transcripción.
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Ejemplo: Obtención de un contenido callTranscript que especifica $format parámetro de consulta
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Respuesta
La respuesta contiene bytes para la transcripción en el cuerpo. El encabezado content-type especifica el tipo de contenido de la transcripción.
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>
Ejemplo: Obtención de un contenido callTranscript que especifica el encabezado Accept
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Respuesta
La respuesta contiene bytes para la transcripción en el cuerpo. El encabezado content-Type especifica el tipo de contenido de la transcripción.
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
0:0:0.0 --> 0:0:5.320
User Name
This is a transcript test.
Ejemplo: Obtener un contenido callTranscript con $format obtener prioridad sobre el encabezado accept
Solicitud
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Respuesta
La respuesta contiene bytes para la transcripción en el cuerpo. El encabezado content-Type especifica el tipo de contenido de la transcripción.
Nota:
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: text/vtt
WEBVTT
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>