В этом документе объясняется, как получить подробную информацию о различных элементах совещания, созданных в ходе конференции, с помощью 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 в формате conferenceRecords/{conferenceRecord}/recordings/{recordingName} .
Если название записи вам неизвестно, вы можете перечислить все названия записей, используя метод list .
Метод возвращает экземпляр ресурса recordings .
Приведённый ниже пример кода показывает, как получить доступ к конкретной записи:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/recordings/RECORDING_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените следующее:
- Название записи конференции, содержащее идентификатор конкретной конференции в записи конференции.
- Название записи, содержащее идентификатор конкретной записи в записи конференции.
Перечислите все записи
Чтобы отобразить подробную информацию обо всех записях в записи конференции, используйте метод ` list ресурса recordings . Укажите параметр parent пути в формате conferenceRecords/{conferenceRecord} .
Метод возвращает список записей конференций, упорядоченных по startTime в порядке возрастания, в виде экземпляра ресурса recordings . Чтобы изменить размер страницы, см. раздел «Настройка пагинации» .
Приведённый ниже пример кода показывает, как вывести список всех записей конференции:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/recordings" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените имя родительского элемента на имя конкретного идентификатора конференции в записи о конференции.
Стенограммы
В следующих разделах подробно описано, как получить информацию о стенограммах конференций и включить ее в протокол конференции.
Meet получает доступ к идентификатору стенограммы после того, как данные стенограммы сгенерированы. Возможно, пользователь удалит файл стенограммы из Google Диска, но уникальное имя все равно будет отображаться в Meet.
Ресурс transcripts включает в себя объекты DocsDestination и State .
Объект DocsDestination содержит путь экспорта в Google Диск, где сохраняется файл с расшифровкой документа Google Docs. Чтобы получить содержимое или просмотреть расшифровку в браузере, используйте значение поля exportUri объекта. Если вы знакомы с API Google Docs, значение поля document соответствует documentId в ресурсе documents .
Объект State хранит статус сеанса записи разговора. Это позволяет узнать, начался ли сеанс записи разговора, завершился ли он, но файл записи разговора еще не готов, или же файл записи разговора создан и готов к загрузке.
Получите подробную информацию о стенограмме.
Чтобы получить подробную информацию о конкретной стенограмме, используйте метод ` get ресурса ` transcripts . Задайте параметр пути name в формате conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} .
Если вам неизвестен номер стенограммы, вы можете перечислить все номера стенограмм, используя метод list .
Метод возвращает экземпляр ресурса transcripts .
Приведённый ниже пример кода показывает, как получить конкретную стенограмму:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените следующее:
- Название записи конференции, содержащее идентификатор конкретной конференции в записи конференции.
- Название стенограммы, содержащее идентификатор конкретной стенограммы в записи конференции.
Перечислите все стенограммы.
Чтобы отобразить подробную информацию обо всех стенограммах в записи конференции, используйте метод ` list ресурса transcripts . Укажите параметр parent path` в формате conferenceRecords/{conferenceRecord} .
Метод возвращает список стенограмм конференций, упорядоченных по startTime в порядке возрастания, в виде экземпляра ресурса transcripts . Чтобы изменить размер страницы, см. раздел «Настройка пагинации» .
Приведенный ниже пример кода показывает, как вывести список всех стенограмм в записи конференции:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените имя родительского элемента на имя конкретного идентификатора конференции в записи о конференции.
Записи в стенограмме
В следующих разделах подробно описано, как получить записи о выступлениях каждого участника в виде стенограмм во время сессии, посвященной стенографированию конференции.
Запись в стенограмме содержит расшифрованный текст голоса участника, объемом не более 10 000 слов. languageCode произнесенного текста (например, en-US ) также включен в синтаксис IETF BCP 47 .
Каждая запись в стенограмме связана с именем participant конференции. Чтобы получить подробную информацию об участнике, см. раздел «Получить подробную информацию об участнике» .
Данные, введенные в стенограмму, доступны в течение 30 дней после окончания конференции.
Обратите внимание, что записи в транскрипте, возвращаемые REST API Meet, могут не совпадать с транскриптом, найденным в файле транскрипта Docs. Это происходит, когда файл транскрипта изменяется после его генерации.
Получите подробную информацию о записи в транскрипте.
Чтобы получить подробную информацию о конкретной записи в стенограмме, используйте метод get ресурса ` transcripts.entries . Задайте параметр пути name в формате conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName} .
Если вам неизвестен название записи в выписке, вы можете вывести список всех названий записей в выписке, используя метод list .
Метод возвращает экземпляр ресурса transcripts.entries .
Приведенный ниже пример кода показывает, как получить доступ к конкретной записи в стенограмме:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME/entries/TRANSCRIPT_ENTRY_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените следующее:
- Название записи конференции, содержащее идентификатор конкретной конференции в записи конференции.
- Название стенограммы, содержащее идентификатор конкретной стенограммы в записи конференции.
- Название записи в транскрипте, содержащее идентификатор конкретной записи в транскрипте.
Перечислите все записи в стенограмме.
Чтобы отобразить подробную информацию обо всех записях стенограммы, используйте метод list ресурса ` transcripts.entries . Укажите параметр parent path` в формате conferenceRecords/{conferenceRecord}/transcripts/{transcript} .
Метод возвращает список структурированных записей стенограммы каждой конференции, упорядоченных по startTime в порядке возрастания, в виде экземпляра ресурса transcripts.entries . Чтобы изменить размер страницы, см. раздел «Настройка пагинации» .
Приведённый ниже пример кода показывает, как вывести список всех записей в стенограмме:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените ACCESS_TOKEN на токен доступа, предоставляющий доступ к API.
Замените следующее:
- Имя родительского элемента, содержащее имя конкретного идентификатора конференции в записи о конференции.
- Название стенограммы, содержащее идентификатор конкретной стенограммы в записи конференции.
Умные заметки
В следующих разделах подробно описано, как получить информацию об интеллектуальных заметках конференции в протоколе конференции.
Meet получает доступ к идентификатору интеллектуальной заметки после того, как данные интеллектуальной заметки созданы. Возможно, пользователь удалит файл интеллектуальной заметки из Google Диска, но уникальное имя все равно будет отображаться в Meet.
Ресурс smartNotes включает объект State . Этот объект хранит статус сеанса smartNotes. Это позволяет запрашивать информацию о том, начался ли сеанс smartNotes, завершился ли он, но файл smartNotes еще не готов, или же файл smartNotes создан и готов к загрузке.
Ресурс smartNotes также включает объект типа DocsDestination . Этот объект содержит местоположение в Google Диске, где сохраняется файл смарт-заметок Google Docs. Чтобы получить содержимое или просмотреть смарт-заметки в браузере, используйте значение поля exportUri этого объекта. Если вы знакомы с API Google Docs, значение поля document соответствует documentId в ресурсе documents .
Управлять смарт-заметками можно с помощью методов get и list .
Узнайте больше об умных заметках.
Чтобы получить подробную информацию о конкретном файле SmartNotes, используйте метод get объекта ` smartNotes Укажите путь name файлу в формате conferenceRecords/{conferenceRecord}/smartNotes/{smartNote} .
Если вам неизвестно имя смарт-заметки, вы можете вывести список всех файлов смарт-заметок, используя метод list .
Метод возвращает экземпляр ресурса smartNotes .
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените следующее:
- CONFERENCE_RECORD_NAME : конкретный идентификатор конференции в записи о конференции.
- SMART_NOTES_NAME : конкретный идентификатор интеллектуальной заметки в записи конференции.
- ACCESS_TOKEN : токен доступа, предоставляющий доступ к API.
Перечислите все умные заметки
Чтобы отобразить подробную информацию обо всех файлах смарт-заметок в записи конференции, используйте метод ` list ресурса ` smartNotes . Укажите параметр ` parent в формате conferenceRecords/{conferenceRecord} .
Метод возвращает список файлов интеллектуальных заметок конференции, упорядоченных по startTime в порядке возрастания, в виде экземпляра ресурса smartNotes . Чтобы настроить размер страницы, см. раздел «Настройка пагинации» .
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
Замените следующее:
- PARENT_NAME : конкретный идентификатор конференции в записи о конференции.
- ACCESS_TOKEN : токен доступа, предоставляющий доступ к API.
Настройка пагинации
Передайте следующие параметры запроса, чтобы настроить постраничную навигацию записей, стенограмм и отдельных записей стенограмм:
pageSize: Максимальное количество возвращаемых элементов. Сервис может вернуть меньше этого значения. Если не указано, возвращается не более 10 элементов. Максимальное значение — 100; значения больше 100 автоматически преобразуются в 100.pageToken: Токен страницы, полученный из предыдущего вызова списка. Предоставьте этот токен для получения следующей страницы.