PlaylistItems: update

재생목록의 항목을 수정합니다. 예를 들어 재생목록에서 항목의 위치를 업데이트할 수 있습니다. 지금 사용해 보세요.

요청

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

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

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

아래 표는 이 쿼리가 지원하는 매개변수 목록입니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.

매개변수 이름
필수 매개변수
`part`	`string` `part` 매개변수는 이 연산에서 2가지 용도로 사용됩니다. 쓰기 연산에서 설정하는 속성과 API 응답에서 포함하는 속성을 식별합니다. 매개변수 값에 포함할 수 있는 `part` 이름은 `snippet`, `contentDetails`, `status`입니다. 이 메소드는 매개변수 값이 지정한 부분에 있는 변경이 용이한 모든 속성의 기존 값을 오버라이드하는 점에 유의합니다. 예를 들어 재생목록 항목은 시작 시간과 종료 시간을 지정할 수 있습니다. 이 시간은 사용자가 재생목록의 동영상을 볼 때 재생해야 하는 동영상의 시간 부분을 식별합니다. 이 값을 설정하는 재생목록 항목을 요청에서 업데이트하고 요청의 `part` 매개변수 값이 `contentDetails` 부분을 포함하는 경우 재생목록 항목의 시작 및 종료 시간은 요청 본문에서 지정하는 값으로 업데이트됩니다. 요청 본문에 값이 지정되지 않은 경우 기존 시작 및 종료 시간은 삭제되고 기본 설정으로 바뀝니다.

요청 본문에 playlistItem 리소스를 제공합니다. 이 리소스의 경우

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

아래 표에서는 이 메소드에 대한 호출에 응답하기 위해 API가 반환할 수 있는 오류 메시지를 식별합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.

오류 유형	오류 세부정보	설명
`invalidValue`	`invalidPlaylistItemPosition`	요청이 재생목록 항목의 위치를 잘못되거나 지원되지 않는 값으로 설정하려고 합니다. 리소스의 `position` 안에 있는 `snippet` 속성 값을 확인하세요.
`invalidValue`	`invalidResourceType`	리소스 ID에 지정된 `type`이 이 작업에서 지원되지 않습니다. 리소스 ID를 통해 항목이 재생목록에 추가되고 있음을 확인합니다. 예: `youtube#video`
`invalidValue`	`invalidSnippet`	요청이 잘못된 `snippet` 속성 값을 지정합니다.
`notFound`	`playlistItemNotFound`	요청의 `id` 속성으로 식별된 재생목록 항목을 찾을 수 없습니다.
`notFound`	`playlistNotFound`	요청의 `playlistId` 매개변수로 식별된 재생목록을 찾을 수 없습니다.
`required`	`channelIdRequired`	요청이 필수 `channelId` 속성 값을 지정하지 않았습니다.
`required`	`playlistIdRequired`	요청이 필수 `playlistId` 속성 값을 지정하지 않았습니다.
`required`	`playlistItemIdRequired`	요청에 지정된 재생목록 항목 리소스가 업로드 중인 재생목록 항목을 식별하려면 `id` 속성을 사용해야 합니다.

API Explorer를 사용하여 실시간 데이터에서 이 메소드를 호출하고 API 요청 및 응답을 확인해 보세요.