Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

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 계정을 대신하여 행동하는 경우 이 오류는 후자를 나타냅니다.
`forbidden (403)`	`authenticatedUserAccountSuspended`	인증된 사용자의 YouTube 계정이 정지되었습니다. 인증된 사용자가 다른 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 리소스와 관련된 호출에 대한 응답으로 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 리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.

`captions.delete`

오류 유형	오류 세부정보	설명
`forbidden (403)`	`forbidden`	요청과 연결된 권한으로는 자막 트랙을 삭제할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
`notFound (404)`	`captionNotFound`	자막 트랙을 찾을 수 없습니다. 요청의 `id` 매개변수 값이 올바른지 확인합니다.

`captions.download`

오류 유형	오류 세부정보	설명
`forbidden (403)`	`forbidden`	요청과 연결된 권한으로는 자막 트랙을 다운로드할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
`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 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`notEditable`	이 채널 섹션을 만들 수 없습니다.
`badRequest (400)`	`styleRequired`	`channelSection` 리소스는 `snippet.style` 필드의 값을 지정해야 합니다.
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `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 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`notEditable`	이 채널 섹션은 수정할 수 없습니다.
`badRequest (400)`	`styleRequired`	`channelSection` 리소스는 `snippet.style` 필드의 값을 지정해야 합니다.
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `channelSections` 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 목록의 값 중 하나가 검증에 실패했습니다. channelSections.list 메서드를 사용하여 유효한 값을 가져오고 `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` 매개변수로 식별된 카테고리를 찾을 수 없습니다.
`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`	`defaultLanguage`은 `localizations`을 업데이트하도록 설정해야 합니다.
`badRequest (400)`	`invalidBrandingOption`	지정한 브랜딩 설정 중 하나가 존재하지 않습니다. `channels.list` 메서드를 사용하여 유효한 값을 가져오고 `channels` 리소스 문서의 가이드라인에 따라 값을 업데이트해야 합니다.
`badRequest (400)`	`invalidCustomMessage`	요청 메타데이터에 잘못된 맞춤 메시지가 지정되어 있습니다. 요청이 전송된 리소스에서 `invideoPromotion.items[].customMessage` 속성 값을 확인합니다.
`badRequest (400)`	`invalidDuration`	요청 메타데이터의 invideoPromotion 부분에 잘못된 기간이 지정되어 있습니다.
`badRequest (400)`	`invalidDuration`	요청 메타데이터에 동영상 플레이어에서 프로모션 상품의 위치를 결정하는 데 사용되는 잘못된 위치 유형이 지정되어 있습니다. 요청이 전송된 리소스에서 `invideoPromotion.position.type` 속성 값을 확인합니다.
`badRequest (400)`	`invalidRecentlyUploadedBy`	요청 메타데이터에 잘못된 채널 ID가 지정되어 있습니다. 요청이 전송된 리소스에서 `invideoPromotion.items[].id.recentlyUploadedBy` 속성 값을 확인합니다.
`badRequest (400)`	`invalidTimingOffset`	요청 메타데이터의 invideoPromotion 부분에 잘못된 타이밍 오프셋이 지정되어 있습니다.
`badRequest (400)`	`invalidTimingOffset`	요청 메타데이터에 동영상 플레이어에 프로모션 항목을 표시할 시점을 결정하는 데 사용되는 잘못된 타이밍 오프셋이 지정되어 있습니다. 요청이 전송된 리소스에서 `invideoPromotion.timing.offsetMs` 속성 값을 확인합니다.
`badRequest (400)`	`invalidTimingType`	요청 메타데이터가 동영상 플레이어에 프로모션 항목을 표시해야 하는 시점을 결정하는 잘못된 타이밍 방법을 지정합니다. 요청이 전송된 리소스에서 `invideoPromotion.timing.type` 속성 값을 확인합니다.
`badRequest (400)`	`localizationValidationError`	현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. channels.list 메서드를 사용하여 유효한 값을 가져오고 채널 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`tooManyPromotedItems`	인비디오 프로모션 부분에서 허용된 프로모션 항목 수를 초과했습니다.
`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`	지정된 recentlyUploadedBy 채널 ID를 찾을 수 없습니다.
`notFound (404)`	`unknownVideoId`	프로모션 항목으로 지정한 동영상 ID를 찾을 수 없습니다.
`required (400)`	`requiredItemIdType`	요청 메타데이터는 invideoPromotion 부분에 항목 유형을 지정해야 합니다.
`required (400)`	`requiredItemId`	요청 메타데이터는 invideoPromotion 부분의 항목을 지정해야 합니다.
`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.channelId` 및 `snippet.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 리소스와 관련된 호출에 대한 응답으로 API가 반환하는 오류 메시지가 나와 있습니다. 이러한 메서드는 일반적인 요청 오류 섹션에 나열된 오류를 반환할 수도 있습니다.

`comments.list`

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

`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

`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`	`defaultLanguage`은 `localizations`을 업데이트하도록 설정해야 합니다.
`badRequest (400)`	`localizationValidationError`	현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. playlists.list 메서드를 사용하여 유효한 값을 가져오고 재생목록 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`badRequest (400)`	`maxPlaylistExceeded`	채널에 이미 허용된 최대 수의 재생목록이 있어 재생목록을 만들 수 없습니다.
`forbidden (403)`	`playlistForbidden`	이 작업이 금지되었거나 요청이 적절하게 승인되지 않았습니다.
`invalidValue (400)`	`invalidPlaylistSnippet`	요청이 잘못된 재생목록 스니펫을 제공합니다.
`required (400)`	`playlistTitleRequired`	요청에 재생목록의 제목을 지정해야 합니다.

`playlists.update`

오류 유형	오류 세부정보	설명
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage`은 `localizations`을 업데이트하도록 설정해야 합니다.
`badRequest (400)`	`localizationValidationError`	현지화 객체의 값 중 하나가 유효성 검사에 실패했습니다. playlists.list 메서드를 사용하여 유효한 값을 가져오고 재생목록 리소스 문서의 가이드라인에 따라 값을 업데이트합니다.
`forbidden (403)`	`playlistForbidden`	이 작업이 금지되었거나 요청이 적절하게 승인되지 않았습니다.
`invalidValue (400)`	`invalidPlaylistSnippet`	요청이 잘못된 재생목록 스니펫을 제공합니다.
`invalidValue (400)`	`playlistOperationUnsupported`	API는 지정된 재생목록을 업데이트하는 기능을 지원하지 않습니다. 예를 들어 업로드한 동영상 재생목록의 속성은 업데이트할 수 없습니다.
`notFound (404)`	`playlistNotFound`	요청의 `id` 매개변수로 식별된 재생목록을 찾을 수 없습니다.
`required (400)`	`playlistTitleRequired`	요청에서 재생목록의 제목을 지정해야 합니다.

검색

다음 표에는 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 리소스와 관련된 호출에 대한 응답으로 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` 매개변수가 잘못된 값으로 설정되었을 수 있습니다.

YouTube Data API - Errors 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

일반적인 오류

Core API errors

Common request errors

Request context errors

활동

activities.list

자막

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

채널

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

댓글

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update

멤버

members.list