Playlists: update

재생목록을 수정합니다. 예를 들어 재생목록의 제목, 설명, 개인정보 보호 상태를 변경할 수 있습니다. 지금 사용해 보세요.

요청

HTTP 요청

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

인증

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

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

매개변수

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

매개변수 이름
필수 매개변수
part string
part 매개변수는 이 연산에서 2가지 용도로 사용됩니다. 쓰기 연산에서 설정하는 속성과 API 응답에서 포함하는 속성을 식별합니다.

매개변수 값에 포함할 수 있는 part 이름은 snippetstatus입니다.

이 메소드는 매개변수 값이 지정한 부분에 있는 변경이 용이한 모든 속성의 기존 값을 오버라이드하는 점에 유의합니다. 예를 들어 재생목록의 개인정보 보호 설정은 status 부분에 포함되어 있습니다. 따라서 요청이 비공개 재생목록을 업데이트하고 요청의 part 매개변수 값이 status 부분을 포함하는 경우 재생목록의 개인정보 보호 설정은 요청 본문이 지정한 값으로 업데이트됩니다. 요청 본문이 값을 지정하지 않은 경우 기존 개인정보 보호 설정이 삭제되고 재생목록은 기본 개인정보 보호 설정으로 되돌아갑니다.

요청 본문

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

  • 다음 속성에 값을 지정해야 합니다.

    • id
    • snippet.title

  • 다음 속성에 값을 설정할 수 있습니다.

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • snippet.tags[]

    업데이트 요청을 제출하는데 값이 있는 속성에 요청이 값을 지정하지 않은 경우 속성의 기존 값은 삭제됩니다.

응답

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

오류

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

오류 유형 오류 세부정보 설명
invalidValue invalidPlaylistSnippet 요청이 잘못된 재생목록 스니펫을 제공합니다.
notFound playlistNotFound 요청의 id 매개변수로 식별된 재생목록을 찾을 수 없습니다.
required playlistTitleRequired 요청에서 재생목록의 제목을 지정해야 합니다.

직접 사용해 보세요!

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