本文档介绍了如何使用 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 中仍会返回唯一名称。
资源
transcripts
包含
DocsDestination
和
State
对象。
DocsDestination 对象包含 Google 文档转写内容文件在云端硬盘中的导出位置。如需提取内容或在
浏览器中浏览转写内容,请使用该对象的
exportUri
字段值。如果您熟悉 Google 文档 API,则
document
字段值对应于
documentId
在 documents 资源中。
State 对象包含转写会话的状态。借助此对象,您可以查询转写会话是否已开始、转写会话是否已结束但转写文件尚未准备就绪,或者转写文件是否已生成并可供下载。
获取有关转写内容的详细信息
如需获取有关特定转写内容的详细信息,请对
transcripts
资源使用
get
方法。使用 conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} 格式设置 name 路径参数。
如果您不知道转写名称,可以使用 list all transcript
names 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 路径参数。
如果您不知道转写内容条目名称,可以使用 列出所有转写内容条目
名称 using the 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 文档 API,则
document
字段值对应于
documentId
在 documents 资源中。
获取有关智能会议记录的详细信息
如需获取有关特定智能会议记录文件的详细信息,请对 smartNotes 资源使用
get
方法。使用 conferenceRecords/{conferenceRecord}/smartNotes/{smartNote} 格式设置 name 路径参数。
如果您不知道智能会议记录的名称,可以使用 列出所有智能会议记录
文件 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 访问权限的访问令牌。
列出所有智能会议记录
如需列出会议记录中所有智能会议记录文件的详细信息,请对 smartNotes 资源使用
list
方法。使用 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:从之前的列表调用接收的页面令牌。提供此令牌可检索后续页面。