YouTube Live Streaming API - Errors
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에서는 YouTube Live Streaming API 작업에서 반환할 수 있는 다양한 유형의 오류를 식별합니다. 개별 메소드의 오류 목록은 해당 메소드의 참조 문서에서도 확인할 수 있습니다.
fanFundingEvents
다음 표에는 fanFundingEvents
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
fanFundingEvents.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
insufficientPermissions |
채널의 팬 후원 이벤트를 볼 권한이 없습니다. |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
채널에 크리에이터 후원이 사용 설정되어 있지 않습니다. |
liveBroadcasts
다음 표에는 liveBroadcasts
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
liveBroadcasts.bind
오류 유형 |
오류 세부정보 |
설명 |
backendError |
internalError |
바인딩 중에 내부 오류가 발생했습니다. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
현재 라이브 방송 상태에서는 스트림에 바인딩할 수 없습니다. |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 방송을 가져올 권한이 없습니다. 자세한 내용은 OAuth2 인증 구현을 참고하세요. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
notFound (404) |
liveBroadcastNotFound |
id 매개변수로 지정된 방송이 존재하지 않습니다. |
notFound (404) |
liveStreamNotFound |
streamId 매개변수로 지정된 스트림이 존재하지 않습니다. |
rateLimitExceeded |
userRequestsExceedRateLimit |
사용자가 지정된 기간 내에 너무 많은 요청을 보냈습니다. |
required (400) |
idRequired |
필수 id 매개변수는 바인딩할 방송을 식별해야 합니다. |
liveBroadcasts.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
liveBroadcastDeletionNotAllowed |
현재 라이브 방송 상태에서는 삭제할 수 없습니다. |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 방송을 삭제할 권한이 없습니다. 자세한 내용은 OAuth2 인증 구현을 참고하세요. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
notFound (404) |
liveBroadcastNotFound |
liveBroadcast 리소스에 지정된 id 속성이 브로드캐스트를 식별하지 못했습니다. |
liveBroadcasts.insert
오류 유형 |
오류 세부정보 |
설명 |
insufficientPermissions |
insufficientLivePermissions |
요청에 실시간 방송을 만들 권한이 없습니다. |
insufficientPermissions |
livePermissionBlocked |
요청을 승인한 사용자가 현재 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자가 라이브 동영상을 스트리밍할 수 없는 이유를 설명하는 세부정보는 https://www.youtube.com/features의 사용자 채널 설정에서 확인할 수 있습니다. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
invalidValue (400) |
invalidAutoStart |
liveBroadcast 리소스에 contentDetails.enableAutoStart 속성의 잘못된 값이 포함되어 있습니다.
일부 방송에서는 이 설정을 지원하지 않습니다. |
invalidValue (400) |
invalidAutoStop |
liveBroadcast 리소스에 contentDetails.enableAutoStop 속성의 잘못된 값이 포함되어 있습니다. 지속적인 브로드캐스트의 enableAutoStop 설정은 수정할 수 없습니다. |
invalidValue (400) |
invalidDescription |
liveBroadcast 리소스에 snippet.description 속성의 유효한 값이 지정되지 않았습니다. 속성 값은 최대 5,000자(영문 기준)까지 포함할 수 있습니다. |
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 는 최대 5,000자(영문 기준)를 포함할 수 있습니다. |
invalidValue (400) |
invalidEmbedSetting |
liveBroadcast 리소스의 contentDetails.enable_embed 속성에 잘못된 값이 포함되어 있습니다. 이 방송은 퍼갈 수 없습니다. |
invalidValue (400) |
invalidEnableClosedCaptions |
liveBroadcast 리소스에서 contentDetails.enableClosedCaptions 속성 값이 contentDetails.closedCaptionType 설정 값과 호환되지 않습니다. 두 속성 중 하나만 포함하도록 리소스를 수정한 다음 요청을 다시 제출합니다. |
invalidValue (400) |
invalidLatencyPreferenceOptions |
liveBroadcast 리소스에 contentDetails.latencyPreference 속성의 잘못된 값이 포함되어 있습니다.
이 지연 시간 환경설정에서는 일부 설정이 지원되지 않습니다.
|
invalidValue (400) |
invalidPrivacyStatus |
liveBroadcast 리소스에 유효한 공개 상태가 지정되지 않았습니다. 유효한 privacyStatus 값을 참고하세요. |
invalidValue (400) |
invalidProjection |
liveBroadcast 리소스의 contentDetails.projection 속성에 잘못된 값이 포함되어 있습니다. 지속적인 브로드캐스트의 프로젝션을 360으로 설정할 수 없습니다. |
invalidValue (400) |
invalidScheduledEndTime |
liveBroadcast 리소스의 snippet.scheduledEndTime 속성에 잘못된 값이 포함되어 있습니다. 예약된 종료 시간은 예약된 시작 시간 이후여야 합니다. |
invalidValue (400) |
invalidScheduledStartTime |
liveBroadcast 리소스의 snippet.scheduledStartTime 속성에 잘못된 값이 포함되어 있습니다. 예약된 시작 시간은 미래여야 합니다. |
invalidValue (400) |
invalidTitle |
liveBroadcast 리소스에 snippet.title 속성의 유효한 값이 지정되지 않았습니다. snippet.title 은 1~100자(영문 기준)여야 합니다. |
notFound (404) |
liveBroadcastNotFound |
liveBroadcast 리소스에 지정된 id 속성이 브로드캐스트를 식별하지 못했습니다. |
required (400) |
broadcastStreamDelayMsRequired |
liveBroadcast 리소스에 contentDetails.monitorStream.broadcastStreamDelayMs 속성이 지정되지 않았습니다. |
required (400) |
enableMonitorStreamRequired |
liveBroadcast 리소스에 contentDetails.monitorStream.enableMonitorStream 속성이 지정되지 않았습니다. |
required (400) |
idRequired |
liveBroadcast 리소스는 id 속성의 값을 포함하고 지정해야 합니다. |
required (400) |
privacyStatusRequired |
liveBroadcast 리소스에 공개 상태가 지정되지 않았습니다. 유효한 privacyStatus 값을 참고하세요. |
required (400) |
scheduledEndTimeRequired |
liveBroadcast 리소스에 snippet.scheduledEndTime 속성이 지정되지 않았습니다. |
required (400) |
scheduledStartTimeRequired |
liveBroadcast 리소스에 snippet.scheduledStartTime 속성이 지정되지 않았습니다. |
required (400) |
titleRequired |
liveBroadcast 리소스에 snippet.title 속성이 지정되지 않았습니다. |
liveBroadcasts.cuepoint
오류 유형 |
오류 세부정보 |
설명 |
insufficientPermissions (403) |
insufficientLivePermissions |
요청에 라이브 방송에 큐 포인트를 삽입할 권한이 없습니다. |
insufficientPermissions (403) |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://support.google.com/youtube/answer/2474026 및 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
사용자가 지정된 기간 내에 너무 많은 요청을 보냈습니다. |
required (400) |
idRequired |
필수 id 매개변수는 큐포인트를 삽입할 방송을 식별해야 합니다. |
required (400) |
cueTypeRequired |
필수 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
다음 표에는 liveChatBans
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
liveChatBans.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
지정된 차단을 삭제할 수 없습니다. 이 오류는 다른 운영자의 차단을 해제하려고 하는 한 운영자가 요청을 승인하는 경우 발생할 수 있습니다. |
forbidden (403) |
insufficientPermissions |
지정된 차단을 삭제하는 데 필요한 권한이 없습니다. |
invalidValue (400) |
invalidLiveChatBanId |
id 매개변수가 잘못된 값을 지정합니다. |
notFound (404) |
liveChatBanNotFound |
지정된 차단을 찾을 수 없습니다. |
liveChatBans.insert
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
insufficientPermissions |
지정된 실시간 채팅에서 사용자를 차단하는 데 필요한 권한이 없습니다. |
forbidden (403) |
liveChatBanInsertionNotAllowed |
지정된 차단을 만들 수 없습니다. 이 오류는 요청에서 채팅 소유자 또는 다른 운영자를 차단하려고 시도하는 경우 발생할 수 있습니다. |
invalidValue (400) |
invalidChannelId |
지정된 채널 ID를 찾을 수 없습니다. |
invalidValue (400) |
invalidLiveChatId |
요청에 지정된 snippet.liveChatId 값이 잘못되었습니다. 연결된 liveBroadcast 리소스를 확인하여 올바른 값이 있는지 확인합니다. |
notFound (404) |
liveChatNotFound |
지정된 실시간 채팅을 찾을 수 없습니다. 연결된 liveBroadcast 리소스를 확인하여 snippet.liveChatId 속성이 올바른 값으로 설정되어 있는지 확인합니다. |
notFound (404) |
liveChatUserNotFound |
차단하려는 실시간 채팅 사용자를 찾을 수 없습니다. |
required (400) |
bannedUserChannelIdRequired |
요청 본문에 제출된 liveChatBan 리소스는 snippet.bannedUserDetails.channelId 속성의 값을 지정해야 합니다. |
required (400) |
liveChatIdRequired |
요청 본문에 제출된 liveChatBan 리소스는 snippet.liveChatId 속성의 값을 지정해야 합니다. |
liveChatMessages
다음 표에는 liveChatMessages
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
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
다음 표에는 liveCuepoints
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
liveCuepoints.insert
오류 유형 |
오류 세부정보 |
설명 |
invalidValue (400) |
conflictingTimeFields |
offsetTimeMs 및 walltime 중 하나만 지정할 수 있습니다. |
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의 새로고침 빈도보다 더 자주 전송되어 불필요하게 대역폭이 낭비되는 경우에 발생합니다. |
liveCuepoints
다음 표에는 liveCuepoints
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
liveCuepoints.insert
오류 유형 |
오류 세부정보 |
설명 |
invalidValue (400) |
conflictingTimeFields |
offsetTimeMs 및 walltime 중 하나만 지정할 수 있습니다. |
liveStreams
다음 표에는 liveStreams
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다.
liveStreams.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
liveStreamDeletionNotAllowed |
아직 완료되지 않은 방송에 바인딩되어 있으므로 지정된 라이브 스트림을 삭제할 수 없습니다. |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 스트림을 삭제할 권한이 없습니다. 자세한 내용은 OAuth 2.0 인증 구현을 참고하세요. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 자세한 내용은 기능 자격 요건을 참고하세요. |
notFound (404) |
liveStreamNotFound |
지정된 라이브 스트림이 존재하지 않습니다. |
liveStreams.insert
오류 유형 |
오류 세부정보 |
설명 |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 스트림을 만들 권한이 없습니다. |
insufficientPermissions |
livePermissionBlocked |
요청을 승인한 사용자가 현재 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자가 라이브 동영상을 스트리밍할 수 없는 이유를 설명하는 세부정보는 https://www.youtube.com/features의 사용자 채널 설정에서 확인할 수 있습니다. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
invalidValue (400) |
invalidDescription |
liveStream 리소스의 snippet.description 속성 값은 최대 10,000자(영문 기준)까지 입력할 수 있습니다. |
invalidValue (400) |
invalidFormat |
liveStream 리소스의 cdn.format 속성 값이 잘못되었습니다. |
invalidValue (400) |
invalidFrameRate |
liveStream 리소스의 cdn.frameRate 속성 값이 잘못되었습니다. |
invalidValue (400) |
invalidIngestionType |
liveStream 리소스의 cdn.ingestionType 속성 값이 잘못되었습니다. |
invalidValue (400) |
invalidResolution |
liveStream 리소스의 cdn.resolution 속성 값이 잘못되었습니다. |
invalidValue (400) |
invalidTitle |
liveStream 리소스의 snippet.title 속성 값은 1~128자(영문 기준)여야 합니다. |
rateLimitExceeded |
userRequestsExceedRateLimit |
사용자가 지정된 기간 내에 너무 많은 요청을 보냈습니다. |
required (400) |
cdnRequired |
liveStream 리소스에는 cdn 객체가 포함되어야 합니다. |
required (400) |
frameRateRequired |
cdn.resolution 속성에는 값을 지정했지만 cdn.frameRate 속성에는 값을 지정하지 않은 경우 API에서 이 오류를 반환합니다. |
required (400) |
ingestionTypeRequired |
liveStream 리소스는 cdn.ingestionType 속성의 값을 지정해야 합니다. |
required (400) |
resolutionRequired |
cdn.frameRate 속성에는 값을 지정했지만 cdn.resolution 속성에는 값을 지정하지 않은 경우 API에서 이 오류를 반환합니다. |
required (400) |
titleRequired |
liveStream 리소스는 snippet.title 속성 값을 지정해야 합니다. |
liveStreams.list
오류 유형 |
오류 세부정보 |
설명 |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 스트림을 가져올 권한이 없습니다. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
liveStreams.update
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
liveStreamModificationNotAllowed |
현재 상태에서는 지정된 라이브 스트림을 수정할 수 없습니다. 자세한 내용은 브로드캐스트 수명을 참고하세요. |
forbidden (403) |
liveStreamModificationNotAllowed |
스트림이 생성된 후에는 API에서 cdn.format , cdn.frameRate , cdn.ingestionType , cdn.resolution 필드의 값을 변경할 수 없습니다. |
forbidden (403) |
liveStreamModificationNotAllowed |
API를 사용하면 재사용 가능한 스트림을 재사용 불가능한 스트림으로 변경하거나 그 반대로 변경할 수 없습니다. 자세한 내용은 브로드캐스트 및 스트림 이해하기를 참고하세요. |
insufficientPermissions |
insufficientLivePermissions |
요청에 지정된 라이브 스트림을 업데이트할 권한이 없습니다. 자세한 내용은 OAuth2 인증 구현을 참고하세요. |
insufficientPermissions |
liveStreamingNotEnabled |
요청을 승인한 사용자가 YouTube에서 라이브 동영상을 스트리밍할 수 없습니다. 사용자는 https://www.youtube.com/features에서 자세한 내용을 확인할 수 있습니다. |
invalidValue (400) |
invalidDescription |
liveStream 리소스의 snippet.description 속성 값은 최대 10,000자(영문 기준)까지 입력할 수 있습니다. |
invalidValue (400) |
invalidTitle |
liveStream 리소스의 snippet.title 속성 값은 1~128자(영문 기준)여야 합니다. |
notFound (404) |
liveStreamNotFound |
지정된 라이브 스트림이 존재하지 않습니다. |
required (400) |
idRequired |
liveStream 리소스는 id 속성의 값을 지정해야 합니다. |
required (400) |
ingestionTypeRequired |
liveStream 리소스는 cdn.ingestionType 속성의 값을 지정해야 합니다. |
required (400) |
titleRequired |
liveStream 리소스는 snippet.title 속성의 값을 지정해야 합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[[["\u003cp\u003eThe API returns \u003ccode\u003eforbidden (403)\u003c/code\u003e or \u003ccode\u003einsufficientPermissions\u003c/code\u003e errors when a user lacks the necessary authorization to perform an action, such as creating, deleting, or viewing resources.\u003c/p\u003e\n"],["\u003cp\u003eSeveral API calls related to live broadcasts, streams, and cuepoints may return a \u003ccode\u003eliveStreamingNotEnabled\u003c/code\u003e error, which means that the user has not enabled live streaming for their channel.\u003c/p\u003e\n"],["\u003cp\u003eMany errors across different API resources are caused by \u003ccode\u003einvalidValue (400)\u003c/code\u003e issues, including invalid descriptions, titles, privacy status, or time-related fields, which indicate that the provided data does not meet the required criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequests can fail with a \u003ccode\u003erateLimitExceeded\u003c/code\u003e error if a user surpasses the allowed request rate, which could happen in multiple \u003ccode\u003eliveBroadcasts\u003c/code\u003e, \u003ccode\u003eliveChatMessages\u003c/code\u003e, or \u003ccode\u003eliveStreams\u003c/code\u003e operations.\u003c/p\u003e\n"],["\u003cp\u003eMany errors indicate a \u003ccode\u003enotFound (404)\u003c/code\u003e issue, indicating that a broadcast, stream, chat, message, or ban cannot be located, which often signals an incorrect or deleted resource.\u003c/p\u003e\n"]]],["The document details error scenarios within the YouTube Live API, categorized by function. `fanFundingEvents.list` can fail due to insufficient permissions or disabled Fan Funding. Live broadcast actions (`bind`, `delete`, `insert`, `list`, `transition`, `update`) often fail from user permission issues, missing parameters, invalid values, or exceeding limits. Live chat interactions (`bans`, `messages`) face issues with permissions, invalid IDs, missing data, and rate limits. `liveCuepoints` and `liveStreams` can encounter similar errors, including issues with missing data, incorrect configuration, or forbidden actions. `sponsors.list` can be blocked due to permissions or disabled sponsorship.\n"],null,[]]