本指南介绍了如何使用 Google Meet REST API 获取有关会议生成的不同会议工件详细信息。
工件是指 Google Meet 为响应会议而生成的文件或数据。这包括视频和其他工件,例如转写内容。
如需生成工件,参与者必须在会议结束前在 Meet 中生成工件。转写功能与录制内容无关,您无需录制会议即可生成转写内容。如需了解详情,请参阅录制视频会议和在 Google Meet 中使用转写功能。
如果您是会议室所有者或参与者,则可以对 recordings
、transcripts
和 transcripts.entries
资源调用 get()
和 list()
方法来检索工件。
使用用户凭据进行身份验证和授权后,Google Meet 应用便可访问用户数据,并代表已通过身份验证的用户执行操作。通过全网域授权进行身份验证后,您可以授权应用的服务账号访问用户的数据,而无需经过每位用户的同意。
工件保留
会议结束后,Meet 会将录制内容和转写内容保存到会议组织者的 Google 云端硬盘中。默认情况下,系统会根据云端硬盘规则来保留 Meet 工件。
Meet REST API 提供的转写条目会在会议结束 30 天后删除。
您还可以在 Google 保险柜中使用 Meet 专用的保留规则,单独管理 Meet 工件保留事宜。如需了解详情,请参阅使用保险柜保留 Google Meet 数据。
录音内容
以下部分详细介绍了如何获取会议记录中的录音相关信息。
在录制文件生成后,Meet 可以访问录制 ID。用户可能会从 Google 云端硬盘中删除录制文件,但 Meet 中仍会返回唯一名称。
recordings
资源同时包含 DriveDestination
和 State
对象。
DriveDestination
对象用于存储云端硬盘中的导出位置,录音会以 MP4 文件的形式保存到该位置。如需下载录音或在浏览器中播放录音,请使用对象的 exportUri
字段值。如果您熟悉 Google 云端硬盘 API,则 file
字段值对应于 files
资源中的 id
。如需了解详情,请参阅下载和导出文件。
State
对象用于存储录制会话的状态。这样,您就可以查询录制是否已开始、录制是否已结束但录制文件尚未准备就绪,或者录制文件是否已生成且可以下载。
获取录音的详细信息
如需获取特定录音的详细信息,请对 recordings
资源使用 name
路径参数调用 get()
方法。如果您不知道录音名称,可以使用 list()
方法列出所有录音名称。
该方法会返回 recordings
资源的实例。
以下代码示例展示了如何检索特定录音:
Java
Node.js
Python
将录制名称替换为会议记录中特定录制 ID 的名称。
列出所有录音
如需列出会议记录中的所有录音的详细信息,请对 recordings
资源使用 list()
方法,并附带 parent
路径参数。格式:conferenceRecords/{conferenceRecord}
。
该方法会返回会议录制的列表,按 startTime
升序排列,并作为 recordings
资源的实例返回。如需调整页面大小,请参阅自定义分页 。
以下代码示例展示了如何列出会议记录中的所有录音:
Java
Node.js
Python
将父级值替换为会议记录的名称。
解说词
以下部分详细介绍了如何在会议记录中获取有关会议转写内容的信息。
转写数据生成后,Meet 会获得转写内容 ID 的访问权限。用户可能会从云端硬盘中删除转写文件,但 Meet 中仍会返回唯一名称。
transcripts
资源同时包含 DocsDestination
和 State
对象。
DocsDestination
对象用于存储 Google 云端硬盘中的导出位置,即 Google 文档转写文件的保存位置。如需提取内容或在浏览器中浏览转写内容,请使用对象的 exportUri
字段值。如果您熟悉 Google Docs API,则 document
字段值对应于 documents
资源中的 documentId
。
State
对象用于存储转写会话的状态。这样,您就可以查询转写会话是否已开始、转写会话是否已结束但转写文件尚未准备就绪,或者转写文件是否已生成且可以下载。
获取转写内容的详细信息
如需获取特定转写内容的详细信息,请对 transcripts
资源使用 name
路径参数的 get()
方法。如果您不知道转写内容名称,可以使用 list()
方法列出所有转写内容名称。
该方法会返回 transcripts
资源的实例。
以下代码示例展示了如何检索特定转写内容:
Java
Node.js
Python
将转写内容名称替换为会议记录中特定转写内容 ID 的名称。
列出所有转写内容
如需列出会议记录中的所有转写内容的详细信息,请对 transcripts
资源使用 list()
方法,并附带 parent
路径参数。格式:conferenceRecords/{conferenceRecord}
。
该方法会返回会议转写内容列表,按 startTime
升序排列,并作为 transcripts
资源的实例返回。如需调整页面大小,请参阅自定义分页 。
以下代码示例展示了如何列出会议记录中的所有转写内容:
Java
Node.js
Python
将父级值替换为会议记录的名称。
转写条目
以下部分详细介绍了如何在会议转写会话期间将每位参与者的语音作为转写条目获取。
转写条目包含对学员语音内容的转写文本,最多不超过 10,000 个字词。语音文本 languageCode
(例如 en-US
)也作为 IETF BCP 47 语法包含在内。
每个转写条目都与会议中的 participant
名称相关联。如需检索参与者详细信息,请参阅获取参与者详细信息。
转写条目数据会在会议结束后的 30 天内可用。
请注意,Meet REST API 返回的转写条目可能与 Google 文档转写文件中找到的转写内容不一致。如果转写文件在生成后被修改,就会出现这种情况。
获取转写条目的详细信息
如需获取特定转写条目的详细信息,请对 transcripts.entries
资源使用 get()
方法,并附带 name
路径参数。如果您不知道转写条目名称,可以使用 list()
方法列出所有转写条目名称。
该方法会返回 transcripts.entries
资源的实例。
以下代码示例展示了如何检索特定转写条目:
Java
Node.js
Python
将转写条目名称替换为转写中的特定转写条目 ID 的名称。
列出所有转写条目
如需列出转写内容中的所有转写条目的详细信息,请对 transcripts.entries
资源使用 list()
方法,并附带 parent
路径参数。格式:conferenceRecords/{conferenceRecord}/transcripts/{transcript}
。
该方法会返回每个会议转写的结构化转写条目列表,按 startTime
升序排列,以 transcripts.entries
资源的实例的形式返回。如需调整页面大小,请参阅自定义分页 。
以下代码示例展示了如何列出转写中的所有转写条目:
Java
Node.js
Python
将父级值替换为会议记录的名称和转写内容的名称。
自定义分页
传递以下查询参数可自定义录音、转写和转写条目的分页:
pageSize
:要返回的项的数量上限。服务返回的订阅的数量可能小于此值。如果未指定,则最多返回 10 项。最大值为 100;大于 100 的值会自动更改为 100。pageToken
:从上一个列表调用收到的页面令牌。提供此令牌可检索后续页面。