В этом руководстве объясняется, как получить подробную информацию о различных артефактах встречи, созданных конференцией, с помощью API Google Meet REST.
Артефакт — это файл или данные, созданные Google Meet в ответ на конференцию . К ним относятся видео и другие артефакты, например, стенограммы.
Чтобы создать артефакты, участники должны сгенерировать их в Meet до окончания конференции. Стенограммы работают независимо от записей, и для их создания не требуется записывать встречу. Подробнее см. в разделах «Запись видеоконференции» и «Использование стенограмм в Google Meet» .
Если вы являетесь владельцем или участником помещения для проведения собраний, вы можете вызвать методы get()
и list()
для ресурсов recordings
, transcripts
и transcripts.entries
для извлечения артефактов.
Аутентификация и авторизация с использованием учётных данных пользователя позволяют приложениям Google Meet получать доступ к данным пользователя и выполнять операции от его имени. Аутентификация с делегированием на уровне домена позволяет предоставить сервисной учётной записи приложения доступ к данным ваших пользователей, не требуя согласия каждого пользователя.
Сохранение артефактов
После завершения конференции Meet сохраняет записи и расшифровки на Google Диске организатора встречи. По умолчанию артефакты Meet сохраняются в соответствии с правилами Диска.
Записи стенограмм, предоставленные API Meet REST, удаляются через 30 дней после окончания конференции.
Вы также можете управлять хранением артефактов Meet отдельно, используя специальные правила хранения Meet в Google Vault. Подробнее см. в статье «Хранение данных Google Meet в Vault» .
Записи
В следующих разделах подробно описано, как получить информацию о записях в протоколе конференции.
Meet получает доступ к идентификатору записи после её создания. Пользователь может удалить файл записи из Google Диска, но уникальное имя всё равно будет возвращено в Meet.
Ресурс recordings
включает в себя объекты DriveDestination
и State
.
Объект DriveDestination
содержит папку на Диске, где запись сохраняется в формате MP4. Чтобы загрузить запись или воспроизвести её в браузере, используйте значение поля exportUri
объекта. Если вы знакомы с API Google Диска, значение поля file
соответствует id
в ресурсе files
. Подробнее см. в разделе Загрузка и экспорт файлов .
Объект State
хранит состояние сеанса записи. Это позволяет узнать, началась ли запись, закончилась ли она, но файл записи ещё не готов, или создан ли файл записи и готов ли он к загрузке.
Получить подробную информацию о записи
Чтобы получить подробную информацию о конкретной записи, используйте метод get()
ресурса recordings
с параметром name
path. Если вы не знаете название записи, вы можете получить список всех названий записей с помощью метода list()
.
Метод возвращает экземпляр ресурса recordings
.
В следующем примере кода показано, как получить определенную запись:
Ява
Node.js
Питон
Замените имя записи на имя конкретного идентификатора записи в записи конференции.
Список всех записей
Чтобы вывести список всех записей в записи конференции, используйте метод list()
ресурса recordings
с параметром parent
пути. Формат: conferenceRecords/{conferenceRecord}
.
Метод возвращает список записей конференций, упорядоченный по startTime
в порядке возрастания, как экземпляр ресурса recordings
. Чтобы настроить размер страницы, см. раздел Настройка пагинации .
В следующем примере кода показано, как составить список всех записей в записи конференции:
Ява
Node.js
Питон
Замените родительское значение именем записи конференции.
Транскрипты
В следующих разделах подробно описано, как получить информацию о стенограммах конференций в записях конференций.
Meet получает доступ к идентификатору расшифровки после её создания. Пользователь может удалить файл расшифровки с Диска, но уникальное имя всё равно будет возвращено в Meet.
Ресурс transcripts
включает в себя объекты DocsDestination
и State
.
Объект DocsDestination
содержит папку на Диске, где сохраняется файл расшифровки Google Docs. Чтобы получить содержимое или просмотреть расшифровку в браузере, используйте значение поля exportUri
этого объекта. Если вы знакомы с API Google Docs, значение поля document
соответствует documentId
в ресурсе documents
.
Объект State
хранит состояние сеанса расшифровки. Это позволяет узнать, начался ли сеанс расшифровки, завершился ли сеанс расшифровки, но файл расшифровки ещё не готов, или создан ли файл расшифровки и готов ли он к загрузке.
Получить подробную информацию о транскрипте
Чтобы получить подробную информацию о конкретной расшифровке, используйте метод get()
ресурса transcripts
с параметром name
path. Если вы не знаете название расшифровки, вы можете получить список всех названий расшифровок с помощью метода list()
.
Метод возвращает экземпляр ресурса transcripts
.
В следующем примере кода показано, как получить конкретную расшифровку:
Ява
Node.js
Питон
Замените имя транскрипта на имя конкретного идентификатора транскрипта в записи конференции.
Список всех транскриптов
Чтобы вывести список всех стенограмм в записи конференции, используйте метод list()
ресурса transcripts
с параметром parent
пути. Формат: conferenceRecords/{conferenceRecord}
.
Метод возвращает список стенограмм конференций, упорядоченных по startTime
в порядке возрастания, как экземпляр ресурса transcripts
. Чтобы настроить размер страницы, см. раздел Настройка пагинации .
В следующем примере кода показано, как составить список всех стенограмм в записи конференции:
Ява
Node.js
Питон
Замените родительское значение именем записи конференции.
Стенограммы записей
В следующих разделах подробно описано, как получить записи стенограммы выступления каждого участника во время сеанса стенограммы конференции.
Запись стенограммы содержит транскрибированный текст голоса участника, объёмом до 10 000 слов. languageCode
устного текста (например, en-US
) также указан в синтаксисе IETF BCP 47 .
Каждая запись в стенограмме связана с именем participant
конференции. Чтобы получить информацию об участнике, см. раздел «Получение информации об участнике» .
Данные стенограммы выступления доступны в течение 30 дней после окончания конференции.
Обратите внимание, что записи расшифровки, возвращаемые REST API Meet, могут не совпадать с расшифровкой, найденной в файле расшифровки Docs. Это происходит, когда файл расшифровки изменяется после его создания.
Получить подробную информацию о записи транскрипта
Чтобы получить подробную информацию о конкретной записи транскрипта, используйте метод get()
ресурса transcripts.entries
с параметром name
path. Если вы не знаете имя записи транскрипта, вы можете получить список всех имён транскриптов с помощью метода list()
.
Метод возвращает экземпляр ресурса transcripts.entries
.
В следующем примере кода показано, как получить конкретную запись транскрипта:
Ява
Node.js
Питон
Замените имя записи транскрипта на имя конкретного идентификатора записи транскрипта в транскрипте.
Список всех записей стенограммы
Чтобы получить список сведений обо всех записях транскрипта, используйте метод list()
ресурса transcripts.entries
с параметром parent
пути. Формат: conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Метод возвращает список структурированных записей транскриптов для каждой транскрипты конференции, упорядоченный по startTime
в порядке возрастания, как экземпляр ресурса transcripts.entries
. Чтобы настроить размер страницы, см. раздел Настройка пагинации .
В следующем примере кода показано, как составить список всех записей в транскрипте:
Ява
Node.js
Питон
Замените родительское значение именем записи конференции и именем стенограммы.
Настроить пагинацию
Передайте следующие параметры запроса для настройки пагинации записей, стенограмм и записей стенограмм:
pageSize
: Максимальное количество возвращаемых элементов. Сервис может вернуть меньше этого значения. Если не указано, возвращается не более 10 элементов. Максимальное значение — 100; значения больше 100 автоматически изменяются на 100.pageToken
: токен страницы, полученный при предыдущем вызове списка. Укажите этот токен для получения следующей страницы.
Похожие темы
- Запишите видеовстречу
- Используйте стенограммы с Google Meet
- Сохраните данные Google Meet с помощью Vault
- Настройте функции Meet как администратор