Usar APIs do Graph para buscar a transcrição
Use as APIs REST do Graph para obter transcrições de uma reunião específica. Seu aplicativo busca as transcrições com base na ID de usuário do organizador da reunião e na ID da reunião.
As seguintes APIs são usadas para buscar transcrições:
Listar callTranscripts
Essa API é usada para obter uma lista de todos os objetos callTranscript com base na ID de usuário e na ID da reunião. Ela retorna os metadados das transcrições da reunião, que contém a ID da transcrição e a data e hora de criação dessa transcrição.
Solicitação HTTP
GET /me/onlineMeetings('{meetingId}')/transcripts
GET /users('{userId}')/onlineMeetings('{meetingId}')/transcripts
Parâmetros de consulta opcionais
O método suporta os $skipTokenparâmetros de consulta OData e $top para ajudar a personalizar a resposta.
Padrões de consulta com suporte
| Padrão | Compatível | Sintaxe | Observações |
|---|---|---|---|
| Paginação do lado do servidor | ✓ | @odata.nextLink |
Obtenha um token de continuação na resposta, quando um conjunto de resultados abrange várias páginas. |
| Limite de página | ✓ | /transcripts?$top=20 |
Obter transcrições com tamanho de página 20. O limite de página padrão é 10. O limite máximo de páginas é 100. |
Cabeçalhos da Solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Response
Se bem-sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos callTranscript no corpo da resposta.
Exemplo: Lista de callTranscript
Solicitação
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts
Response
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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"
}
]
}
Obter callTranscript
Seu aplicativo analisa a lista de IDs de transcrição, recebidas como a resposta da API List callTranscripts, para obter a ID de transcrição necessária. Essa API é usada para obter um único metadados de transcrição com base na ID de usuário, na ID da reunião e na ID da transcrição.
Solicitação HTTP
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
Cabeçalhos da Solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Response
Se bem-sucedido, este método retorna um código de resposta 200 OK e o objeto callTranscript no corpo da resposta.
Exemplo: Obter uma chamadaTranscript
Solicitação
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4
Response
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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"
}
Obter conteúdo callTranscript
Essa API é usada para obter a transcrição da ID de transcrição selecionada que foi obtida na resposta da API Get callTranscript. Ela retorna o conteúdo da transcrição.
Solicitação HTTP
GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
Parâmetros de consulta opcionais
Este método suporta o $formatparâmetro de consulta OData que permite a personalização da resposta.
Os tipos de formato com suporte são text/vtt para vtt OU application/vnd.openxmlformats-officedocument.wordprocessingml.document para o formato docx.
Cabeçalhos da Solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. |
| Aceitar | text/vtt OR application/vnd.openxmlformats-officedocument.wordprocessingml.document. Opcional. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Response
Se bem-sucedido, este método retorna um código de resposta 200 OK e contém bytes para o objeto callTranscript no corpo da resposta. O cabeçalho content-type especifica o tipo do conteúdo da transcrição.
Exemplos
Exemplo: Obter um conteúdo callTranscript
Solicitação
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Response
A resposta contém bytes para a transcrição no corpo. O cabeçalho content-type especifica o tipo do conteúdo da transcrição.
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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>
Exemplo: Obter um conteúdo callTranscript que especifique $format parâmetro de consulta
Solicitação
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Response
A resposta contém bytes para a transcrição no corpo. O cabeçalho content-type especifica o tipo do conteúdo da transcrição.
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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>
Exemplo: Obter um conteúdo callTranscript a especificar o cabeçalho Accept
Solicitação
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Response
A resposta contém bytes para a transcrição no corpo. O cabeçalho content-Type especifica o tipo do conteúdo da transcrição.
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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.
Exemplo: Obter um conteúdo callTranscript com $format obter precedência sobre o cabeçalho de aceitação
Solicitação
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
Response
A resposta contém bytes para a transcrição no corpo. O cabeçalho content-Type especifica o tipo do conteúdo da transcrição.
Observação
O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.
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>