YouTube Live Streaming API - Errors

本文档介绍了 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 仅当广播处于 createdready 状态时,才能修改 contentDetails.closedCaptionsType 值。
forbidden (403) enableAutoStartModificationNotAllowed 仅当数据流处于非活跃状态且广播处于 createdready 状态时,才能修改 contentDetails.enableAutoStart 值。
forbidden (403) enableClosedCaptionsModificationNotAllowed 仅当广播状态为 createdready 时,才能修改 contentDetails.enableClosedCaptions 值。
forbidden (403) enableDvrModificationNotAllowed 仅当广播状态为 createdready 时,才能修改 contentDetails.enableDvr 值。
forbidden (403) enableMonitorStreamModificationNotAllowed 仅当广播状态为 createdready 时,才能修改 contentDetails.monitorStream.enableMonitorStream 值。
forbidden (403) recordFromStartModificationNotAllowed 仅当广播状态为 createdready 时,才能修改 contentDetails.recordFromStart 值。
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.monitorStream.broadcastStreamDelayMs 属性。
required (400) enableMonitorStreamRequired liveBroadcast 资源未指定 contentDetails.monitorStream.enableMonitorStream 属性。
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/2474026https://www.youtube.com/features 查找更多信息。
rateLimitExceeded (403) userRequestsExceedRateLimit 用户在指定时间范围内发送的请求过多。
required (400) idRequired 必需参数 id 必须标识要在其中插入广告插入点的广播。
required (400) cueTypeRequired 必须在 API 请求正文中指定必需的 cueType 字段。
notFound (404) liveBroadcastNotFound id”参数指定的广播不存在。
invalidValue (400) conflictingTimeFields 只能指定 insertionOffsetTimeMswalltimeMs 中的一个。设置这两个值会导致错误。如果未设置其中任一值,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 只能指定 offsetTimeMswalltime 中的一个。

直播

下表列出了该 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.formatcdn.frameRatecdn.ingestionTypecdn.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 频道未启用赞助功能。