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

구현: 재생목록

다음 예는 YouTube Data API (v3)를 사용하여 재생목록 및 재생목록 항목과 관련된 기능을 수행하는 방법을 보여줍니다.

현재 사용자의 재생목록 검색

playlists.list 메서드를 호출하여 현재 인증된 사용자의 재생목록을 검색합니다. 요청에서 mine 매개변수의 값을 true로 설정합니다. mine 매개변수를 사용하는 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=snippet,contentDetails
        &mine=true

사용자 재생목록 검색

이 예시에서는 특정 채널에서 만든 재생목록을 검색합니다. 이 예시에는 다음 두 단계가 있습니다.

1단계: 채널 ID 검색하기

channels.list 메서드를 호출하여 특정 YouTube 사용자 이름과 연결된 채널 ID를 검색합니다. 이 예시에서 사용자 이름은 GoogleDevelopers입니다. API 응답에서 id 속성은 채널 ID를 식별합니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=id
        &forUsername=GoogleDevelopers
```
2단계: 채널 재생목록 검색하기

playlists.list 메서드를 호출하여 채널의 재생목록을 검색합니다. channelId 매개변수의 값을 1단계에서 얻은 값으로 설정합니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=snippet,contentDetails
        &channelId=UC_x5XG1OV2P6uZZ5FSM9Ttw
```

특정 재생목록에 대한 정보 가져오기

하나 이상의 특정 재생목록에 관한 정보를 검색하려면 playlists.list 메서드를 호출하고 id 매개변수를 원하는 리소스를 식별하는 쉼표로 구분된 YouTube 재생목록 ID 목록으로 설정합니다. 이 기능의 일반적인 사용 사례는 검색결과에 반환된 재생목록 그룹에 대한 추가 정보를 검색하는 것입니다. 예를 들어 각 재생목록의 항목 수를 검색할 수 있습니다.

아래 요청은 playlists.list 메서드를 호출하여 'GoogleDevelopers'라는 검색어와 일치하는 두 재생목록의 항목 수를 검색합니다. 이 정보는 playlist 리소스의 contentDetails.itemCount 속성에 있으므로 요청에서 part 매개변수 값을 contentDetails로 설정합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=contentDetails
        &id=PLOU2XLYxmsIIM9h1Ybw2DuRw6o2fkNMeR,PLyYlLs02rgBYRWBzYpoHz7m2SE8mEZ68w

재생목록 추가

이 예에서는 playlists.insert 메서드를 호출하여 인증된 사용자의 채널에 비공개 재생목록을 만듭니다. 이 메서드에 대한 모든 API 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.insert?
        part=snippet,status

API 탐색기 링크는 API 요청의 본문을 지정하는 매개변수도 설정합니다. 요청 본문에는 재생목록 제목, 설명, 개인 정보 보호 상태와 같은 정보를 정의하는 playlist 리소스가 포함됩니다. 이 예에서 요청 본문은 다음과 같습니다.

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "private"
  }
}

관련 코드 샘플: 자바, 자바스크립트, .NET, PHP, Python

재생목록 업데이트

이 예에서는 재생목록의 개인 정보 보호 상태를 private에서 public로 업데이트합니다. 이 예시에는 다음 두 단계가 있습니다.

1단계: 재생목록 ID 검색하기

playlist.list 메서드를 호출하여 현재 인증된 사용자 채널의 재생목록을 검색합니다. 위의 현재 사용자의 재생목록을 검색하기 위한 샘플 요청은 이 요청을 보여줍니다. API를 호출하는 애플리케이션은 API 응답을 처리하여 각 재생목록의 ID를 키로 사용하여 재생목록 목록을 표시할 수 있습니다.
2단계: 재생목록 업데이트하기

playlists.update 메서드를 호출하여 특정 재생목록을 수정합니다. 이 방법을 사용하려면 유효한 OAuth 2.0 승인 토큰이 필요합니다.

이 메서드를 호출할 때 snippet.title 속성이 필요하므로 요청 본문에는 playlist 리소스의 snippet 부분이 포함되어야 합니다. 또한 업데이트 중인 재생목록 리소스가 snippet.description 또는 snippet.tags 속성 값을 지정하는 경우 업데이트 요청에서 해당 값을 다시 지정해야 합니다. 그러지 않으면 삭제됩니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.update?
        part=snippet,status
```
위의 재생목록 추가 예와 같이 API 탐색기 링크는 API 요청의 본문을 지정하는 매개변수를 설정합니다. 요청 본문에는 재생목록 제목, 설명, 개인 정보 보호 상태와 같은 정보를 정의하는 playlist 리소스가 포함됩니다. 이 예에서는 다음 요청 본문을 사용합니다.
```
{
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "public"
  }
}
```
참고: API 탐색기에서 이 쿼리를 테스트하는 경우 리소스 본문에 유효한 재생목록 ID를 대체해야 합니다. 재생목록 ID를 가져오려면 먼저 위에 표시된 재생목록 추가 요청을 실행하는 것이 좋습니다. API 응답에서 재생목록 ID를 추출하고 이 값을 업데이트하려는 재생목록에 사용합니다. 이 예에서 사용한 재생목록 제목과 설명은 이 예에서 사용한 것과 동일합니다.

재생목록 항목 추가

이 예에서는 재생목록에 항목을 추가합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 이 예시에는 다음 두 단계가 있습니다.

1단계: 적절한 재생목록 ID 검색하기

playlist.list 메서드를 호출하여 현재 인증된 사용자 채널의 재생목록을 검색합니다. 위의 현재 사용자의 재생목록을 검색하기 위한 샘플 요청은 이 요청을 보여줍니다. API를 호출하는 애플리케이션은 API 응답을 처리하여 각 재생목록의 ID를 키로 사용하여 재생목록 목록을 표시할 수 있습니다.
2단계: 재생목록에 동영상 추가하기

playlistItems.insert 메서드를 호출하여 동영상을 재생목록에 추가합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 요청 본문은 최소한 다음 값을 지정하는 playlistItem 리소스입니다.
- snippet.playlistId는 동영상을 추가할 재생목록을 식별합니다. 1단계에서 얻은 재생목록 ID입니다.
- snippet.resourceId.kind에는 youtube#video 값이 포함되어 있습니다.
- snippet.resourceId.videoId는 재생목록에 추가하는 동영상을 식별합니다. 속성 값은 고유한 YouTube 동영상 ID입니다.
아래의 API 요청은 재생목록에 동영상을 추가합니다. 요청 본문은 다음과 같습니다.
```
{
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    }
  }
}
```
API 탐색기에서 요청을 완료하려면 snippet.playlistId 및 snippet.resourceId.videoId 속성 값을 설정해야 합니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.insert?
        part=snippet
```
참고: playlistItems.insert 메서드 문서에서는 재생목록 항목을 추가할 때 설정할 수 있는 다른 속성 값을 식별합니다.

재생목록 항목 업데이트

이 예에서는 재생목록이 재생목록의 첫 번째 항목이 되도록 업데이트합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 이 예시에는 다음 세 단계가 있습니다.

1단계: 적절한 재생목록 ID 검색하기

playlist.list 메서드를 호출하여 현재 인증된 사용자 채널의 재생목록을 검색합니다. 위의 현재 사용자의 재생목록을 검색하기 위한 샘플 요청은 이 요청을 보여줍니다. API를 호출하는 애플리케이션은 API 응답을 처리하여 각 재생목록의 ID를 키로 사용하여 재생목록 목록을 표시할 수 있습니다.
2단계: 선택한 재생목록의 항목 검색하기

playlistItems.list 메서드를 호출하여 선택한 재생목록의 동영상 목록을 검색합니다. playlistId 매개변수의 값을 1단계에서 얻은 재생목록 ID로 설정합니다.

API 응답의 각 리소스에는 항목을 고유하게 식별하는 재생목록 항목 ID를 식별하는 id 속성이 포함되어 있습니다. 이 값을 사용하여 다음 단계의 목록에서 항목을 삭제합니다.
3단계: 선택한 재생목록 항목 업데이트하기

playlistItems.update 메서드를 호출하여 재생목록에서 동영상의 위치를 변경합니다. part 매개변수 값을 snippet로 설정합니다. 요청 본문은 최소한 다음 값을 설정하는 playlistItem 리소스여야 합니다.
- id 속성을 2단계에서 얻은 재생목록 항목 ID로 설정합니다.
- snippet.playlistId 속성을 1단계에서 가져온 재생목록 ID로 설정합니다.
- snippet.resourceId.kind 속성을 youtube#video로 설정합니다.
- snippet.resourceId.videoId 속성을 재생목록에 포함된 동영상을 고유하게 식별하는 동영상 ID로 설정합니다.
- snippet.position 속성을 0 또는 항목을 표시할 위치 (0부터 시작하는 색인 사용)로 설정합니다.
아래의 API 요청은 재생목록 항목을 재생목록의 첫 번째 항목으로 업데이트합니다. 요청 본문은 다음과 같습니다.
```
{
  "id": "PLAYLIST_ITEM_ID",
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    },
    "position": 0
  }
}
```
API 탐색기에서 요청을 완료하려면 id, snippet.playlistId, snippet.resourceId.videoId 속성 값을 설정해야 합니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.update?
        part=snippet
```

재생목록 항목 삭제

이 예에서는 재생목록에서 동영상을 삭제합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 이 예시에는 3단계가 있습니다. 처음 두 단계는 재생목록 항목 업데이트의 위 예와 동일합니다.

이 단계를 완료한 후 playlistItems.delete 메서드를 호출하여 재생목록에서 동영상을 삭제합니다. 요청의 id 매개변수를 삭제할 항목의 재생목록 항목 ID로 설정합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

재생목록에서 동영상을 식별하는 데 사용되는 재생목록 항목 ID는 동영상을 고유하게 식별하는 YouTube 동영상 ID와 다릅니다. 재생목록 항목 ID는 동영상을 특정 재생목록의 항목으로 식별합니다.

API 탐색기에서 요청을 완료하려면 id 속성의 값을 설정해야 합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.delete?
        id=PLAYLIST_ITEM_ID

재생목록 삭제

이 예에서는 재생목록을 삭제합니다. 이 예시에는 다음 두 단계가 있습니다.

1단계: 재생목록 ID 검색하기

playlist.list 메서드를 호출하여 현재 인증된 사용자 채널의 재생목록을 검색합니다. 위의 현재 사용자의 재생목록을 검색하기 위한 샘플 요청은 이 요청을 보여줍니다. API를 호출하는 애플리케이션은 API 응답을 처리하여 각 재생목록의 ID를 키로 사용하여 재생목록 목록을 표시할 수 있습니다.
2단계: 재생목록 삭제하기

playlists.delete 메서드를 호출하여 특정 재생목록을 삭제합니다. 요청에서 id 매개변수는 삭제할 재생목록의 재생목록 ID를 지정합니다. 이 방법을 사용하려면 유효한 OAuth 2.0 승인 토큰이 필요합니다. API 탐색기에서 이 쿼리를 테스트하는 경우 id 매개변수 값을 유효한 재생목록 ID로 바꿔야 합니다.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.delete?
        id=PLAYLIST_ID
```
참고: API 탐색기에서 이 쿼리를 테스트하는 경우 id 매개변수 값을 유효한 재생목록 ID로 바꿔야 합니다. 재생목록 ID를 가져오려면 먼저 위에 표시된 재생목록 추가 요청을 실행하는 것이 좋습니다. API 응답에서 재생목록 ID를 추출하고 삭제하려는 재생목록에 해당 값을 사용합니다.