이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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`	자막 트랙 데이터를 요청한 언어 또는 형식으로 변환할 수 없습니다. 요청된 `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` 속성 값을 설정합니다.

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

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

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

YouTube Data API - Errors

일반적인 오류

Core API errors

Common request errors

Request context errors

activities

activities.list

captions

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

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update

멤버

members.list