本文档介绍了 YouTube Live Streaming API 操作可能返回的不同类型的错误。您还可以在相应方法的参考文档中找到任一方法的错误列表。
粉丝资助活动
下表列出了该 API 在响应与 fanFundingEvents
资源相关的调用时返回的错误消息。
fanFundingEvents.list
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
insufficientPermissions |
您没有查看频道的粉丝资助活动所需的权限。 |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
频道未启用粉丝资助功能。 |
直播
下表列出了该 API 在响应与 liveBroadcasts
资源相关的调用时返回的错误消息。
liveBroadcasts.bind
错误类型 | 错误详情 | 说明 |
---|---|---|
backendError |
internalError |
绑定期间发生内部错误。 |
forbidden (403) |
liveBroadcastBindingNotAllowed |
当前直播的状态不允许将其与视频流绑定。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权检索指定的实时广播。如需了解详情,请参阅实现 OAuth2 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
notFound (404) |
liveBroadcastNotFound |
“id ”参数指定的广播不存在。 |
notFound (404) |
liveStreamNotFound |
此 streamId 参数指定的流不存在。 |
rateLimitExceeded |
userRequestsExceedRateLimit |
用户在指定时间范围内发送的请求过多。 |
required (400) |
idRequired |
必需参数 id 必须标识要绑定的广播。 |
liveBroadcasts.delete
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
liveBroadcastDeletionNotAllowed |
当前直播状态不允许删除直播。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权删除指定的直播。如需了解详情,请参阅实现 OAuth2 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
notFound (404) |
liveBroadcastNotFound |
liveBroadcast 资源中指定的 id 属性无法识别广播。 |
liveBroadcasts.insert
错误类型 | 错误详情 | 说明 |
---|---|---|
insufficientPermissions |
insufficientLivePermissions |
该请求未获得创建直播的授权。 |
insufficientPermissions |
livePermissionBlocked |
授权请求的用户目前无法在 YouTube 上直播视频。您可以在 https://www.youtube.com/features 的用户频道设置中找到解释用户无法直播视频的详细信息。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
invalidValue (400) |
invalidAutoStart |
liveBroadcast 资源的 contentDetails.enableAutoStart 属性值无效。
并非所有广播都支持此设置。 |
invalidValue (400) |
invalidAutoStop |
liveBroadcast 资源的 contentDetails.enableAutoStop 属性值无效。您不能修改永久性广播的 enableAutoStop 设置。 |
invalidValue (400) |
invalidDescription |
liveBroadcast 资源没有为 snippet.description 属性指定有效值。该属性值最多可包含 5000 个字符。 |
invalidValue (400) |
invalidEmbedSetting |
liveBroadcast 资源的 contentDetails.enable_embed 属性值无效。您不能嵌入此广播。 |
invalidValue (400) |
invalidLatencyPreferenceOptions |
liveBroadcast 资源的 contentDetails.latencyPreference 属性值无效。
此延迟偏好设置并不支持所有设置。
|
invalidValue (400) |
invalidPrivacyStatus |
liveBroadcast 资源的 status.privacy_status 属性值无效。 |
invalidValue (400) |
invalidProjection |
liveBroadcast 资源的 contentDetails.projection 属性值无效。无法将默认广播的投影设为 360 。 |
invalidValue (400) |
invalidScheduledEndTime |
liveBroadcast 资源的 snippet.scheduledEndTime 属性值无效。预定的结束时间必须晚于预定的开始时间。 |
invalidValue (400) |
invalidScheduledStartTime |
liveBroadcast 资源的 snippet.scheduledStartTime 属性值无效。预定的开始时间必须是将来的时间,并且足够接近当前时间,以便能够在当时可靠地安排广播。 |
invalidValue (400) |
invalidTitle |
liveBroadcast 资源没有为 snippet.title 属性指定有效值。属性值的长度必须介于 1 到 100 个字符之间。 |
limitExceeded |
userBroadcastsExceedLimit |
用户创建的直播或预定的直播过多,必须停止或删除。 |
rateLimitExceeded |
userRequestsExceedRateLimit |
用户在指定时间范围内发送的请求过多。 |
required (400) |
privacyStatusRequired |
liveBroadcast 资源必须指定隐私状态。请参阅有效的 privacyStatus 值。 |
required (400) |
scheduledEndTimeRequired |
liveBroadcast 资源必须指定 snippet.scheduledEndTime 属性。 |
required (400) |
scheduledStartTimeRequired |
liveBroadcast 资源必须指定 snippet.scheduledStartTime 属性。 |
required (400) |
titleRequired |
liveBroadcast 资源必须指定 snippet.title 属性。 |
liveBroadcasts.list
错误类型 | 错误详情 | 说明 |
---|---|---|
insufficientPermissions |
insufficientLivePermissions |
该请求无权检索实时广播。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
liveBroadcasts.transition
错误类型 | 错误详情 | 说明 |
---|---|---|
backendError |
errorExecutingTransition |
更改广播状态时出错。 |
forbidden (403) |
errorStreamInactive |
当绑定到广播的视频流处于非活跃状态时,不允许进行所请求的转换。 |
forbidden (403) |
invalidTransition |
直播无法从当前状态转换为播放状态。 |
forbidden (403) |
redundantTransition |
该直播已处于所请求的状态,或者正在处理所请求的状态。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权转换直播内容。 |
insufficientPermissions |
livePermissionBlocked |
授权请求的用户目前无法在 YouTube 上直播视频。您可以在 https://www.youtube.com/features 的用户频道设置中找到解释用户无法直播视频的详细信息。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
notFound (404) |
liveBroadcastNotFound |
“id ”参数指定的广播不存在。 |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
用户在指定时间范围内发送的请求过多。 |
required (400) |
idRequired |
必需参数 id 必须标识您要转换其状态的广播。 |
required (400) |
statusRequired |
API 请求必须指定 status 参数的值。 |
liveBroadcasts.update
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
closedCaptionsTypeModificationNotAllowed |
仅当广播处于 created 或 ready 状态时,才能修改 contentDetails.closedCaptionsType 值。 |
forbidden (403) |
enableAutoStartModificationNotAllowed |
仅当数据流处于非活跃状态且广播处于 created 或 ready 状态时,才能修改 contentDetails.enableAutoStart 值。 |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
仅当广播状态为 created 或 ready 时,才能修改 contentDetails.enableClosedCaptions 值。 |
forbidden (403) |
enableDvrModificationNotAllowed |
仅当广播状态为 created 或 ready 时,才能修改 contentDetails. 值。 |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
仅当广播状态为 created 或 ready 时,才能修改 contentDetails. 值。 |
forbidden (403) |
recordFromStartModificationNotAllowed |
仅当广播状态为 created 或 ready 时,才能修改 contentDetails. 值。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权更新指定的直播。如需了解详情,请参阅实现 OAuth2 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
invalidValue (400) |
invalidAutoStart |
liveBroadcast 资源的 contentDetails.enableAutoStart 属性值无效。
您无法修改永久性广播的 enableAutoStart 设置。 |
invalidValue (400) |
invalidAutoStop |
liveBroadcast 资源的 contentDetails.enableAutoStop 属性值无效。您不能修改永久性广播的 enableAutoStop 设置。 |
invalidValue (400) |
invalidDescription |
liveBroadcast 资源没有为 snippet.description 属性指定有效值。snippet.description 最多可包含 5000 个字符。 |
invalidValue (400) |
invalidEmbedSetting |
liveBroadcast 资源的 contentDetails.enable_embed 属性值无效。您不能嵌入此广播。 |
invalidValue (400) |
invalidEnableClosedCaptions |
在 liveBroadcast 资源中,contentDetails.enableClosedCaptions 属性的值与 contentDetails.closedCaptionType 设置的值不兼容。修改资源,使其仅包含这两个属性之一,然后重新提交请求。 |
invalidValue (400) |
invalidLatencyPreferenceOptions |
liveBroadcast 资源的 contentDetails.latencyPreference 属性值无效。
此延迟偏好设置并不支持所有设置。
|
invalidValue (400) |
invalidPrivacyStatus |
liveBroadcast 资源未指定有效的隐私权状态。请参阅有效的 privacyStatus 值。 |
invalidValue (400) |
invalidProjection |
liveBroadcast 资源的 contentDetails.projection 属性值无效。持久性广播的投影无法设置为 360。 |
invalidValue (400) |
invalidScheduledEndTime |
liveBroadcast 资源的 snippet.scheduledEndTime 属性值无效。预定的结束时间必须晚于预定的开始时间。 |
invalidValue (400) |
invalidScheduledStartTime |
liveBroadcast 资源的 snippet.scheduledStartTime 属性值无效。安排的开始时间必须是将来的时间。 |
invalidValue (400) |
invalidTitle |
liveBroadcast 资源没有为 snippet.title 属性指定有效值。“snippet.title ”的长度必须介于 1 到 100 个字符之间。 |
notFound (404) |
liveBroadcastNotFound |
liveBroadcast 资源中指定的 id 属性无法识别广播。 |
required (400) |
broadcastStreamDelayMsRequired |
liveBroadcast 资源未指定 contentDetails. 属性。 |
required (400) |
enableMonitorStreamRequired |
liveBroadcast 资源未指定 contentDetails. 属性。 |
required (400) |
idRequired |
liveBroadcast 资源必须包含 id 属性并指定其值。 |
required (400) |
privacyStatusRequired |
liveBroadcast 资源未指定隐私状态。请参阅了解有效的 privacyStatus 值。 |
required (400) |
scheduledEndTimeRequired |
liveBroadcast 资源未指定 snippet.scheduledEndTime 属性。 |
required (400) |
scheduledStartTimeRequired |
liveBroadcast 资源未指定 snippet.scheduledStartTime 属性。 |
required (400) |
titleRequired |
liveBroadcast 资源未指定 snippet.title 属性。 |
liveBroadcasts.cuepoint
错误类型 | 错误详情 | 说明 |
---|---|---|
insufficientPermissions (403) |
insufficientLivePermissions |
无权在直播中插入广告插入点。 |
insufficientPermissions (403) |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://support.google.com/youtube/answer/2474026 和 https://www.youtube.com/features 查找更多信息。 |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
用户在指定时间范围内发送的请求过多。 |
required (400) |
idRequired |
必需参数 id 必须标识要在其中插入广告插入点的广播。 |
required (400) |
cueTypeRequired |
必须在 API 请求正文中指定必需的 cueType 字段。 |
notFound (404) |
liveBroadcastNotFound |
“id ”参数指定的广播不存在。 |
invalidValue (400) |
conflictingTimeFields |
只能指定 insertionOffsetTimeMs 和 walltimeMs 中的一个。设置这两个值会导致错误。如果未设置其中任一值,YouTube 将使用默认的 insertionOffsetTimeMs 时间 (0 ),这意味着系统会尽快插入广告插入点。 |
invalidValue (400) |
invalidInsertionOffsetTimeMs |
cuepoint 资源为 insertionOffsetTimeMs 属性指定了无效值。值必须为 0 或正整数。 |
invalidValue (400) |
invalidWalltimeMs |
cuepoint 资源为 walltimeMs 属性指定了无效值。该值必须是表示周期时间戳的整数。 |
backendError (5xx) |
serviceUnavailable |
该服务不可用。请在几分钟后重试您的请求。 |
实时聊天
下表列出了该 API 在响应与 liveChatBans
资源相关的调用时返回的错误消息。
liveChatBans.delete
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
forbidden |
无法移除指定的黑名单。如果有一位管理员尝试移除其他管理员的禁令,就可能会发生此错误。 |
forbidden (403) |
insufficientPermissions |
您的权限不足,无法移除指定的黑名单。 |
invalidValue (400) |
invalidLiveChatBanId |
id 参数指定无效值。 |
notFound (404) |
liveChatBanNotFound |
找不到指定的黑名单。 |
liveChatBans.insert
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
insufficientPermissions |
您的权限不足,无法将用户加入指定的实时聊天黑名单。 |
forbidden (403) |
liveChatBanInsertionNotAllowed |
无法创建指定的黑名单。如果该请求尝试将聊天所有者或其他管理员加入黑名单,则可能会发生此错误。 |
invalidValue (400) |
invalidChannelId |
找不到指定的渠道 ID。 |
invalidValue (400) |
invalidLiveChatId |
请求中指定的 snippet.liveChatId 值无效。请检查关联的 liveBroadcast 资源,以确保其具有正确的值。 |
notFound (404) |
liveChatNotFound |
找不到指定的实时聊天。请检查关联的 liveBroadcast 资源,确保将 snippet.liveChatId 属性设置为正确的值。 |
notFound (404) |
liveChatUserNotFound |
找不到您要加入黑名单的实时聊天用户。 |
required (400) |
bannedUserChannelIdRequired |
在请求正文中提交的 liveChatBan 资源必须指定 snippet.bannedUserDetails.channelId 属性的值。 |
required (400) |
liveChatIdRequired |
在请求正文中提交的 liveChatBan 资源必须指定 snippet.liveChatId 属性的值。 |
实时聊天消息
下表列出了该 API 在响应与 liveChatMessages
资源相关的调用时返回的错误消息。
liveChatMessages.delete
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
forbidden |
您没有删除指定消息所需的权限。 |
forbidden (403) |
modificationNotAllowed |
指定的 liveChatMessage 资源无法删除。id 参数可能会指定由管理员或其他用户无法删除的邮件。 |
notFound (404) |
liveChatMessageNotFound |
找不到您尝试删除的消息。请检查 id 参数的值,确保其正确无误。 |
liveChatMessages.insert
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
forbidden |
您没有创建指定消息所需的权限。 |
forbidden (403) |
liveChatDisabled |
指定的实时聊天已被所有者停用,这意味着消息无法添加到聊天中。 |
forbidden (403) |
liveChatEnded |
指定的实时聊天消息已失效。 |
invalidValue (400) |
messageTextInvalid |
消息文本 (snippet.textMessageDetails.messageText ) 无效。 |
notFound (404) |
liveChatNotFound |
API 请求中指定的实时聊天不存在。如果所有者删除了该聊天,就会出现此错误。 |
rateLimitExceeded |
rateLimitExceeded |
用户在指定时间范围内发布了太多聊天消息。 |
required (400) |
liveChatIdRequired |
liveChatMessage 资源必须包含 snippet.liveChatId 属性并指定值。 |
required (400) |
messageTextRequired |
liveChatMessage 资源必须包含 snippet.textMessageDetails.messageText 属性并指定值。 |
required (400) |
typeRequired |
liveChatMessage 资源必须包含 snippet.type 属性并指定值。将参数值设为 text |
liveChatMessages.list
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
forbidden |
您没有检索指定实时聊天消息的权限。 |
forbidden (403) |
liveChatDisabled |
指定的直播未启用实时聊天功能。 |
forbidden (403) |
liveChatEnded |
指定的实时聊天消息已失效。 |
notFound (404) |
liveChatNotFound |
未找到您尝试检索的实时聊天。请检查请求的 liveChatId 参数的值,确保其正确无误。 |
rateLimitExceeded |
rateLimitExceeded |
该请求在上一个请求之后发送过快。当 API 检索消息的发送频率高于 YouTube 的更新频率时,就会发生此错误,而这会不必要地浪费带宽。 |
liveCuepoint
下表列出了该 API 在响应与 liveCuepoints
资源相关的调用时返回的错误消息。
liveCuepoints.insert
错误类型 | 错误详情 | 说明 |
---|---|---|
invalidValue (400) |
conflictingTimeFields |
只能指定 offsetTimeMs 和 walltime 中的一个。 |
直播
下表列出了该 API 在响应与 liveStreams
资源相关的调用时返回的错误消息。
liveStreams.delete
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
liveStreamDeletionNotAllowed |
指定的直播已与尚未完成的直播绑定,因此无法删除。 |
insufficientPermissions |
insufficientLivePermissions |
该请求未获得删除指定直播活动的授权。如需了解详情,请参阅实现 OAuth2 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
notFound (404) |
liveStreamNotFound |
指定的直播不存在。 |
liveStreams.insert
错误类型 | 错误详情 | 说明 |
---|---|---|
insufficientPermissions |
insufficientLivePermissions |
该请求未获得创建指定直播的授权。 |
insufficientPermissions |
livePermissionBlocked |
授权请求的用户目前无法在 YouTube 上直播视频。您可以在 https://www.youtube.com/features 的用户频道设置中找到解释用户无法直播视频的详细信息。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
invalidValue (400) |
invalidDescription |
liveStream 资源中的 snippet.description 属性的值最多可包含 10000 个字符。 |
invalidValue (400) |
invalidFormat |
“liveStream ”资源中“cdn.format ”属性的值无效。 |
invalidValue (400) |
invalidFrameRate |
“liveStream ”资源中“cdn.frameRate ”属性的值无效。 |
invalidValue (400) |
invalidIngestionType |
“liveStream ”资源中“cdn.ingestionType ”属性的值无效。 |
invalidValue (400) |
invalidResolution |
“liveStream ”资源中“cdn.resolution ”属性的值无效。 |
invalidValue (400) |
invalidTitle |
liveStream 资源中 snippet.title 属性的值必须介于 1 到 128 个字符之间。 |
rateLimitExceeded |
userRequestsExceedRateLimit |
用户在指定时间范围内发送的请求过多。 |
required (400) |
cdnRequired |
liveStream 资源必须包含 cdn 对象。 |
required (400) |
frameRateRequired |
如果您为 cdn.resolution 属性(而不是 cdn.frameRate 属性)指定了值,则 API 会返回此错误。 |
required (400) |
ingestionTypeRequired |
liveStream 资源必须指定 cdn.ingestionType 属性的值。 |
required (400) |
resolutionRequired |
如果您为 cdn.frameRate 属性(而不是 cdn.resolution 属性)指定了值,则 API 会返回此错误。 |
required (400) |
titleRequired |
liveStream 资源必须指定 snippet.title 属性的值。 |
liveStreams.list
错误类型 | 错误详情 | 说明 |
---|---|---|
insufficientPermissions |
insufficientLivePermissions |
该请求无权检索指定的直播。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
liveStreams.update
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
liveStreamModificationNotAllowed |
无法在当前状态下修改指定的直播。如需了解详情,请参阅广播的生命周期。 |
forbidden (403) |
liveStreamModificationNotAllowed |
该 API 不允许您在数据流创建后更改 cdn.format 、cdn.frameRate 、cdn.ingestionType 或 cdn.resolution 字段的值。 |
forbidden (403) |
liveStreamModificationNotAllowed |
该 API 不允许将可重复使用的数据流更改为不可重复使用,反之亦然。如需了解详情,请参阅了解广播和流。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权更新指定的直播。如需了解详情,请参阅实现 OAuth2 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
授权请求的用户无法在 YouTube 上直播视频。用户可以访问 https://www.youtube.com/features 查找更多信息。 |
invalidValue (400) |
invalidDescription |
liveStream 资源中 snippet.description 属性的值最多可包含 10000 个字符。 |
invalidValue (400) |
invalidTitle |
liveStream 资源中 snippet.title 属性的值必须介于 1 到 128 个字符之间。 |
notFound (404) |
liveStreamNotFound |
指定的直播不存在。 |
required (400) |
idRequired |
liveStream 资源必须指定 id 属性的值。 |
required (400) |
ingestionTypeRequired |
liveStream 资源必须指定 cdn.ingestionType 属性的值。 |
required (400) |
titleRequired |
liveStream 资源必须指定 snippet.title 属性的值。 |
赞助者
下表列出了该 API 在响应与 sponsors
资源相关的调用时返回的错误消息。
sponsors.list
错误类型 | 错误详情 | 说明 |
---|---|---|
forbidden (403) |
insufficientPermissions |
您没有查看频道赞助商所需的权限。 |
invalidValue (400) |
invalidValueInRequest |
请求包含无效值。 |
invalidValue (400) |
sponsorshipNotEnabledForChannelId |
频道未启用赞助功能。 |