PlaylistItems: insert

재생목록에 리소스를 추가합니다. 지금 사용해 보세요.

요청

HTTP 요청

POST 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입니다.

요청 본문

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

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

    • snippet.playlistId
    • snippet.resourceId

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

    • snippet.playlistId
    • snippet.position
    • snippet.resourceId
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

응답

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

오류

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

오류 유형 오류 세부정보 설명
duplicate videoAlreadyInPlaylist 재생목록에 추가하려는 동영상이 이미 재생목록에 있습니다.
forbidden playlistContainsMaximumNumberOfVideos 재생목록의 항목 수가 최대 허용치에 도달했습니다.
invalidValue invalidPlaylistItemPosition 요청이 재생목록 항목의 위치를 잘못되거나 지원되지 않는 값으로 설정하려 합니다. 리소스의 position 안에 있는 snippet 속성 값을 확인하세요.
invalidValue invalidResourceType 리소스 ID에 지정된 type이 이 작업에서 지원되지 않습니다. 리소스 ID를 통해 항목이 재생목록에 추가되고 있음을 확인합니다. 예: youtube#video
notFound playlistNotFound 요청의 playlistId 매개변수로 식별된 재생목록을 찾을 수 없습니다.
notFound videoNotFound 재생목록에 추가하려는 동영상을 찾을 수 없습니다. videoId 속성 값이 올바른지 확인하세요.
required channelIdRequired 요청이 필수 channelId 속성 값을 지정하지 않았습니다.
required playlistIdRequired 요청이 필수 playlistId 속성 값을 지정하지 않았습니다.
required resourceIdRequired 요청에 snippet 개체가 resourceId를 지정하는 리소스가 포함되어야 합니다.

직접 사용해 보세요!

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