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