YouTube Live Streaming API - Errors

В этом документе описаны различные типы ошибок, которые могут возвращаться при работе YouTube Live Streaming API . Список ошибок для каждого отдельного метода можно найти в справочной документации по этому методу.

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 можно изменить только в том случае, если трансляция находится в состоянии created или ready .
forbidden (403) enableMonitorStreamModificationNotAllowed Значение contentDetails. monitorStream.enableMonitorStream можно изменить только в том случае, если трансляция находится в состоянии created или ready .
forbidden (403) recordFromStartModificationNotAllowed Значение 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 .
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 Обязательное поле 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, что приводит к неоправданной трате полосы пропускания.

liveChatMessages.streamlist

Тип ошибки Подробности ошибки Описание
INVALID_ARGUMENT (3) LIVE_CHAT_ENDED Вы не сможете восстановить сообщения для завершенного чата.
PERMISSION_DENIED (7) forbidden У вас нет разрешений, необходимых для получения сообщений для указанного чата.
PERMISSION_DENIED (7) liveChatDisabled Онлайн-чат не включен для указанной трансляции.
PERMISSION_DENIED (7) liveChatEnded Указанный чат больше не активен.
NOT_FOUND (5) liveChatNotFound Онлайн-чат, который вы пытаетесь получить, не найден. Проверьте значение параметра liveChatId в запросе, чтобы убедиться в его корректности.
RESOURCE_EXHAUSTED (8) rateLimitExceeded Запрос был отправлен слишком быстро после предыдущего запроса. Эта ошибка возникает, когда запросы API на получение сообщений отправляются чаще, чем частота обновления YouTube, что приводит к неоправданной трате полосы пропускания.

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 Значение свойства snippet.description в ресурсе liveStream может содержать до 10000 символов.
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 может содержать до 10000 символов.
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 .