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

YouTube에서 채널 게시판 기능을 지원 중단했습니다. activities.insert 메서드는 더 이상 지원되지 않습니다.

다음 표에서는 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 자막 트랙 데이터를 요청한 언어 또는 형식으로 변환할 수 없습니다. 요청된 tfmttlang 값이 유효하고 요청된 자막 트랙의 snippet.statusfailed이 아닌지 확인합니다.
notFound (404) captionNotFound 자막 트랙을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요.

captions.insert

오류 유형 오류 세부정보 설명
badRequest (400) contentRequired 요청에 자막 트랙 콘텐츠가 포함되어 있지 않습니다.
conflict (409) captionExists 지정한 동영상에 이미 snippet.languagesnippet.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를 식별하는 경우에 발생합니다. 요청의 idvideoId 매개변수 값이 올바른지 확인하세요.
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 속성 값을 설정합니다.

commentThreads

다음 표에서는 commentThreads 리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.

commentThreads.list

오류 유형 오류 세부정보 설명
badRequest (400) operationNotSupported API 요청이 잘못되었거나 형식이 부적절합니다. 따라서 API 서버가 요청을 이해할 수 없습니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다. 요청 본문에서 commentThread 리소스의 구조를 확인하여 유효한지 확인합니다.
forbidden (403) commentsDisabled videoId 매개변수로 식별된 동영상은 댓글을 사용 중지했습니다.
forbidden (403) forbidden 권한이 부족하여 요청된 댓글 대화목록 중 하나 이상을 가져올 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
notFound (404) channelNotFound allThreadsRelatedToChannelId 매개변수로 식별된 채널을 찾을 수 없습니다.
notFound (404) commentThreadNotFound 지정된 댓글 대화목록을 하나 이상 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요.
notFound (404) videoNotFound videoId 매개변수로 식별된 동영상을 찾을 수 없습니다.

commentThreads.insert

오류 유형 오류 세부정보 설명
badRequest (400) channelOrVideoIdMissing 각 댓글 대화목록은 채널이나 동영상에 연결되어야 합니다. 리소스가 snippet.channelIdsnippet.videoId 속성 값을 모두 지정하는지 확인합니다. 동영상의 댓글은 동영상 보기 페이지에 표시됩니다.
badRequest (400) commentTextRequired 삽입되는 comment 리소스는 snippet.topLevelComment.snippet.textOriginal 속성 값을 지정해야 합니다. 댓글은 비워 둘 수 없습니다.
badRequest (400) commentTextTooLong 삽입 중인 comment 리소스의 snippet.topLevelComment.snippet.textOriginal 속성에 너무 많은 문자가 포함되어 있습니다.
badRequest (400) invalidCommentThreadMetadata 요청 메타데이터가 잘못되었습니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다. 요청 본문에서 commentThread 리소스의 구조를 확인하여 유효한지 확인합니다.
forbidden (403) forbidden 권한이 부족하여 댓글 대화목록이 생성될 수 있습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
forbidden (403) ineligibleAccount API 요청을 승인하는 데 사용된 YouTube 계정이 댓글 또는 댓글 대화목록을 삽입하려면 사용자의 Google 계정과 병합되어야 합니다.
notFound (404) channelNotFound 지정된 채널을 찾을 수 없습니다. snippet.channelId 속성 값이 올바른지 확인하세요.
notFound (404) videoNotFound 지정한 동영상을 찾을 수 없습니다. snippet.videoId 속성 값이 올바른지 확인하세요.

comments

comments.markAsSpam 메서드는 더 이상 지원되지 않습니다.

다음 표에서는 comments 리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지를 확인합니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.

comments.list

오류 유형 오류 세부정보 설명
badRequest (400) operationNotSupported API 요청이 잘못되었거나 형식이 부적절합니다. 따라서 API 서버가 요청을 이해할 수 없습니다.
forbidden (403) forbidden 권한이 부족하여 하나 이상의 요청된 댓글을 가져올 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
notFound (404) commentNotFound 지정된 댓글 중 하나 이상을 찾을 수 없습니다. 요청의 idparentId 매개변수 값이 올바른지 확인하세요.

comments.setModerationStatus

오류 유형 오류 세부정보 설명
badRequest (400) banWithoutReject banAuthor 매개변수는 moderationStatus 매개변수 값이 rejected인 경우에만 사용할 수 있습니다.
badRequest (400) operationNotSupported API 요청이 잘못되었거나 형식이 부적절합니다. 따라서 API 서버가 요청을 이해할 수 없습니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다.
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 API 사용자가 snippet.parentId 속성으로 식별된 최상위 댓글에 대한 응답으로 댓글을 삽입할 수 없습니다. commentThread 리소스에서 snippet.canReply 속성은 현재 뷰어가 스레드에 응답할 수 있는지를 나타냅니다.
badRequest (400) parentCommentIsPrivate 지정된 상위 댓글은 비공개입니다. API는 비공개 댓글에 대한 답글을 지원하지 않습니다.
badRequest (400) parentIdMissing 삽입되는 댓글은 상위 댓글에 연결되어 있어야 합니다. 하지만 API 요청 본문에 있는 comment 리소스가 snippet.parentId 속성 값을 지정하지 않았습니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다. 요청 본문에서 comment 리소스의 구조를 확인하여 유효한지 확인합니다.
forbidden (403) forbidden 권한이 부족하여 댓글을 작성할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
forbidden (403) ineligibleAccount API 요청을 승인하는 데 사용된 YouTube 계정이 댓글 또는 댓글 대화목록을 삽입하려면 사용자의 Google 계정과 병합되어야 합니다.
notFound (404) parentCommentNotFound 지정된 상위 댓글을 찾을 수 없습니다. 요청 본문에서 snippet.parentId 속성 값이 올바른지 확인하세요.

comments.delete

오류 유형 오류 세부정보 설명
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다.
forbidden (403) forbidden 권한이 부족하여 댓글을 삭제할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
notFound (404) commentNotFound 지정된 댓글을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요.

comments.update

오류 유형 오류 세부정보 설명
badRequest (400) commentTextTooLong 업데이트할 comment 리소스의 snippet.textOriginal 속성에 너무 많은 문자가 포함되어 있습니다.
badRequest (400) invalidCommentMetadata 요청 메타데이터가 잘못되었습니다.
badRequest (400) operationNotSupported API 요청이 잘못되었거나 형식이 부적절합니다. 따라서 API 서버가 요청을 이해할 수 없습니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다. 요청 본문에서 comment 리소스의 구조를 확인하여 유효한지 확인합니다.
forbidden (403) forbidden 권한이 부족하여 댓글을 업데이트할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
forbidden (403) ineligibleAccount API 요청을 승인하는 데 사용된 YouTube 계정은 사용자의 Google 계정과 병합하여 댓글 또는 댓글 대화목록을 업데이트해야 합니다.
notFound (404) commentNotFound 지정된 댓글을 찾을 수 없습니다. 요청 본문에서 id 속성 값이 올바른지 확인하세요.

멤버

다음 표에서는 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 요청에서 재생목록의 제목을 지정해야 합니다.

구독

다음 표에서는 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 매개변수가 잘못된 값으로 설정되어 있습니다.