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

Channels: update

이제 API에서 채널 또는 동영상을 '아동용'으로 표시하는 기능을 지원합니다. 또한 channel 및 video 리소스에도 이제 채널이나 동영상의 '아동용' 상태를 식별하는 속성이 포함됩니다. YouTube API 서비스 약관 및 개발자 정책도 2020년 1월 10일에 업데이트되었습니다. 자세한 내용은 YouTube Data API 서비스 및 YouTube API 서비스 약관의 업데이트 기록을 참고하세요.

채널의 메타데이터를 업데이트합니다. 이 메서드는 현재 channel 리소스의 brandingSettings, invideoPromotion, localizations 객체와 하위 속성 업데이트만 지원합니다.

할당량 영향: 이 메서드를 호출하면 50단위의 할당량 비용이 적용됩니다.

일반적인 사용 사례

요청

HTTP 요청

PUT https://www.googleapis.com/youtube/v3/channels

승인

이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)

범위
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

매개변수

다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.

매개변수
필수 매개변수
`part`	`string` 이 연산에서 `part` 매개변수는 두 가지 용도로 사용됩니다. 쓰기 작업에서 설정할 속성과 API 응답에 포함될 속성을 식별합니다. 현재 이 API는 매개변수 값을 `brandingSettings`, `invideoPromotion`, `localizations` 중 하나로만 설정하도록 허용합니다. (이러한 부분만 하나의 요청으로 업데이트할 수 있습니다.) 이 메서드는 매개변수 값이 지정하는 부분에 포함된 모든 변경 가능한 속성의 기존 값을 재정의합니다.
선택적 매개변수
`onBehalfOfContentOwner`	`string` 이 매개변수는 제대로 승인된 요청에서만 사용할 수 있습니다. `onBehalfOfContentOwner` 매개변수는 인증된 사용자가 매개변수 값에 지정된 콘텐츠 소유자를 대신하고 있음을 나타냅니다. 이 매개변수는 다양한 YouTube 채널을 소유하고 관리하는 YouTube 콘텐츠 파트너를 위한 것입니다. 콘텐츠 소유자가 각 채널에 사용자 인증 정보를 제공하지 않고도 한 번만 인증하면 모든 동영상 및 채널 데이터에 액세스할 수 있습니다. 사용자가 인증할 실제 CMS 계정은 지정된 YouTube 콘텐츠 소유자에게 연결되어야 합니다.

요청 본문

요청 본문에 channel 리소스를 제공합니다. 해당 리소스의 경우:

다음 속성에 값을 지정해야 합니다.
- id
다음 속성에 값을 설정할 수 있습니다.
- brandingSettings.channel.country
- brandingSettings.channel.description
- brandingSettings.channel.defaultLanguage
- brandingSettings.channel.keywords
- brandingSettings.channel.trackingAnalyticsAccountId
- brandingSettings.channel.unsubscribedTrailer
- localizations.(key)
- localizations.(key).title
- localizations.(key).description
- status.selfDeclaredMadeForKids
업데이트 요청을 제출하는데 값이 있는 속성에 요청이 값을 지정하지 않은 경우 속성의 기존 값은 삭제됩니다.

응답

성공하는 경우 이 메소드는 응답 본문에 channel 리소스를 반환합니다.

오류

다음 표에서는 이 메서드에 대한 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 확인합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.

오류 유형	오류 세부정보	설명
`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 부분에서 항목 ID를 지정해야 합니다.
`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`	요청 메타데이터는 invideoPromo 부분에 웹사이트 URL을 지정해야 합니다. 요청이 보내는 리소스에서 `invideoPromotion.items[].id.websiteUrl` 속성 값을 설정합니다.

사용해 보기

APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인하세요.