Получение расшифровок и записей собраний с помощью API Graph

Статья
12/20/2024

Теперь вы можете настроить приложение для получения расшифровок и записей собраний Microsoft Teams в сценарии после собрания. Приложение может использовать REST API Microsoft Graph для доступа к расшифровкам и записям, созданным для предварительно запланированного собрания Teams, и получения их.

Ниже приведены некоторые варианты использования для получения расшифровок и записей собраний с помощью API Graph:

Вариант использования	Как API-интерфейсы расшифровки и записи помогают...
Вам необходимо получить расшифровки и записи для сбора значимой информации из нескольких собраний по вертикали продаж. Отслеживание всех собраний и извлечение стенограмм и записей собраний вручную занимает много времени и неэффективно. После завершения собрания необходимо изучить беседы во время всех этих собраний, чтобы получить полезную информацию.	Использование API Graph в приложении для получения расшифровок и записей собраний автоматически извлекает их из всех собраний, соответствующих вашей цели. Ваше приложение может получать уведомления о собраниях, а также получать расшифровку и запись, когда она будет создана после окончания собрания. Затем эти данные можно использовать для получения: • Обобщенной аналитики и интеллектуального анализа • Новых потенциальных клиентов и основных возможностей • Следующих результатов и итогов собраний
В качестве инициативы отдела кадров вы проводите мозговой штурм, чтобы понять и улучшить работоспособность и производительность сотрудников. Необходимость постоянно делать заметки для подведения итогов после собрания может затруднить поток мыслей, и вы можете не уловить все ценные предложения. После сеанса необходимо проанализировать обсуждение, чтобы собрать данные для улучшения планирования.	Использование API Graph в приложении для получения расшифровок и записей после собрания позволяет вам и участникам полностью сосредоточиться на обсуждении. Содержимое расшифровки и записи собрания доступно для: • Анализа вовлеченности и настроений • Перечисления задач или проблем • Дальнейших собраний и уведомлений
Продавец в ведущей технологической компании должен связаться с клиентами и заключать сделки. Благодаря многочисленным собраниям, запланированным с помощью календаря Teams и Outlook, очень важно присутствовать на всех звонках и следить за обсуждениями и последними обновлениями.	Вы можете создать приложение со следующими возможностями: • Уведомлять вас о планировании собрания с помощью Teams или календаря Outlook. • Включите настройку `AutoRecording=true` приложения для этих собраний. • Добавьте бота в качестве участника собрания, чтобы отобразить баннер, указывающий, что собрание записывается и что содержимое будет использоваться приложением для анализа. • Разрешите приложению доступ к записям и расшифровкам собраний. • Разрешите приложение, не требуя утверждения администратором `OnlineMeetingRecording.Read.All` разрешений, так как получение утверждения администратора для этих разрешений может занять много времени. Ниже приведен пример приложения , демонстрирующего этот сценарий использования.

Вы можете получить расшифровку собрания, запись или и то, и другое с помощью API Graph.

Примечание.

API для получения расшифровки и записи содержимого собрания являются лимитными API. Дополнительные сведения см. в статье Модели оплаты для API-интерфейсов собраний.

Чтобы получить расшифровку и запись для определенного собрания, выполните следующие действия:

Настройка разрешений для Microsoft Entra ID для доступа к расшифровкам и записи

Приложение должно иметь необходимые разрешения для получения расшифровок и записей. Он может получать доступ к расшифровкам и записям для собрания Teams, используя разрешения приложений для всей организации или разрешения приложения для конкретного собрания для конкретного собрания (RSC).

Использование разрешений приложения для всей организации

Вы можете настроить приложение для доступа к расшифровкам и записям собраний в клиенте. В этом случае организатору собрания не нужно устанавливать приложение в чате собрания Teams. Когда администратор авторизует разрешения приложений для всей организации, приложение может считывать и получать доступ к расшифровкам и записям для всех собраний в клиенте.

Дополнительные сведения о разрешениях приложений для всей организации, которые могут быть предоставлены вашему приложению, см. в разделе Разрешения на собрания по сети.

Использование разрешений приложений RSC для определенных собраний

Если вы хотите, чтобы приложение извлекает расшифровки и записи только для собрания Teams, на котором оно установлено, настройте разрешение RSC для конкретного собрания для вашего приложения. Авторизованные пользователи могут установить ваше приложение в чате собрания. После завершения собрания приложение может выполнить вызов API, чтобы получить расшифровку и запись для этого собрания.

Дополнительные сведения о разрешениях RSC для собраний см. в разделе Разрешения RSC для чата или собрания.

Получать уведомления о доступности расшифровки или записи

Настроив разрешения, настройте приложение на получение уведомлений об изменениях для расшифровок и записей доступных событий или всех соответствующих событий собраний. Уведомления содержат идентификатор собрания и идентификатор организатора, которые помогают получить доступ к содержимому расшифровки и записи. Приложение может получить расшифровку и запись для собрания, когда оно будет создано после его окончания. Содержимое расшифровки доступно в виде .vtt файла. Запись собрания доступна в виде .mp4 файла.

Для приложения можно использовать следующие типы уведомлений об изменениях:

Область подписки	Описание	Поддерживаемые пути к ресурсам
Уровень клиента	Стенограмма или запись доступна для любого собрания по сети для клиента.	• Все расшифровки в организации: `communications/onlineMeetings/getAllTranscripts` • Все записи в организации: `communications/onlineMeetings/getAllRecordings`
Уровень собрания	Стенограмма или запись доступна для определенного собрания по сети.	• Все расшифровки для определенного собрания: `communications/onlineMeetings/{onlineMeetingId}/transcripts` • Все записи для определенного собрания: `communications/onlineMeetings/{onlineMeetingId}/recordings`
Область действия пользователя	Стенограмма или запись доступна для любого онлайн-собрания, организованного конкретным пользователем.	• Расшифровка звонка, которая становится доступной на собрании, организованном определенным пользователем: `users/{userId}/onlineMeetings/getAllTranscripts` • Запись звонка, которая становится доступной на собрании, организованном определенным пользователем: `users/{userId}/onlineMeetings/getAllRecordings`
Область приложения	Стенограмма или запись доступна для любого собрания, на котором установлено определенное приложение teams.	• Расшифровка звонка, которая становится доступной на собрании, где установлено определенное приложение Teams: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts` • Запись звонка, которая становится доступной на собрании, где установлено определенное приложение Teams: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings`

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

Дополнительные сведения о том, как приложение может узнать о завершении собраний, см. в статье Подписка на уведомления об изменениях и использование Bot Framework для получения идентификатора собрания и идентификатора организатора.

Примечание.

Процесс вызова API Graph для доступа и извлечения расшифровок и записей остается неизменным как для разрешений приложений RSC для собраний, так и для разрешений приложений для всей организации. Эти API поддерживают только запланированные собрания.

Следующее действие

Получать уведомления о доступности расшифровок и записей собраний

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