此页面由 Cloud Translation API 翻译。

YouTube Live Streaming API - Errors

本文档介绍了 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.enableDvr` 值。
`forbidden (403)`	`enableMonitorStreamModificationNotAllowed`	仅当广播的状态为 `created` 或 `ready` 时，才能修改 `contentDetails.monitorStream.enableMonitorStream` 值。
`forbidden (403)`	`recordFromStartModificationNotAllowed`	仅当广播的状态为 `created` 或 `ready` 时，才能修改 `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/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`	该频道未启用赞助功能。