此 API 参考文档介绍了如何使用 YouTube Live Streaming API 在 YouTube 上安排直播和视频在线播放。
资源类型
LiveBroadcasts
liveBroadcast
资源表示将在 YouTube 上通过直播视频流式传输的活动。
方法 | HTTP 请求 | 说明 |
---|---|---|
相对于 https:/ 的 URI |
||
bind |
POST / |
将 YouTube 直播绑定到直播,或解除直播与直播之间的现有绑定。一个直播只能绑定到一个视频流,但一个视频流可以绑定到多个直播。 |
delete |
DELETE / |
删除广播。 |
insert |
POST / |
创建广播。 |
list |
GET / |
返回与 API 请求参数匹配的 YouTube 直播的列表。 |
transition |
POST / |
更改 YouTube 直播的状态,并启动与新状态相关的所有进程。例如,当您将直播的状态转换为 testing 时,YouTube 会开始向该直播的监控数据流传输视频。在调用此方法之前,您应确认绑定到广播的串流的 status. 属性的值为 active 。 |
update |
PUT / |
更新广播。例如,您可以修改 liveBroadcast 资源的 contentDetails 对象中定义的广播设置。 |
cuepoint |
POST / |
在直播中插入 cuepoint。该 cue 点可能会触发广告插播时间点。 |
LiveChatBans
liveChatBan
资源用于标识 YouTube 用户以及该用户被禁止参与的 YouTube 实时聊天。
LiveChatMessages
liveChatMessage
资源表示 YouTube 实时聊天中的聊天消息。该资源可以包含有关多种类型消息的详细信息,包括新发布的短信或粉丝赞助活动。
直播聊天功能默认为直播启用,并在直播活动期间可用。(活动结束后,该活动将无法再进行实时聊天。)
LiveChatModerators
liveChatModerator
资源表示 YouTube 实时聊天的管理员。聊天管理员可以禁止或解除用户的聊天禁言、移除消息,以及对实时聊天执行其他管理操作。
LiveStreams
liveStream
资源包含有关您要传输到 YouTube 的视频串流的信息。该数据流提供将向 YouTube 用户广播的内容。创建后,liveStream
资源可以绑定到一个或多个 liveBroadcast
资源。
SuperChatEvents
superChatEvent
资源代表粉丝在 YouTube 直播期间购买的超级留言。在 YouTube 实时聊天中,超级留言以两种方式让您的消息更引人注目:
- 超级留言会以某种颜色突出显示。
- 超级留言会在置顶栏中固定展示一段时间。
超级留言的颜色、在置顶栏中固定展示的时长以及消息的最大长度都取决于购买金额。请访问 YouTube 帮助中心,详细了解超级留言。
方法 | HTTP 请求 | 说明 |
---|---|---|
相对于 https://www.googleapis.com/youtube/v3 的 URI |
||
list |
GET /superChatEvents |
列出频道过去 30 天内直播中的超级留言活动。 |
已废弃的资源类型
FanFundingEvents
fanFundingEvent
资源表示 YouTube 频道上的粉丝赞助活动。粉丝赞助功能让您可以通过金钱的方式支持 YouTube 创作者。当用户向频道进行一次性自愿付款时,就会发生粉丝赞助事件。如需详细了解粉丝赞助,请访问 YouTube 帮助中心。
方法 | HTTP 请求 | 说明 |
---|---|---|
相对于 https://www.googleapis.com/youtube/v3 的 URI |
||
list |
GET /fanFundingEvents |
列出频道的粉丝赞助活动。API 请求必须由频道所有者授权。 |
LiveCuepoints
liveCuepoint
资源用于在直播视频串流中开始广告插播。
注意:用于控制 cue 点的 API 命令实际上是 YouTube Content ID API 的一部分,其授权要求与管理 liveBroadcast
和 liveStream
资源的请求不同。
方法 | HTTP 请求 | 说明 |
---|---|---|
相对于 https://www.googleapis.com/ 的 URI |
||
insert |
POST /liveCuepoints |
在直播中插入 cuepoint。目前,使用此方法提交的请求必须由与 YouTube 内容所有者关联的账号授权。 |
赞助商
sponsor
资源表示 YouTube 频道的赞助商。赞助商向创作者提供定期的金钱支持(例如订阅费或会员费),并获得特殊福利。例如,当创作者为聊天开启赞助者专享模式时,赞助者就可以参与聊天。
方法 | HTTP 请求 | 说明 |
---|---|---|
相对于 https://www.googleapis.com/youtube/v3 的 URI |
||
list |
GET /sponsors |
列出频道的赞助商。API 请求必须由频道所有者授权。 |