Использование API Graph для получения расшифровки

Статья
04/04/2023

Используйте REST API Graph для получения расшифровки определенного собрания. Приложение получает расшифровки на основе ИД пользователя организатора собрания и ИД собрания.

Для получения расшифровок используются следующие API:

Список callTranscripts
Получение callTranscript
Получение содержимого callTranscript

Список callTranscripts

Этот API используется для получения списка всех объектов callTranscript на основе ИД пользователя и ИД собрания. Он возвращает метаданные расшифровки собрания, которые содержат ИД расшифровки, а также дату и время ее создания.

HTTP-запрос

GET /me/onlineMeetings('{meetingId}')/transcripts
GET /users('{userId}')/onlineMeetings('{meetingId}')/transcripts

Необязательные параметры запросов

Метод поддерживает $skipTokenпараметры запроса OData и $top для настройки ответа.

Поддерживаемые шаблоны запросов

Шаблон	Поддерживается	Синтаксис	Примечания
Разбивка на страницы на стороне сервера	✓	`@odata.nextLink`	Получите маркер продолжения в ответе, если набор результатов охватывает несколько страниц.
Ограничение страницы	✓	`/transcripts?$top=20`	Получите расшифровки с размером страницы 20. Ограничение страницы по умолчанию — 10. Максимальное ограничение страницы — 100.

Заголовки запросов

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и коллекцию объектов callTranscript в теле отклика.

Пример. Список callTranscript

Запрос

GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts

Отклик

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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"
        }        
    ]
}

Получение callTranscript

Приложение анализирует список ИД расшифровок, полученных в качестве ответа API List callTranscripts, чтобы получить необходимый ИД расшифровки. Этот API используется для получения метаданных единой расшифровки на основе ИД пользователя, ИД собрания и ИД расшифровки.

HTTP-запрос

GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')

Заголовки запросов

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвратит код отклика 200 OK и объект callTranscript в теле отклика.

Пример. Получение callTranscript

Запрос

GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4

Отклик

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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"
}

Получение содержимого callTranscript

Этот API используется для получения расшифровки выбранного ИД расшифровки, полученного в ответе API Get callTranscript. Он возвращает содержимое расшифровки.

HTTP-запрос

GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content

Необязательные параметры запросов

Этот метод поддерживает $formatпараметр запроса OData , который позволяет настраивать ответ.

Поддерживаемые типы форматов: text/vtt для vtt ИЛИ application/vnd.openxmlformats-officedocument.wordprocessingml.document для формата docx.

Заголовки запросов

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно.
Accept	text/vtt OR application/vnd.openxmlformats-officedocument.wordprocessingml.document. Необязательный параметр.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает 200 OK код отклика и содержит байты для объекта callTranscript в тексте отклика. Заголовок content-type указывает тип содержимого расшифровки.

Примеры

Пример. Получение содержимого callTranscript

Запрос

GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content

Отклик

Отклик содержит байты для расшифровки в тексте сообщения. Заголовок content-type указывает тип содержимого расшифровки.

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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>

Пример. Получение содержимого callTranscript, указывающего $format параметр запроса

Запрос

GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt

Отклик

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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>

Пример. Получение содержимого callTranscript с указанием заголовка Accept

Запрос

GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Отклик

Отклик содержит байты для расшифровки в тексте сообщения. Заголовок content-Type указывает тип содержимого расшифровки.

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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.

Пример. Получение содержимого callTranscript с $format получения приоритета над заголовком accept

Запрос

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

Отклик

Примечание.

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.

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>

Поделиться через

Использование API Graph для получения расшифровки

Список callTranscripts

Получение callTranscript

Получение содержимого callTranscript

Дополнительные ресурсы