YouTube Data API - Errors
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에서는 YouTube Data API 작업에서 반환할 수 있는 여러 유형의 오류를 설명합니다. 개별 메소드의 오류 목록은 해당 메소드의 참조 문서에서도 확인할 수 있습니다.
일반적인 오류
다음 표에서는 특정 API 메서드에 국한되지 않는 API 오류 메시지를 확인합니다.
Core API errors
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
액세스가 금지되었습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
quotaExceeded (403) |
quotaExceeded |
할당량을 초과했기 때문에 요청을 완료할 수 없습니다. |
Common request errors
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
incompatibleParameters |
요청이 같은 요청에 사용할 수 없는 둘 이상의 매개변수를 지정합니다. |
badRequest (400) |
invalidFilters |
요청이 잘못된 필터 매개변수를 지정합니다. |
badRequest (400) |
invalidPageToken |
요청이 잘못된 페이지 토큰을 지정합니다. |
badRequest (400) |
missingRequiredParameter |
요청에 필수 매개변수가 없습습니다. |
badRequest (400) |
unexpectedParameter |
요청이 예기치 않은 매개변수를 지정합니다. |
forbidden (403) |
accountDelegationForbidden |
인증된 사용자는 지정된 Google 계정을 대신하여 작업할 수 없습니다. |
forbidden (403) |
authenticatedUserAccountClosed |
인증된 사용자의 YouTube 계정이 해지되었습니다. 인증된 사용자가 다른 Google 계정을 대신하여 활동하는 경우 이 오류는 Google 계정 대신에 표시됩니다. |
forbidden (403) |
authenticatedUserAccountSuspended |
인증된 사용자의 YouTube 계정이 일시중지되었습니다. 인증된 사용자가 다른 Google 계정을 대신하여 활동하는 경우 이 오류는 Google 계정 대신에 표시됩니다. |
forbidden (403) |
authenticatedUserNotChannel |
이 요청의 경우 인증된 사용자가 채널을 확인해야 하지만 그렇게 하지 않습니다. 요청이 인증되고 onBehalfOfContentOwner 위임 매개변수를 사용하는 경우 onBehalfOfContentOwnerChannel 매개변수도 설정해야 합니다. |
forbidden (403) |
channelClosed |
요청에서 확인ㄷ 채널이 삭제되었습니다. |
forbidden (403) |
channelNotFound |
요청에서 확인된 채널을 찾을 수 없습니다. |
forbidden (403) |
channelSuspended |
요청에서 확인된 채널이 일시 중지되었습니다. |
forbidden (403) |
cmsUserAccountNotFound |
CMS 사용자는 지정된 콘텐츠 소유자를 대신하여 작업할 수 없습니다. |
forbidden (403) |
insufficientCapabilities |
CMS 사용자의 권한이 충분하지 않습니다. |
forbidden (403) |
insufficientPermissions |
요청에 제공된 OAuth 2.0 토큰이 요청된 데이터에 액세스하기에 충분하지 않은 범위를 지정합니다. |
notFound (404) |
contentOwnerAccountNotFound |
지정된 콘텐츠 소유자 계정을 찾을 수 없습니다. |
Request context errors
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
invalidLanguage |
hl 매개변수 값이 유효한 언어 코드를 지정하지 않습니다. |
badRequest (400) |
invalidMine |
요청의 mine 매개변수 사용이 지원되지 않습니다. |
badRequest (400) |
invalidMine |
인증된 사용자가 YouTube 파트너인 요청에는 mine 매개변수를 사용할 수 없습니다. mine 매개변수를 삭제하거나, onBehalfOfContentOwner 매개변수를 삭제하여 YouTube 사용자로 인증하거나, 호출된 메서드에 사용할 수 있는 경우 onBehalfOfContentOwnerChannel 매개변수를 제공하여 파트너 채널 중 하나로 활동해야 합니다. |
badRequest (400) |
invalidPart |
요청의 part 매개변수가 동시에 작성할 수 없는 부분을 지정합니다. |
badRequest (400) |
invalidRegionCode |
regionCode 매개변수가 잘못된 지역 코드를 지정합니다. |
badRequest (400) |
unexpectedPart |
요청의 part 매개변수가 예기치 않은 값을 지정합니다. |
badRequest (400) |
unknownPart |
요청의 part 매개변수가 알 수 없는 값을 지정합니다. |
badRequest (400) |
unsupportedLanguageCode |
hl 매개변수 값이 지원되는 언어 코드를 지정하지 않습니다. |
badRequest (400) |
unsupportedRegionCode |
regionCode 매개변수가 지원되지 않는 지역 코드를 지정합니다. |
unauthorized (401) |
authorizationRequired |
요청이 mine 매개변수를 사용하지만 제대로 승인되지 않았습니다. |
unauthorized (401) |
youtubeSignupRequired |
이 오류는 사용자에게 연결되지 않은 Google 계정이 있음을 나타냅니다. 즉, Google 계정이 있지만 YouTube 채널은 없습니다. 이러한 사용자는 사용자 인증에 따라 동영상을 평가하거나 watch_later 재생목록에 동영상을 추가하는 등 다양한 기능에 액세스할 수 있습니다. 하지만 동영상을 업로드하려면 YouTube 채널이 필요합니다. Gmail 계정 또는 Android 기기가 있는 사용자는 Google 계정이 있을 것이 분명하지만 해당 Google 계정을 YouTube 채널에 아직 연결하지 않았을 수 있습니다.
이 오류는 OAuth 2.0 서비스 계정 흐름을 사용하려고 할 때 흔히 발생합니다. YouTube는 서비스 계정을 지원하지 않으며 서비스 계정을 사용하여 인증하려고 하면 이 오류가 발생합니다.
Google 계정 지원을 소개하는 YouTube API 블로그 게시물에서도 youtubeSignupRequired 오류에 대해 자세히 설명합니다. 게시물에서 설명하는 오류는 API 버전 2.1이지만 오류의 의미는 같습니다. |
activities
다음 표에서는 activities
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
activities.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
homeParameterDeprecated |
사용자의 홈페이지 활동 데이터는 이 API를 통해 사용할 수 없습니다. 이 오류는 승인되지 않은 요청에서 home 매개변수를 true 로 설정한 경우 발생할 수 있습니다. |
forbidden (403) |
forbidden |
요청이 제대로 인증되지 않았습니다. |
notFound (404) |
channelNotFound |
요청의 channelId 매개변수로 식별된 채널 ID를 찾을 수 없습니다. |
notFound (404) |
homeChannelNotFound |
현재 인증된 사용자에 대한 YouTube 홈페이지 피드를 찾을 수 없습니다. |
unauthorized (401) |
authorizationRequired |
요청이 home 매개변수를 사용하지만 제대로 승인되지 않았습니다. |
captions
다음 표에서는 captions
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
captions.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
요청과 연결된 권한으로는 자막 트랙을 삭제할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
notFound (404) |
captionNotFound |
자막 트랙을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
captions.download
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
요청과 관련된 권한으로는 자막 트랙을 다운로드할 수 없습니다. 요청이 제대로 승인되지 않았거나 동영상 주문에 이 자막에 대한 제3자 제공 기능이 사용 설정되지 않았을 수 있습니다. |
invalidValue (400) |
couldNotConvert |
자막 트랙 데이터를 요청한 언어 또는 형식으로 변환할 수 없습니다. 요청된 tfmt 및 tlang 값이 유효하고 요청된 자막 트랙의 snippet.status 가 failed 이 아닌지 확인합니다. |
notFound (404) |
captionNotFound |
자막 트랙을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
captions.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
contentRequired |
요청에 자막 트랙 콘텐츠가 포함되어 있지 않습니다. |
conflict (409) |
captionExists |
지정한 동영상에 이미 snippet.language 및 snippet.name 을(를) 사용하는 자막 트랙이 있습니다. 한 동영상에 동일한 언어의 트랙이 여러 개 포함될 수 있지만 각 트랙의 이름은 달라야 합니다.
오류를 해결하는 방법에는 여러 가지가 있습니다. 기존 트랙을 삭제한 다음 새 트랙을 삽입하거나 삽입하기 전에 새 트랙의 이름을 변경할 수 있습니다. |
forbidden (403) |
forbidden |
요청과 연결된 권한으로는 자막 트랙을 업로드할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
invalidValue (400) |
invalidMetadata |
요청에 잘못된 메타데이터 값이 포함되어 있어 트랙을 만들 수 없습니다. 요청이 snippet.language , snippet.name , snippet.videoId 속성에 유효한 값을 지정하는지 확인합니다. snippet.isDraft 속성도 포함할 수 있지만 필수는 아닙니다. |
notFound (404) |
videoNotFound |
videoId 매개변수로 식별된 동영상을 찾을 수 없습니다. |
invalidValue (400) |
nameTooLong |
요청에 지정된 snippet.name 이(가) 너무 깁니다. 지원되는 최대 길이는 150자(영문 기준)입니다. |
captions.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
요청과 연결된 권한이 요청된 리소스를 검색하기에 충분하지 않아 하나 이상의 자막 트랙을 가져올 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
notFound (404) |
captionNotFound |
지정된 자막 트랙 중 하나 이상을 찾을 수 없습니다. 이 오류는 videoId 매개변수가 실제 동영상을 식별하지만 id 매개변수가 존재하지 않는 자막 트랙 ID를 식별하거나 다른 동영상과 연결된 트랙 ID를 식별하는 경우에 발생합니다. 요청의 id 및 videoId 매개변수 값이 올바른지 확인하세요. |
notFound (404) |
videoNotFound |
videoId 매개변수로 식별된 동영상을 찾을 수 없습니다. |
captions.update
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
contentRequired |
요청이 업데이트된 자막 파일을 업로드하지 않았습니다. sync 매개변수가 true 로 설정된 경우 실제 트랙 콘텐츠가 필요합니다. |
forbidden (403) |
forbidden |
요청과 연결된 권한으로는 자막 트랙을 업데이트할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
notFound (404) |
captionNotFound |
지정한 자막 트랙을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
channelBanners
다음 표에서는 channelBanners
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
channelBanners.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
bannerAlbumFull |
YouTube 채널 아트 앨범에 이미지가 너무 많습니다. http://photos.google.com에서 앨범 페이지로 이동하여 해당 앨범의 이미지에서 일부를 삭제하세요. |
badRequest (400) |
mediaBodyRequired |
요청에 이미지 콘텐츠가 포함되어 있지 않습니다. |
channelSections
다음 표에서는 channelSections
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
channelSections.delete
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
notEditable |
이 채널 섹션은 삭제할 수 없습니다. |
forbidden (403) |
channelSectionForbidden |
요청이 제대로 인증되지 않았거나 이 채널에서 지원하지 않습니다. |
invalidValue (400) |
idInvalid |
id 속성이 잘못된 채널 섹션 ID를 지정합니다. |
invalidValue (400) |
idRequired |
id 속성은 삭제되는 채널 섹션을 식별하는 값을 지정해야 합니다. |
notFound (404) |
channelNotFound |
채널을 찾을 수 없습니다. |
notFound (404) |
channelSectionNotFound |
업데이트하려는 채널 섹션을 찾을 수 없습니다. |
channelSections.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSetError |
해당 리소스의 localizations 객체를 삽입하거나 업데이트하려면 channelSection 리소스의 snippet.defaultLanguage 속성을 설정해야 합니다. |
badRequest (400) |
invalidLanguage |
localizations 객체의 언어 키 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
notEditable |
이 채널 섹션을 만들 수 없습니다. |
badRequest (400) |
styleRequired |
channelSection 리소스는 snippet.style 필드의 값을 지정해야 합니다. |
badRequest (400) |
targetInvalidCountry |
targeting.countries 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
targetInvalidLanguage |
targeting.languages 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
targetInvalidRegion |
targeting.regions 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
typeRequired |
channelSection 리소스는 snippet.type 필드의 값을 지정해야 합니다. |
forbidden (403) |
channelSectionForbidden |
요청이 제대로 인증되지 않았거나 이 채널에서 지원되지 않습니다. |
invalidValue (400) |
channelNotActive |
지정된 채널 중 하나 이상이 활성 상태가 아닙니다. |
invalidValue (400) |
channelsDuplicated |
중복된 채널이 지정되어 요청이 실패했습니다. |
invalidValue (400) |
channelsNeeded |
snippet.type 속성의 값이 multipleChannels 인 경우 contentDetails.channels[] 속성을 지정해야 하며 채널을 하나 이상 지정해야 합니다. |
invalidValue (400) |
channelsNotExpected |
요청과 함께 제공된 리소스가 contentDetails.channels[] 속성 값을 지정했지만 이 유형의 채널 섹션에는 채널이 필요하지 않습니다. |
invalidValue (400) |
contentDetailsNeeded |
삽입하는 리소스는 이 유형의 채널 섹션을 위한 contentDetails 객체를 포함해야 합니다. |
invalidValue (400) |
inValidPosition |
snippet.position 속성에 잘못된 값이 포함되어 있습니다. |
invalidValue (400) |
maxChannelSectionExceeded |
채널에 이미 최대 개수의 채널 섹션이 있으므로 요청을 완료할 수 없습니다. |
invalidValue (400) |
maxChannelsExceeded |
채널 섹션에 너무 많은 채널을 포함하려고 하여 요청이 실패했습니다. |
invalidValue (400) |
maxPlaylistExceeded |
채널 섹션에 너무 많은 재생목록을 포함하려고 하여 요청이 실패했습니다. |
invalidValue (400) |
onePlaylistNeeded |
snippet.type 속성의 값이 singlePlaylist 인 경우 contentDetails.playlists[] 속성은 정확히 하나의 재생목록을 지정해야 합니다. |
invalidValue (400) |
ownChannelInChannels |
채널에 표시되는 채널 섹션에는 내 채널을 포함할 수 없습니다. |
invalidValue (400) |
playlistIsPrivate |
지정된 재생목록 중 하나 이상이 비공개 재생목록이므로 채널 섹션에 포함될 수 없습니다. |
invalidValue (400) |
playlistsDuplicated |
중복 재생목록을 지정했기 때문에 요청이 실패했습니다. |
invalidValue (400) |
playlistsNeeded |
snippet.type 속성의 값이 singlePlaylist 또는 multiplePlaylists 이면 contentDetails.playlists[] 속성을 지정해야 합니다. |
invalidValue (400) |
playlistsNotExpected |
요청과 함께 제공된 리소스가 contentDetails.playlists[] 속성 값을 지정했지만 이 유형의 채널 섹션에는 재생목록이 필요하지 않습니다. |
invalidValue (400) |
snippetNeeded |
채널 섹션을 만들려면 snippet 를 지정해야 합니다. |
invalidValue (400) |
titleLengthExceeded |
snippet.title 속성의 값이 너무 깁니다. |
invalidValue (400) |
titleRequired |
snippet.type 속성의 값이 multiplePlaylists 또는 multipleChannels 이면 snippet.title 속성의 값을 지정하여 섹션의 제목을 설정해야 합니다. |
notFound (404) |
channelNotFound |
지정된 채널 중 하나 이상을 찾을 수 없습니다. |
notFound (404) |
playlistNotFound |
지정된 재생 목록을 하나 이상 찾을 수 없습니다. |
channelSections.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
channelSectionForbidden |
요청자는 요청한 채널 섹션에 액세스할 수 없습니다. |
invalidValue (400) |
idInvalid |
요청이 잘못된 채널 섹션 ID를 지정합니다. |
invalidValue (400) |
invalidCriteria |
필터 기준이 잘못되어 요청을 완료할 수 없습니다. |
notFound (404) |
channelNotFound |
요청과 연결된 채널을 찾을 수 없습니다. |
notFound (404) |
channelSectionNotFound |
요청과 연결된 채널 섹션을 찾을 수 없습니다. |
channelSections.update
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSetError |
해당 리소스의 localizations 객체를 삽입하거나 업데이트하려면 channelSection 리소스의 snippet.defaultLanguage 속성을 설정해야 합니다. |
badRequest (400) |
invalidLanguage |
localizations 객체의 언어 키 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
notEditable |
이 채널 섹션은 수정할 수 없습니다. |
badRequest (400) |
styleRequired |
channelSection 리소스는 snippet.style 필드의 값을 지정해야 합니다. |
badRequest (400) |
targetInvalidCountry |
targeting.countries 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
targetInvalidLanguage |
targeting.languages 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
targetInvalidRegion |
targeting.regions 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 검색하고 a href="/youtube/v3/docs/channelSections#resource">channelSections 리소스 문서의 가이드라인에 따라 값을 업데이트합니다. |
badRequest (400) |
typeRequired |
channelSection 리소스는 snippet.type 필드의 값을 지정해야 합니다. |
forbidden (403) |
channelSectionForbidden |
요청이 제대로 인증되지 않았거나 이 채널에서 지원되지 않습니다. |
invalidValue (400) |
channelNotActive |
지정된 채널 중 하나 이상이 활성 상태가 아닙니다. |
invalidValue (400) |
channelsDuplicated |
중복된 채널이 지정되어 요청이 실패했습니다. |
invalidValue (400) |
channelsNeeded |
snippet.type 속성의 값이 multipleChannels 인 경우 contentDetails.channels[] 속성을 지정해야 하며 채널을 하나 이상 지정해야 합니다. |
invalidValue (400) |
channelsNotExpected |
요청과 함께 제공된 리소스가 contentDetails.channels[] 속성 값을 지정했지만 이 유형의 채널 섹션에는 채널이 필요하지 않습니다. |
invalidValue (400) |
contentDetailsNeeded |
업데이트하려는 리소스는 이 유형의 채널 섹션에 대한 contentDetails 객체를 포함해야 합니다. |
invalidValue (400) |
idInvalid |
id 속성이 잘못된 채널 섹션 ID를 지정합니다. |
invalidValue (400) |
idRequired |
id 속성은 업데이트 중인 채널 섹션을 식별하는 값을 지정해야 합니다. |
invalidValue (400) |
inValidPosition |
snippet.position 속성에 잘못된 값이 포함되어 있습니다. |
invalidValue (400) |
maxChannelsExceeded |
채널 섹션에 너무 많은 채널을 포함하려고 하여 요청이 실패했습니다. |
invalidValue (400) |
maxPlaylistExceeded |
채널 섹션에 너무 많은 재생목록을 포함하려고 하여 요청이 실패했습니다. |
invalidValue (400) |
onePlaylistNeeded |
snippet.type 속성의 값이 singlePlaylist 인 경우 contentDetails.playlists[] 속성은 정확히 하나의 재생목록을 지정해야 합니다. |
invalidValue (400) |
ownChannelInChannels |
채널에 표시되는 채널 섹션에는 내 채널을 포함할 수 없습니다. |
invalidValue (400) |
playlistIsPrivate |
지정된 재생목록 중 하나 이상이 비공개 재생목록이므로 채널 섹션에 포함될 수 없습니다. |
invalidValue (400) |
playlistsDuplicated |
중복 재생목록을 지정했기 때문에 요청이 실패했습니다. |
invalidValue (400) |
playlistsNeeded |
snippet.type 속성의 값이 singlePlaylist 또는 multiplePlaylists 이면 contentDetails.playlists[] 속성을 지정해야 합니다. |
invalidValue (400) |
playlistsNotExpected |
요청과 함께 제공된 리소스가 contentDetails.playlists[] 속성 값을 지정했지만 이 유형의 채널 섹션에는 재생목록이 필요하지 않습니다. |
invalidValue (400) |
snippetNeeded |
채널 섹션을 업데이트하려면 snippet 를 지정해야 합니다. |
invalidValue (400) |
titleLengthExceeded |
snippet.title 속성의 값이 너무 깁니다. |
invalidValue (400) |
titleRequired |
snippet.type 속성의 값이 multiplePlaylists 또는 multipleChannels 이면 snippet.title 속성의 값을 지정하여 섹션의 제목을 설정해야 합니다. |
notFound (404) |
channelNotFound |
지정된 채널 중 하나 이상을 찾을 수 없습니다. |
notFound (404) |
channelSectionNotFound |
업데이트하려는 채널 섹션을 찾을 수 없습니다. |
notFound (404) |
playlistNotFound |
지정된 재생 목록을 하나 이상 찾을 수 없습니다. |
채널
다음 표에서는 channels
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
channels.list
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
invalidCriteria |
필터 id , mySubscribers , categoryId , mine , managedByMe , forUsername 중 최대 하나를 지정할 수 있습니다. onBehalfOfContentOwner 매개변수를 사용하는 콘텐츠 소유자 인증의 경우 id 또는 managedByMe 만 지정할 수 있습니다. |
forbidden (403) |
channelForbidden |
id 매개변수로 지정된 채널이 요청을 지원하지 않거나 요청이 제대로 승인되지 않았습니다. |
notFound (404) |
categoryNotFound |
categoryId 매개변수로 식별된 카테고리를 찾을 수 없습니다. 유효한 값 목록을 검색하려면 guideCategories.list 메서드를 사용하세요. |
notFound (404) |
channelNotFound |
id 매개변수에 지정된 채널을 찾을 수 없습니다. |
channels.update
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
brandingValidationError |
brandingSettings 객체의 값 중 하나가 유효성 검사에 실패했습니다. channels.list 메서드를 사용하여 채널의 기존 설정을 검색하고 channels 리소스 문서의 가이드라인에 따라 속성 값을 업데이트합니다. |
badRequest (400) |
channelTitleUpdateForbidden |
채널의 brandingSettings part 를 업데이트할 때 brandingSettings.channel.title 속성 값을 채널의 현재 제목으로 설정하거나 속성을 생략해야 합니다. 속성 값을 변경하면 API에서 오류를 반환합니다. |
badRequest (400) |
defaultLanguageNotSetError |
localizations 를 업데이트하도록 defaultLanguage 를 설정해야 합니다. |
badRequest (400) |
invalidBrandingOption |
지정한 브랜드 설정 중 하나가 존재하지 않습니다. channels.list 메서드를 사용하여 유효한 값을 검색하고 channels 리소스 문서의 가이드라인에 따라 업데이트해야 합니다. |
badRequest (400) |
invalidCustomMessage |
요청 메타데이터가 잘못된 커스텀 메시지를 지정합니다. 요청이 보낸 리소스에서 invideoPromotion.items[].customMessage 속성 값을 확인합니다. |
badRequest (400) |
invalidDuration |
요청 메타데이터가 invideoPromo 부분에 잘못된 길이를 지정합니다. |
badRequest (400) |
invalidDuration |
요청 메타데이터가 프로모션 항목을 동영상 플레이어에 배치하는 방식을 결정하기 위해 지정한 위치 유형이 잘못되었습니다. 요청이 보낸 리소스에서 invideoPromotion.position.type 속성 값을 확인합니다. |
badRequest (400) |
invalidRecentlyUploadedBy |
요청 메타데이터가 잘못된 채널 ID를 지정합니다. 요청이 보낸 리소스에서 invideoPromotion.items[].id.recentlyUploadedBy 속성 값을 확인합니다. |
badRequest (400) |
invalidTimingOffset |
요청 메타데이터가 invideoPromo 부분에 잘못된 타이밍 오프셋을 지정합니다. |
badRequest (400) |
invalidTimingOffset |
요청 메타데이터가 프로모션 항목을 동영상 플레이어에 표시할 시기를 결정하기 위해 지정한 타이밍 오프셋이 잘못되었습니다. 요청이 보낸 리소스에서 invideoPromotion.timing.offsetMs 속성 값을 확인합니다. |
badRequest (400) |
invalidTimingType |
요청 메타데이터가 프로모션 항목을 동영상 플레이어에 표시할 시기를 결정하기 위해 지정한 타이밍 메서드가 잘못되었습니다. 요청이 보낸 리소스에서 invideoPromotion.timing.type 속성 값을 확인합니다. |
badRequest (400) |
localizationValidationError |
현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. channels.list 메서드를 사용해 유효한 값을 검색하고 channels.list의 가이드라인에 따라 값을 업데이트해야 합니다. |
badRequest (400) |
tooManyPromotedItems |
invideoPromo 부분에서 허용된 프로모션 항목 수를 초과했습니다. |
forbidden (403) |
channelForbidden |
id 매개변수에 지정된 채널이 요청을 지원하지 않거나 요청이 제대로 승인되지 않았습니다. |
forbidden (403) |
promotedVideoNotAllowed |
API 요청이 업데이트하려는 채널을 찾을 수 없습니다. 요청이 보낸 channel 리소스에서 id 속성 값을 확인하여 채널 ID가 올바른지 확인합니다. |
forbidden (403) |
websiteLinkNotAllowed |
지정된 웹사이트 URL은 사용할 수 없습니다. |
notFound (404) |
channelNotFound |
id 매개변수로 지정된 채널을 찾을 수 없거나 브랜드 옵션이 없습니다. |
notFound (404) |
channelNotFound |
id 매개변수에 지정된 채널을 찾을 수 없습니다. |
notFound (404) |
unknownChannelId |
지정된 채널 ID를 찾을 수 없습니다. |
notFound (404) |
unknownChannelId |
지정된 currentUploadedBy 채널 ID를 찾을 수 없습니다. |
notFound (404) |
unknownVideoId |
프로모션 항목으로 지정한 동영상 ID를 찾을 수 없습니다. |
required (400) |
requiredItemIdType |
요청 메타데이터는 invideoPromo 부분에 항목 유형을 지정해야 합니다. |
required (400) |
requiredItemId |
요청 메타데이터가 invideoPromo 부분에 항목을 지정해야 합니다. |
required (400) |
requiredTimingOffset |
YouTube가 프로모션 항목을 표시할 시기를 결정할 수 있도록 요청 메타데이터가 기본 타이밍 오프셋을 지정해야 합니다. 요청이 보내는 리소스에서 invideoPromotion.defaultTiming.offsetMs 속성 값을 설정합니다. |
required (400) |
requiredTimingOffset |
YouTube가 프로모션 항목을 표시할 시기를 결정할 수 있도록 요청 메타데이터가 타이밍 오프셋을 지정해야 합니다. 요청이 보내는 리소스에서 invideoPromotion.timing.offsetMs 속성 값을 설정합니다. |
required (400) |
requiredTimingType |
YouTube가 프로모션 항목을 표시할 시기를 결정할 수 있도록 요청 메타데이터가 타이밍 메서드를 지정해야 합니다. 요청이 보내는 리소스에서 invideoPromotion.defaultTiming.type 속성 값을 설정합니다. |
required (400) |
requiredTimingType |
YouTube가 프로모션 항목을 표시할 시기를 결정할 수 있도록 요청 메타데이터가 타이밍 메서드를 지정해야 합니다. 요청이 보내는 리소스에서 invideoPromotion.timing.type 속성 값을 설정합니다. |
required (400) |
requiredTiming |
요청 메타데이터는 invideoPromotion 부분에 있는 각 항목의 타이밍을 지정해야 합니다. |
required (400) |
requiredVideoId |
프로모션 항목을 구분하기 위해 요청 메타데이터가 동영상 ID를 지정해야 합니다. |
required (400) |
requiredWebsiteUrl |
요청 메타데이터는 invideoPromotion 부분에 웹사이트 URL을 지정해야 합니다. 요청이 보내는 리소스에서 invideoPromotion.items[].id.websiteUrl 속성 값을 설정합니다. |
멤버
다음 표에서는 members
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
members.list
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
channelMembershipsNotEnabled |
요청을 승인하는 크리에이터 채널에 채널 멤버십이 사용 설정되지 않았습니다. |
badRequest (400) |
invalidMode |
mode 매개변수 값이 잘못되었습니다.
이 오류는 pageToken 매개변수가 지정된 모드가 아닌 다른 모드를 사용하여 가져온 토큰을 지정하는 경우에 발생할 수 있습니다. |
badRequest (400) |
invalidPageToken |
pageToken 매개변수 값이 잘못되었습니다. 이 오류는 요청에 사용된 페이지 토큰이 만료된 경우 발생합니다. |
badRequest (400) |
invalidHasAccessToLevel |
hasAccessToLevel 매개변수 값이 잘못되었습니다. 지정된 id 가 있는 레벨이 없습니다. |
badRequest (400) |
invalidFilterByMemberChannelId |
filterByMemberChannelId 매개변수 값이 잘못되었습니다. 이 오류는 filterByMemberChannelId 매개변수 값이 100개를 초과하는 채널을 지정하는 경우에 발생합니다. |
membershipsLevels
다음 표에서는 members
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
membershipsLevels.list
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
channelMembershipsNotEnabled |
요청을 승인하는 크리에이터 채널에 채널 멤버십이 사용 설정되지 않았습니다. |
playlistItems
다음 표에서는 playlistItems
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
playlistItems.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
playlistItemsNotAccessible |
지정된 재생목록 항목을 삭제할 수 있도록 요청이 제대로 인증되지 않았습니다. |
notFound (404) |
playlistItemNotFound |
요청의 id 매개변수로 식별된 재생목록 항목을 찾을 수 없습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API는 지정된 재생목록에서 동영상을 삭제하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록에서는 동영상을 삭제할 수 없습니다. |
playlistItems.insert
오류 유형 |
오류 세부정보 |
설명 |
duplicate |
videoAlreadyInPlaylist |
재생목록에 추가하려는 동영상이 이미 재생목록에 있습니다. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
재생목록의 항목 수가 최대 허용치에 도달했습니다. |
forbidden (403) |
playlistItemsNotAccessible |
지정된 재생목록 항목을 삽입할 수 있는 요청이 적절하게 승인되지 않았습니다. |
invalidValue (400) |
invalidContentDetails |
요청의 contentDetails 속성이 올바르지 않습니다. contentDetails.note 필드가 280자보다 길기 때문일 수 있습니다. |
invalidValue (400) |
invalidPlaylistItemPosition |
요청이 재생목록 항목의 위치를 유효하지 않거나 지원되지 않는 값으로 설정하려고 합니다. 리소스의 snippet 에서 position 속성 값을 확인합니다. |
invalidValue (400) |
invalidResourceType |
리소스 ID에 지정된 type 은 이 작업에서 지원되지 않습니다. 리소스 ID는 재생목록에 추가 중인 항목을 식별합니다(예: youtube#video ). |
invalidValue (400) |
manualSortRequired |
요청이 재생목록 항목의 위치를 설정하려고 하지만 재생목록이 수동 정렬을 사용하지 않습니다. 예를 들어 재생목록 항목은 날짜나 인기도를 기준으로 정렬할 수 있습니다. 요청이 삽입하는 리소스에서 snippet.position 요소를 삭제하여 오류를 해결할 수 있습니다. 재생목록 항목이 목록에서 특정 위치에 배치되도록 하려면 먼저 재생목록 설정에서 재생목록의 순서 지정 옵션을 수동으로 업데이트해야 합니다. 이 설정은 YouTube 동영상 관리자에서 조정할 수 있습니다. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
재생목록에 추가하려는 동영상이 이미 다른 시리즈 재생목록에 있습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API는 지정된 재생목록에 동영상을 삽입하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록에는 동영상을 삽입할 수 없습니다. |
notFound (404) |
playlistNotFound |
요청의 playlistId 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
notFound (404) |
videoNotFound |
재생목록에 추가하려는 동영상을 찾을 수 없습니다. videoId 속성 값이 올바른지 확인하세요. |
required (400) |
channelIdRequired |
요청이 필요한 channelId 속성 값을 지정하지 않습니다. |
required (400) |
playlistIdRequired |
요청이 필요한 playlistId 속성 값을 지정하지 않습니다. |
required (400) |
resourceIdRequired |
요청에는 snippet 객체가 resourceId 을(를) 지정하는 리소스가 포함되어야 합니다. |
playlistItems.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
playlistItemsNotAccessible |
지정된 재생목록을 검색할 수 있도록 요청이 제대로 인증되지 않았습니다. |
notFound (404) |
playlistNotFound |
요청의 playlistId 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
notFound (404) |
videoNotFound |
요청의 videoId 매개변수로 식별된 동영상을 찾을 수 없습니다. |
required (400) |
playlistIdRequired |
구독 요청이 필수 playlistId 속성 값을 지정하지 않습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API는 지정된 재생목록의 동영상을 나열하는 기능을 지원하지 않습니다. 예를 들어 나중에 볼 동영상 재생목록에는 동영상을 나열할 수 없습니다. |
playlistItems.update
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
playlistItemsNotAccessible |
지정된 재생목록 항목을 업데이트할 수 있는 요청이 제대로 인증되지 않았습니다. |
invalidValue (400) |
invalidPlaylistItemPosition |
요청이 재생목록 항목의 위치를 유효하지 않거나 지원되지 않는 값으로 설정하려고 합니다. 리소스의 snippet 에서 position 속성 값을 확인합니다. |
invalidValue (400) |
invalidResourceType |
리소스 ID에 지정된 type 은 이 작업에서 지원되지 않습니다. 리소스 ID는 재생목록에 추가 중인 항목을 식별합니다(예: youtube#video ). |
invalidValue (400) |
invalidSnippet |
요청이 유효한 snippet 속성을 지정하지 않습니다. |
invalidValue (400) |
manualSortRequired |
요청이 재생목록 항목의 위치를 설정하려고 하지만 재생목록이 수동 정렬을 사용하지 않습니다. 예를 들어 재생목록 항목은 날짜나 인기도를 기준으로 정렬할 수 있습니다. 요청이 삽입하는 리소스에서 snippet.position 요소를 삭제하여 오류를 해결할 수 있습니다. 재생목록 항목이 목록에서 특정 위치에 배치되도록 하려면 먼저 재생목록 설정에서 재생목록의 순서 지정 옵션을 수동으로 업데이트해야 합니다. 이 설정은 YouTube 동영상 관리자에서 조정할 수 있습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API는 지정된 재생목록의 동영상을 업데이트하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록에 있는 동영상은 업데이트할 수 없습니다. |
notFound (404) |
playlistItemNotFound |
요청의 id 속성으로 식별된 재생목록 항목을 찾을 수 없습니다. |
notFound (404) |
playlistNotFound |
요청의 playlistId 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
required (400) |
channelIdRequired |
요청이 필요한 channelId 속성 값을 지정하지 않습니다. |
required (400) |
playlistIdRequired |
요청이 필요한 playlistId 속성 값을 지정하지 않습니다. |
required (400) |
playlistItemIdRequired |
요청에 지정된 재생목록 항목 리소스는 업데이트 중인 재생목록 항목을 식별하려면 id 속성을 사용해야 합니다. |
재생목록
다음 표에서는 playlists
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
playlists.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
playlistForbidden |
이 작업은 금지되어 있거나 요청이 제대로 승인되지 않았습니다. |
notFound (404) |
playlistNotFound |
요청의 id 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API가 지정한 재생목록을 삭제하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록은 삭제할 수 없습니다. |
playlists.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
channelClosed |
channelId 매개변수에 지정된 채널이 폐쇄되었습니다. |
forbidden (403) |
channelSuspended |
channelId 매개변수에 지정된 채널이 정지되었습니다. |
forbidden (403) |
playlistForbidden |
요청의 id 매개변수로 식별된 재생목록이 요청을 지원하지 않거나 요청이 제대로 인증되지 않았습니다. |
notFound (404) |
channelNotFound |
channelId 매개변수에 지정된 채널을 찾을 수 없습니다. |
notFound (404) |
playlistNotFound |
요청의 id 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
invalidValue (400) |
playlistOperationUnsupported |
API는 지정된 재생목록을 나열하는 기능을 지원하지 않습니다. 예를 들어 나중에 볼 동영상 재생목록은 표시할 수 없습니다. |
playlists.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSetError |
localizations 를 업데이트하도록 defaultLanguage 를 설정해야 합니다. |
badRequest (400) |
localizationValidationError |
현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. playlists.list 메서드를 사용하여 유효한 값을 검색하고 재생목록 리소스 문서의 가이드라인에 따라 값을 업데이트해야 합니다. |
badRequest (400) |
maxPlaylistExceeded |
채널에 이미 허용된 최대 개수의 재생목록이 있으므로 재생목록을 만들 수 없습니다. |
forbidden (403) |
playlistForbidden |
이 작업은 금지되어 있거나 요청이 제대로 승인되지 않았습니다. |
invalidValue (400) |
invalidPlaylistSnippet |
요청이 잘못된 재생목록 스니펫을 제공합니다. |
required (400) |
playlistTitleRequired |
요청에 재생목록의 제목을 지정해야 합니다. |
playlists.update
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSetError |
localizations 를 업데이트하도록 defaultLanguage 를 설정해야 합니다. |
badRequest (400) |
localizationValidationError |
현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. playlists.list 메서드를 사용하여 유효한 값을 검색하고 재생목록 리소스 문서의 가이드라인에 따라 값을 업데이트해야 합니다. |
forbidden (403) |
playlistForbidden |
이 작업은 금지되어 있거나 요청이 제대로 승인되지 않았습니다. |
invalidValue (400) |
invalidPlaylistSnippet |
요청이 잘못된 재생목록 스니펫을 제공합니다. |
invalidValue (400) |
playlistOperationUnsupported |
API가 지정된 재생목록을 업데이트하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록의 속성은 업데이트할 수 없습니다. |
notFound (404) |
playlistNotFound |
요청의 id 매개변수로 식별된 재생목록을 찾을 수 없습니다. |
required (400) |
playlistTitleRequired |
요청에서 재생목록의 제목을 지정해야 합니다. |
search
다음 표에서는 search
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
search.list
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
invalidChannelId |
channelId 매개변수에 잘못된 채널 ID가 지정되었습니다. |
badRequest (400) |
invalidLocation |
location 또는 locationRadius 매개변수 값의 형식이 잘못되었습니다. |
badRequest (400) |
invalidRelevanceLanguage |
relevanceLanguage 매개변수 값의 형식이 잘못되었습니다. |
badRequest (400) |
invalidSearchFilter |
요청에 잘못된 조합의 검색 필터 및/또는 제한이 있습니다. eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated 또는 videoType 매개변수의 값을 설정하는 경우 type 매개변수를 video 로 설정해야 합니다. |
구독
다음 표에서는 subscriptions
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
subscriptions.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
subscriptionForbidden |
요청이 제대로 인증되지 않았거나 이 채널에서 지원하지 않습니다. |
notFound (404) |
subscriptionNotFound |
삭제하려는 구독을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
subscriptions.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
subscriptionDuplicate |
만들려는 구독정보가 이미 존재합니다. |
badRequest (400) |
subscriptionForbidden |
최대 구독 수에 도달했습니다. |
badRequest (400) |
subscriptionForbidden |
최근 구독이 너무 많습니다. 몇 시간 후 다시 시도해 보세요. |
badRequest (400) |
subscriptionForbidden |
내 채널 구독은 지원되지 않습니다. |
forbidden (403) |
subscriptionForbidden |
요청이 제대로 인증되지 않았거나 이 채널에서 지원하지 않습니다. |
notFound (404) |
publisherNotFound |
요청의 snippet.resourceId 속성으로 지정된 리소스를 찾을 수 없습니다. |
notFound (404) |
subscriberNotFound |
요청에서 확인된 구독자를 찾을 수 없습니다. |
required (400) |
publisherRequired |
구독 중인 채널을 확인하려면 요청에 지정된 구독 리소스가 snippet.resourceId 속성을 사용해야 합니다. |
subscriptions.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
accountClosed |
구독자의 계정이 해지되어 구독정보를 검색할 수 없습니다. |
forbidden (403) |
accountSuspended |
구독자의 계정이 정지되어 구독정보를 검색할 수 없습니다. |
forbidden (403) |
subscriptionForbidden |
요청자는 요청한 구독에 액세스할 수 없습니다. |
notFound (404) |
subscriberNotFound |
요청에서 확인된 구독자를 찾을 수 없습니다. |
미리보기 이미지
다음 표에서는 thumbnails
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
thumbnails.set
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
invalidImage |
제공된 이미지 콘텐츠가 잘못되었습니다. |
badRequest (400) |
mediaBodyRequired |
요청에 이미지 콘텐츠가 포함되어 있지 않습니다. |
forbidden (403) |
forbidden |
지정된 동영상에 썸네일을 설정할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
forbidden (403) |
forbidden |
인증된 사용자에게 맞춤 동영상 미리보기 이미지를 업로드하고 설정할 수 있는 권한이 없습니다. |
notFound (404) |
videoNotFound |
미리보기 이미지를 삽입하려는 동영상을 찾을 수 없습니다. 요청의 videoId 매개변수 값이 올바른지 확인하세요. |
tooManyRequests (429) |
uploadRateLimitExceeded |
채널에 최근 너무 많은 썸네일이 업로드되었습니다. 나중에 다시 요청해 주세요. |
videoAbuseReportReasons
다음 표에서는 videoAbuseReportReasons
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
videoAbuseReportReasons.list
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
액세스가 금지되었습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
videoCategories
다음 표에서는 videoCategories
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
videoCategories.list
오류 유형 |
오류 세부정보 |
설명 |
notFound (404) |
videoCategoryNotFound |
id 매개변수로 식별된 동영상 카테고리를 찾을 수 없습니다. 유효한 값 목록을 검색하려면 videoCategories.list 메서드를 사용하세요. |
동영상
다음 표에서는 videos
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
videos.insert
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSet |
요청이 동영상 세부정보의 기본 언어를 지정하지 않고 현지화된 동영상 세부정보를 추가하려고 합니다. |
badRequest (400) |
invalidCategoryId |
snippet.categoryId 속성이 잘못된 카테고리 ID를 지정합니다. 지원되는 카테고리를 검색하려면 videoCategories.list 메서드를 사용합니다. |
badRequest (400) |
invalidDescription |
요청 메타데이터가 잘못된 동영상 설명을 지정합니다. |
badRequest (400) |
invalidFilename |
Slug 헤더에 지정된 동영상 파일 이름이 잘못되었습니다. |
badRequest (400) |
invalidPublishAt |
요청 메타데이터가 잘못된 예약 게시 시간을 지정합니다. |
badRequest (400) |
invalidRecordingDetails |
요청 메타데이터의 recordingDetails 객체가 잘못된 녹음 세부정보를 지정합니다. |
badRequest (400) |
invalidTags |
요청 메타데이터가 잘못된 동영상 키워드를 지정합니다. |
badRequest (400) |
invalidTitle |
요청 메타데이터가 잘못되었거나 비어 있는 동영상 제목을 지정합니다. |
badRequest (400) |
invalidVideoGameRating |
요청 메타데이터가 잘못된 비디오 게임 등급을 지정합니다. |
badRequest (400) |
invalidVideoMetadata |
요청 메타데이터가 잘못되었습니다. 이 오류는 요청이 video 리소스의 snippet 부분을 업데이트하지만 snippet.title 속성과 snippet.categoryId 속성 모두 값을 설정하지 않은 경우에 발생합니다. |
badRequest (400) |
mediaBodyRequired |
요청에 동영상 콘텐츠가 없습니다. |
badRequest (400) |
uploadLimitExceeded |
사용자가 업로드할 수 있는 동영상 수를 초과했습니다. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
요청이 동영상에 잘못된 라이선스를 설정하려고 합니다. |
forbidden (403) |
forbiddenPrivacySetting |
요청이 동영상에 대해 잘못된 개인정보 보호 설정을 지정하려고 합니다. |
videos.list
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
videoChartNotFound |
요청한 동영상 차트가 지원되지 않거나 동영상 차트를 사용할 수 없습니다. |
forbidden (403) |
forbidden |
요청에 동영상 파일 액세스 또는 정보 처리 권한이 제대로 부여되지 않았습니다. fileDetails , processingDetails , suggestions 부분은 해당 동영상 소유자만 사용할 수 있습니다. |
forbidden (403) |
forbidden |
요청이 사용자 평가 정보에 액세스할 수 없습니다. 이 오류는 요청에 myRating 매개변수를 사용하도록 제대로 승인되지 않았기 때문에 발생할 수 있습니다. |
notFound (404) |
videoNotFound |
검색하려는 동영상을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
videos.delete
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
삭제하려는 동영상은 삭제할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
notFound (404) |
videoNotFound |
삭제하려는 동영상을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
videos.update
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
defaultLanguageNotSet |
API 요청이 동영상 세부정보의 기본 언어를 지정하지 않고 현지화된 동영상 세부정보를 추가하려고 합니다. |
badRequest (400) |
invalidCategoryId |
snippet.categoryId 속성이 잘못된 카테고리 ID를 지정합니다. 지원되는 카테고리를 검색하려면 videoCategories.list 메서드를 사용합니다. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
요청이 기본 브로드캐스트에 잘못된 개인 정보 보호 설정을 지정하려고 합니다. |
badRequest (400) |
invalidDescription |
요청 메타데이터가 잘못된 동영상 설명을 지정합니다. |
badRequest (400) |
invalidPublishAt |
요청 메타데이터가 잘못된 예약 게시 시간을 지정합니다. |
badRequest (400) |
invalidRecordingDetails |
요청 메타데이터의 recordingDetails 객체가 잘못된 녹음 세부정보를 지정합니다. |
badRequest (400) |
invalidTags |
요청 메타데이터가 잘못된 동영상 키워드를 지정합니다. |
badRequest (400) |
invalidTitle |
요청 메타데이터가 잘못되었거나 비어 있는 동영상 제목을 지정합니다. |
badRequest (400) |
invalidVideoMetadata |
요청 메타데이터가 잘못되었습니다. 이 오류는 요청이 video 리소스의 snippet 부분을 업데이트하지만 snippet.title 속성과 snippet.categoryId 속성 모두 값을 설정하지 않은 경우에 발생합니다. |
forbidden (403) |
forbidden |
액세스가 금지되었습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
forbidden (403) |
forbiddenEmbedSetting |
요청이 동영상에 대해 잘못된 삽입 설정을 지정하려고 합니다. 일부 채널은 라이브 스트림에 삽입된 플레이어를 제공할 권한이 없을 수 있습니다. 자세한 내용은 YouTube 도움말 센터를 참조하세요. |
forbidden (403) |
forbiddenLicenseSetting |
요청이 동영상에 잘못된 라이선스를 설정하려고 합니다. |
forbidden (403) |
forbiddenPrivacySetting |
요청이 동영상에 대해 잘못된 개인정보 보호 설정을 지정하려고 합니다. |
notFound (404) |
videoNotFound |
업데이트하려는 동영상을 찾을 수 없습니다. 요청 본문에서 id 필드 값이 올바른지 확인하세요. |
videos.rate
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
emailNotVerified |
사용자는 평가하기 전에 이메일 주소를 인증해야 합니다. |
badRequest (400) |
invalidRating |
요청에 rating 매개변수에 예상치 못한 값이 포함되어 있습니다. |
badRequest (400) |
videoPurchaseRequired |
대여 동영상은 대여한 사용자만 평가할 수 있습니다. |
forbidden (403) |
forbidden |
평가하려는 동영상을 평가할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다. |
forbidden (403) |
videoRatingDisabled |
평가하려는 동영상 소유자가 해당 동영상에 대한 평가를 사용 중지했습니다. |
notFound (404) |
videoNotFound |
평가하려는 동영상을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요. |
videos.reportAbuse
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
invalidAbuseReason |
요청에 reason_id 필드에 예상치 못한 값 또는 reason_id 필드와 secondary_reason_id 필드의 조합이 포함되어 있습니다. |
badRequest (400) |
rateLimitExceeded |
사용자가 일정 기간 동안 너무 많은 요청을 보냈습니다. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
악용사례를 신고하려는 동영상을 찾을 수 없습니다. |
watermarks
다음 표에서는 watermarks
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.
watermarks.set
오류 유형 |
오류 세부정보 |
설명 |
badRequest (400) |
imageFormatUnsupported |
제공한 이미지가 지원되지 않는 형식입니다. |
badRequest (400) |
imageTooTall |
제공한 이미지 높이가 너무 깁니다. |
badRequest (400) |
imageTooWide |
제공한 이미지 너비가 너무 넓습니다. |
badRequest (400) |
mediaBodyRequired |
요청에 이미지 콘텐츠가 포함되어 있지 않습니다. |
forbidden (403) |
forbidden |
지정된 채널에는 워터마크를 설정할 수 없습니다. 요청이 제대로 인증되지 않았거나 channelId 매개변수가 잘못된 값으로 설정되어 있습니다. |
watermarks.unset
오류 유형 |
오류 세부정보 |
설명 |
forbidden (403) |
forbidden |
특정 채널에서는 워터마크 설정을 해제할 수 없습니다. 요청이 제대로 인증되지 않았거나 channelId 매개변수가 잘못된 값으로 설정되어 있습니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-04-22(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-04-22(UTC)"],[],[]]
comments
comments.markAsSpam
메서드는 더 이상 지원되지 않습니다.다음 표에서는
comments
리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
및parentId
매개변수 값이 올바른지 확인하세요.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
매개변수는moderationStatus
매개변수 값이rejected
인 경우에만 사용할 수 있습니다.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
매개변수 값이 올바른지 확인하세요.comments.insert
badRequest (400)
commentTextRequired
comment
리소스는snippet.textOriginal
속성 값을 지정해야 합니다. 댓글은 비워 둘 수 없습니다.badRequest (400)
commentTextTooLong
comment
리소스의snippet.textOriginal
속성에 너무 많은 문자가 포함되어 있습니다.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
속성으로 식별된 최상위 댓글에 대한 응답으로 댓글을 삽입할 수 없습니다.commentThread
리소스에서snippet.canReply
속성은 현재 뷰어가 스레드에 응답할 수 있는지를 나타냅니다.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
리소스가snippet.parentId
속성 값을 지정하지 않았습니다.badRequest (400)
processingFailure
comment
리소스의 구조를 확인하여 유효한지 확인합니다.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
속성 값이 올바른지 확인하세요.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
매개변수 값이 올바른지 확인하세요.comments.update
badRequest (400)
commentTextTooLong
comment
리소스의snippet.textOriginal
속성에 너무 많은 문자가 포함되어 있습니다.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
리소스의 구조를 확인하여 유효한지 확인합니다.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
속성 값이 올바른지 확인하세요.