本文档介绍了 YouTube Live Streaming API 操作可以返回的不同类型的错误。您还可以在该方法的参考文档中找到该方法的错误列表。
fanFundingEvents
下表列出了 API 在响应与 fanFundingEvents 资源相关的调用时返回的错误消息。
fanFundingEvents.list
| 错误类型 | 错误详情 | 说明 |
|---|---|---|
forbidden (403) |
insufficientPermissions |
你没有查看该频道的粉丝赞助活动所需的权限。 |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
频道未启用粉丝赞助功能。 |
liveBroadcasts
下表列出了 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 |
该服务不可用。请过几分钟后重试您的请求。 |
liveChatBans
下表列出了 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 属性的值。 |
liveChatMessages
下表列出了 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 的刷新频率时，就会出现此错误，这会不必要地浪费带宽。 |
liveCuepoints
下表列出了 API 在响应与 liveCuepoints 资源相关的调用时返回的错误消息。
liveCuepoints.insert
| 错误类型 | 错误详情 | 说明 |
|---|---|---|
invalidValue (400) |
conflictingTimeFields |
只能指定 offsetTimeMs 和 walltime 中的一个。 |
liveStreams
下表列出了 API 在响应与 liveStreams 资源相关的调用时返回的错误消息。
liveStreams.delete
| 错误类型 | 错误详情 | 说明 |
|---|---|---|
forbidden (403) |
liveStreamDeletionNotAllowed |
指定的直播已绑定到一个尚未完成的直播，因此无法删除。 |
insufficientPermissions |
insufficientLivePermissions |
该请求无权删除指定的直播活动。有关详情，请参阅实现 OAuth 2.0 身份验证。 |
insufficientPermissions |
liveStreamingNotEnabled |
对请求进行授权的用户无法在 YouTube 上直播视频。如需了解详情，请参阅功能使用资格。 |
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 属性的值最多可包含 1 万个字符。 |
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 |
该频道未启用赞助功能。 |