本文档介绍了如何使用 Google Meet REST API 获取有关会议生成的不同会议制品的信息。
制品是指 Google Meet 针对 会议生成的文件或数据 。其中包括视频录制内容和其他制品,例如转录内容。
如需生成制品,参与者必须在会议结束前在 Meet 中配置制品。如需了解详情,请参阅管理自动 制品。
转录内容独立于录制内容运行,您无需录制会议即可生成转录内容。所有参与者都退出会议后,转录内容会自动停止。如需了解详情,请参阅录制视频 会议和将转录内容 与 Google Meet 搭配使用。
检索制品
如果您是会议室所有者或参与者,可以对 recordings、transcripts、transcripts.entries 和
smart notes 资源调用 get 和
list 方法来检索制品。如需了解详情,请参阅以下部分。
通过 用户 凭据 进行身份验证和授权,可让 Meet 应用访问用户数据并代表 经过身份验证的用户执行操作。通过网域范围内的 委托 进行身份验证,可让您授权应用的服务账号访问用户的数据 而无需经过每位用户的同意。
制品保留
会议结束后,Meet 会将录制内容和转录内容保存到会议组织者的 Google 云端硬盘。默认情况下,Meet 制品会根据云端硬盘规则保留。
会议结束后 30 天,Meet REST API 提供的转录内容条目将被删除。
您还可以使用 Google 保险柜 中的 Meet 专用保留规则,单独管理 Meet 数据制品 的保留情况。如需了解 详情,请参阅使用 保险柜保留 Google Meet 数据。
录制内容
以下部分详细介绍了如何在会议记录中获取有关录制内容的信息。
生成录制文件后,Meet 即可访问录制 ID。用户可能会从 Google 云端硬盘中删除录制文件,但 Meet 中仍会返回唯一名称。
recordings
资源包含
DriveDestination
和
State
对象。
DriveDestination 对象包含录制内容在云端硬盘中的导出位置,录制内容会以 MP4 文件形式保存在该位置。如需下载录制内容或在
浏览器中播放录制内容,请使用该对象的
exportUri
字段值。如果您熟悉 Google Drive API,则
file
字段值对应于
id字段在
files资源中。如需了解详情,请参阅下载和导出文件。
State 对象包含录制会话的状态。借助此对象,您可以查询录制是否已开始、录制是否已结束但录制文件尚未准备就绪,或者录制文件是否已生成并可供下载。
获取有关录制内容的详细信息
如需获取有关特定录制内容的详细信息,请对
recordings
资源使用
get
方法。使用 conferenceRecords/{conferenceRecord}/recordings/{recordingName} 格式设置 name 路径参数。
如果您不知道录制名称,可以使用 列出所有录制
名称 方法。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 访问权限的访问令牌。
替换以下内容:
- 会议记录名称,替换为会议记录中特定视频会议 ID 的名称。
- 录制名称,替换为会议记录中特定录制 ID 的名称。
列出所有录制内容
如需列出会议记录中所有录制内容的详细信息,请对
recordings
资源使用
list
方法。使用 conferenceRecords/{conferenceRecord} 格式设置 parent 路径参数。
该方法会返回会议录制内容列表(按 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 访问权限的访问令牌。
将父级名称替换为会议记录中特定视频会议 ID 的名称。
转录内容
以下部分详细介绍了如何在会议记录中获取有关会议转录内容的信息。
生成转录数据后,Meet 即可访问转录 ID。用户可能会从云端硬盘中删除转录文件,但 Meet 中仍会返回唯一名称。
资源包含和对象。transcriptsDocsDestinationState
DocsDestination 对象包含 Google 文档转录文件在云端硬盘中的导出位置。如需提取内容或在
浏览器中浏览转录内容,请使用该对象的
exportUri
字段值。如果您熟悉 Google Docs API,则
document
字段值对应于
documentId
在 documents 资源中。
State 对象包含转录会话的状态。借助此对象,您可以查询转录会话是否已开始、转录会话是否已结束但转录文件尚未准备就绪,或者转录文件是否已生成并可供下载。
获取有关转录内容的详细信息
如需获取有关特定转录内容的详细信息,请对
transcripts
资源使用
get
方法。使用 conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} 格式设置 name 路径参数。
如果您不知道转录名称,可以使用 列出所有转录
名称 方法。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 访问权限的访问令牌。
替换以下内容:
- 会议记录名称,替换为会议记录中特定视频会议 ID 的名称。
- 转录名称,替换为会议记录中特定转录 ID 的名称。
列出所有转录内容
如需列出会议记录中所有转录内容的详细信息,请对
transcripts
资源使用
list
方法。使用 conferenceRecords/{conferenceRecord} 格式设置 parent 路径参数。
该方法会返回会议转录内容列表(按 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 访问权限的访问令牌。
将父级名称替换为会议记录中特定视频会议 ID 的名称。
转录内容条目
以下部分详细介绍了如何在会议转录会话期间获取每位参与者的发言,作为转录内容条目。
转录内容条目包含参与者语音的转录文本,最多 10,000 字。口语文本 languageCode(例如 en-US)
也以 IETF BCP 47 语法形式包含在内。
每个转录内容条目都与会议中的 participant 名称相关联。如需
检索参与者详细信息,请参阅获取有关
参与者的详细信息。
会议结束后 30 天内,转录内容条目数据可用。
请注意,Meet REST API 返回的转录内容条目可能与 Google 文档转录文件中找到的转录内容不一致。如果转录文件在生成后经过修改,就会发生这种情况。
获取有关转录内容条目的详细信息
如需获取有关特定转录内容条目的详细信息,请对
transcripts.entries
资源使用
get
方法。使用 conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName} 格式设置 name 路径参数。
如果您不知道转录内容条目名称,可以使用 列出所有转录内容
名称 方法。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 访问权限的访问令牌。
替换以下内容:
- 会议记录名称,替换为会议记录中特定视频会议 ID 的名称。
- 转录名称,替换为会议记录中特定转录 ID 的名称。
- 转录内容条目名称,替换为转录内容中特定转录内容条目 ID 的名称。
列出所有转录内容条目
如需列出转录内容中所有转录内容条目的详细信息,请对
transcripts.entries
资源使用
list
方法。使用 conferenceRecords/{conferenceRecord}/transcripts/{transcript} 格式设置 parent 路径参数。
该方法会返回每个会议转录内容的结构化转录内容条目列表(按 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 访问权限的访问令牌。
替换以下内容:
- 父级名称,替换为会议记录中特定视频会议 ID 的名称。
- 转录名称,替换为会议记录中特定转录 ID 的名称。
智能会议记录
以下部分详细介绍了如何在会议记录中获取有关会议智能会议记录的信息。
生成智能会议记录数据后,Meet 即可访问智能会议记录 ID。用户可能会从云端硬盘中删除智能会议记录文件,但 Meet 中仍会返回唯一名称。
smartNotes 资源
包含 State 对象。
此对象包含智能会议记录会话的状态。借助此对象,您可以查询智能会议记录会话是否已开始、智能会议记录会话是否已结束但智能会议记录文件尚未准备就绪,或者智能会议记录文件是否已生成并可供下载。
smartNotes 资源还包含
DocsDestination 对象
类型。此对象包含 Google 文档智能会议记录文件在云端硬盘中的导出位置。如需提取内容或在浏览器中浏览
智能会议记录,请使用该对象的
exportUri
字段值。如果您熟悉 Google Docs API,则
document 字段值
对应于
documentId
在 documents 资源中。
获取有关智能会议记录的详细信息
如需获取有关特定智能会议记录文件的详细信息,请对
get
使用
方法。使用 name 路径参数,格式为
conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}。smartNotes
如果您不知道智能会议记录名称,可以使用 列出所有智能会议记录
文件 方法。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:会议记录中特定视频会议 ID 的名称。
- SMART_NOTES_NAME:会议记录中特定智能会议记录 ID 的名称。
- ACCESS_TOKEN:授予 API 访问权限的访问令牌。
列出所有智能会议记录
如需列出会议记录中所有智能会议记录文件的详细信息,请对
list
资源使用
smartNotes
方法。使用 conferenceRecords/{conferenceRecord} 格式设置 parent 路径参数。
该方法会返回会议智能会议记录文件列表(按 startTime 升序排列),作为 smartNotes 资源的实例。如需
调整页面大小,请参阅自定义分页 。
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
替换以下内容:
- PARENT_NAME:会议记录中特定视频会议 ID 的名称。
- ACCESS_TOKEN:授予 API 访问权限的访问令牌。
自定义分页
传递以下查询参数,以自定义录制内容、转录内容和转录内容条目的分页:
pageSize:要返回的最大项数。服务返回的值可能小于此值。如果未指定,则系统最多返回 10 项。最大值为 100;大于 100 的值会自动更改为 100。pageToken:从之前的列表调用接收的页面令牌。提供此令牌可检索后续页面。