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 Свойство id , указанное в ресурсе liveBroadcast, не идентифицировало широковещательную рассылку.

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 Значение contentDetails.closedCaptionsType может быть изменено только тогда, когда трансляция находится в состоянии created или ready .
forbidden (403) enableAutoStartModificationNotAllowed Значение contentDetails.enableAutoStart можно изменить только тогда, когда поток неактивен, а трансляция находится в состоянии created или ready .
forbidden (403) enableClosedCaptionsModificationNotAllowed Значение contentDetails.enableClosedCaptions можно изменить только в том случае, если статус широковещательной рассылки уже created или ready .
forbidden (403) enableDvrModificationNotAllowed contentDetails. enableDvr Значение contentDetails. enableDvr можно изменить только тогда, когда статус трансляции created или ready .
forbidden (403) enableMonitorStreamModificationNotAllowed contentDetails. monitorStream.enableMonitorStream Значение contentDetails. monitorStream.enableMonitorStream может быть изменено только тогда, когда статус трансляции created или ready .
forbidden (403) recordFromStartModificationNotAllowed contentDetails. recordFromStart Значение contentDetails. recordFromStart может быть изменено только тогда, когда статус трансляции created или ready .
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 Свойство id , указанное в ресурсе liveBroadcast, не идентифицировало широковещательную рассылку.
required (400) broadcastStreamDelayMsRequired Ресурс liveBroadcast не указал contentDetails. monitorStream.broadcastStreamDelayMs Свойство contentDetails. monitorStream.broadcastStreamDelayMs .
required (400) enableMonitorStreamRequired Ресурс liveBroadcast не указал contentDetails. monitorStream.enableMonitorStream Свойство 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 Обязательное поле cueType должно быть указано в теле запроса API.
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 Указанный идентификатор канала не может быть найден.
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 Запрос не авторизован для удаления указанной прямой трансляции. Дополнительные сведения см. в разделе Реализация аутентификации 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 Значение свойства snippet.description в ресурсе liveStream может содержать до 10 000 символов.
invalidValue (400) invalidFormat Недопустимое значение свойства cdn.format в ресурсе liveStream .
invalidValue (400) invalidFrameRate Недопустимое значение свойства cdn.frameRate в ресурсе liveStream .
invalidValue (400) invalidIngestionType Недопустимое значение свойства cdn.ingestionType в ресурсе liveStream .
invalidValue (400) invalidResolution Недопустимое значение свойства cdn.resolution в ресурсе liveStream .
invalidValue (400) invalidTitle Значение свойства snippet.title в ресурсе liveStream должно иметь длину от 1 до 128 символов.
rateLimitExceeded userRequestsExceedRateLimit Пользователь отправил слишком много запросов за указанный период времени.
required (400) cdnRequired Ресурс liveStream должен содержать объект cdn .
required (400) frameRateRequired API возвращает эту ошибку, если вы укажете значение для свойства cdn.resolution , но не для свойства cdn.frameRate .
required (400) ingestionTypeRequired Ресурс liveStream должен указать значение для свойства cdn.ingestionType >.
required (400) resolutionRequired API возвращает эту ошибку, если вы укажете значение для свойства cdn.frameRate , но не для свойства cdn.resolution .
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 Значение свойства snippet.description в ресурсе liveStream может содержать до 10 000 символов.
invalidValue (400) invalidTitle Значение свойства snippet.title в ресурсе liveStream должно иметь длину от 1 до 128 символов.
notFound (404) liveStreamNotFound Указанный прямой эфир не существует.
required (400) idRequired Ресурс liveStream должен указать значение для свойства id .
required (400) ingestionTypeRequired Ресурс liveStream должен указать значение свойства cdn.ingestionType .
required (400) titleRequired Ресурс liveStream должен указать значение для свойства snippet.title .

sponsors

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами sponsors .

sponsors.list

Тип ошибки Сведения об ошибке Описание
forbidden (403) insufficientPermissions У вас нет необходимых прав для просмотра спонсоров канала.
invalidValue (400) invalidValueInRequest Запрос содержит недопустимое значение.
invalidValue (400) sponsorshipNotEnabledForChannelId На канале не включено спонсорство.