LiveStreams: update

更新视频流。如果您要更改的属性无法更新,则需要使用正确的设置创建新的数据流。

PUT https://www.googleapis.com/youtube/v3/liveStreams

授权

此请求需要获得以下至少一个范围的授权。如需详细了解身份验证和授权,请参阅实现 OAuth 2.0 授权

范围
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
part string
在本操作中,part 参数有两个用途。它用于标识写入操作将设置的属性以及 API 响应将包含的属性。

您可以在参数值中包含的 part 属性包括 idsnippetcdnstatus

请注意,此方法会替换参数值指定的任何部分中包含的所有可变属性的现有值。如果请求正文未为可变属性指定值,则系统会移除该属性的现有值。
可选参数
onBehalfOfContentOwner string
此参数只能在经过适当授权的请求中使用。

注意:此参数仅供 YouTube 内容合作伙伴使用。
onBehalfOfContentOwner 参数表示请求的授权凭据标识了代表参数值中指定的内容所有者行事的 YouTube CMS 用户。此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。借助此功能,内容所有者只需进行一次身份验证,即可访问其所有视频和频道数据,而无需为每个频道分别提供身份验证凭据。用户进行身份验证时使用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。
onBehalfOfContentOwnerChannel string
此参数只能在经过适当授权的请求中使用。

注意:此参数仅供 YouTube 内容合作伙伴使用。
onBehalfOfContentOwnerChannel 参数用于指定要添加视频到的频道的 YouTube 频道 ID。当请求为 onBehalfOfContentOwner 参数指定值时,此参数是必需的,并且只能与该参数搭配使用。此外,必须使用与 onBehalfOfContentOwner 参数指定的内容所有者相关联的 CMS 账号来授权该请求。最后,onBehalfOfContentOwnerChannel 参数值指定的频道必须与 onBehalfOfContentOwner 参数指定的内容所有者相关联。

此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。借助此功能,内容所有者只需进行一次身份验证,即可代表参数值中指定的频道执行操作,而无需为每个单独的频道提供身份验证凭据。

请求正文

在请求正文中提供 liveStream 资源。 对于该资源:

  • 您必须为以下属性指定值:

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • 您可以为以下属性设置值:

    • snippet.title
    • snippet.description

    如果您提交更新请求,并且您的请求未为已具有值的媒体资源指定值,则系统会删除该媒体资源的现有值。

响应

如果成功,此方法将在响应正文中返回 liveStream 资源

错误

下表列出了该 API 在响应对此方法的调用时可能会返回的错误消息。如需了解详情,请参阅 YouTube Live Streaming API - 错误

错误类型 错误详情 说明
forbidden (403) liveStreamModificationNotAllowed 由于指定直播当前所处的状态,因此无法对其进行修改。如需了解详情,请参阅广播的生命周期
forbidden (403) liveStreamModificationNotAllowed 该 API 不允许您在创建数据流后更改 cdn.formatcdn.frameRatecdn.ingestionTypecdn.resolution 字段的值。
forbidden (403) liveStreamModificationNotAllowed 该 API 不允许您将可重复使用的串流更改为不可重复使用,反之亦然。如需了解详情,请参阅了解广播和数据流
insufficientPermissions insufficientLivePermissions 请求无权更新指定的直播。如需了解详情,请参阅实现 OAuth2 身份验证
insufficientPermissions liveStreamingNotEnabled 授权该请求的用户未获准在 YouTube 上直播视频。用户可以参阅使用这些功能需要满足的资格条件了解详情。
invalidValue (400) invalidDescription liveStream 资源中的 snippet.description 属性值最多可包含 10,000 个字符。
invalidValue (400) invalidTitle 直播资源中的 snippet.title 属性值的长度必须介于 1 到 128 个字符之间。
notFound (404) liveStreamNotFound 指定的直播不存在。
required (400) idRequired liveStream 资源必须为 id 属性指定值。
required (400) ingestionTypeRequired liveStream 资源必须为 cdn.ingestionType 属性指定值。
required (400) titleRequired liveStream 资源必须为 snippet.title 属性指定值。