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. Подробнее о функциях 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. Подробнее о функциях 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. Подробнее о функциях YouTube можно узнать на странице https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Трансляция, указанная в параметре id, не существует.
rateLimitExceeded (403) userRequestsExceedRateLimit Пользователь отправил слишком много запросов за определенный период времени.
rateLimitExceeded (403) concurrentBroadcastsExceedLimit На канале уже достигнуто максимальное количество одновременных прямых трансляций. Чтобы начать новую трансляцию, необходимо остановить одну или несколько текущих.
rateLimitExceeded (403) sharedIngestionBroadcastsExceedLimit На канале достигнуто максимальное количество прямых трансляций с одним источником. Чтобы начать трансляцию, необходимо остановить одну или несколько из них.
required (400) idRequired Обязательный параметр id должен указывать на трансляцию, статус которой вы хотите изменить.
required (400) statusRequired В запросе к API необходимо указать значение параметра status.

liveBroadcasts.update

Тип ошибки Сведения об ошибке Описание
backendError (503) backendError Некоторые настройки пока нельзя применить. Скорее всего, это связано с тем, что трансляция только что создана. Повторите попытку через несколько секунд.
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. Подробнее о функциях 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, не идентифицирует трансляцию.
preconditionFailed (412) videoNotEligibleForAdsMonetization Видео не допущено к монетизации с помощью рекламы. Это может произойти, если канал не соответствует требованиям для монетизации.
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 может содержать до 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. Подробнее о функциях 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. Подробнее о функциях 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.