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 Запросу не разрешено удалять указанный прямой эфир. Дополнительные сведения см. в разделе «Реализация аутентификации 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 может содержать до 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 На канале не включено спонсорство.