다음 예에서는 YouTube Data API (v3)를 사용하여 동영상과 관련된 기능을 실행하는 방법을 보여줍니다.
채널의 업로드된 동영상 가져오기
이 예시에서는 특정 채널에 업로드된 동영상을 가져옵니다. 이 예에는 두 단계가 있습니다.
-
1단계: 채널에 업로드된 동영상의 재생목록 ID 가져오기
channels.list
메서드를 호출하여 채널의 업로드된 동영상이 포함된 재생목록의 ID를 가져옵니다. 요청의part
매개변수 값에는 검색되는channel
리소스 파트 중 하나로contentDetails
이 포함되어야 합니다. API 응답에서contentDetails.relatedPlaylists.uploads
속성에는 재생목록 ID가 포함됩니다.채널을 식별하는 방법에는 여러 가지가 있습니다.
-
mine
매개변수 값을true
로 설정하여 현재 인증된 사용자의 YouTube 채널 정보를 가져옵니다. OAuth 2.0을 사용하여 요청을 승인해야 합니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &mine=true
-
forUsername
매개변수를 YouTube 사용자 이름으로 설정하여 해당 사용자 이름과 연결된 채널의 정보를 가져옵니다. 이 예시에서는forUsername
매개변수 값을Google
로 설정하여 Google의 공식 YouTube 채널 정보를 가져옵니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &forUsername=Google
-
id
매개변수를 정보를 가져오는 채널을 고유하게 식별하는 YouTube 채널 ID로 설정합니다. 이 예시에서는id
매개변수를UCK8sQmJBp8GCxrOtXWBpyEA
로 설정합니다. 이 값은 Google의 공식 YouTube 채널을 식별하기도 합니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
-
-
2단계: 업로드된 동영상 목록 가져오기
playlistItems.list
메서드를 호출하여 업로드된 동영상 목록을 가져옵니다.playlistId
매개변수의 값을 1단계에서 가져온 값으로 설정합니다. 이 예에서 매개변수 값은 Google의 공식 YouTube 채널에 업로드된 동영상 목록인UUK8sQmJBp8GCxrOtXWBpyEA
로 설정됩니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.list? part=snippet,contentDetails,status &playlistId=UUK8sQmJBp8GCxrOtXWBpyEA
가장 인기 있는 동영상 가져오기
이 예에서는 전반적인 인기도를 결정하기 위해 다양한 신호를 결합하는 알고리즘을 사용하여 선택된 YouTube의 가장 인기 있는 동영상 목록을 가져오는 방법을 보여줍니다.
가장 인기 있는 동영상 목록을 가져오려면 videos.list
메서드를 호출하고 chart
매개변수의 값을 mostPopular
로 설정합니다.
mostPopular
차트에는 인기 급상승 음악, 영화, 게임 동영상이 포함됩니다.
그런 다음 선택적으로 다음 매개변수를 설정할 수 있습니다.
regionCode
: API에 지정된 지역의 동영상 목록을 반환하도록 지시합니다. 이 매개변수 값은 ISO 3166-1 alpha-2 국가 코드입니다de.i18nRegions.list
메서드를 사용하여 YouTube에서 지원하는 지역 코드 목록을 가져올 수 있습니다.videoCategoryId
: 가장 인기 있는 동영상을 가져올 동영상 카테고리를 식별합니다.videoCategories.list
메서드를 사용하여 YouTube에서 지원하는 카테고리 ID 목록을 가져올 수 있습니다.
예를 들어 다음 요청은 스페인에서 가장 인기 있는 스포츠 동영상을 가져옵니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &chart=mostPopular ®ionCode=es &videoCategoryId=17
동영상 업로드
API 탐색기에서는 파일 업로드 기능을 지원하지 않으므로 이 설명은 실행 가능한 예시에 연결되지 않습니다. 다음 리소스를 사용하면 v3 API를 사용하여 동영상을 업로드할 수 있도록 애플리케이션을 수정할 수 있습니다.
-
API의 videos.insert 메서드에 관한 문서에는 다양한 프로그래밍 언어를 사용하여 동영상을 업로드하는 방법을 설명하는 여러 코드 샘플이 포함되어 있습니다.
-
재개 가능한 업로드 가이드에서는 애플리케이션이 재개 가능한 업로드 프로세스를 사용하여 동영상을 업로드하는 데 사용하는 HTTP 요청의 시퀀스를 설명합니다. 이 가이드는 Google API 클라이언트 라이브러리를 사용할 수 없는 개발자를 대상으로 합니다. 일부 클라이언트 라이브러리는 재개 가능한 업로드를 기본적으로 지원합니다.
-
동영상 업로드를 위한 JavaScript 예시에서는 CORS (교차 출처 리소스 공유)를 사용하여 웹페이지를 통해 동영상 파일을 업로드하는 방법을 보여줍니다. v3 API에서 사용하는 CORS 업로드 라이브러리는 재개 가능한 업로드를 기본적으로 지원합니다. 또한 이 예에서는
video
리소스의processingDetails
부분을 검색하여 업로드된 동영상의 상태를 확인하는 방법과 업로드된 동영상의 상태 변경을 처리하는 방법을 보여줍니다.
업로드된 동영상의 상태 확인
이 예시에서는 업로드된 동영상의 상태를 확인하는 방법을 보여줍니다. 업로드된 동영상은 인증된 사용자의 업로드된 동영상 피드에 즉시 표시됩니다. 하지만 동영상이 처리될 때까지는 YouTube에 표시되지 않습니다.
-
1단계: 동영상 업로드하기
videos.insert
메서드를 호출하여 동영상을 업로드합니다. 요청이 성공하면 API 응답에 업로드된 동영상의 고유 동영상 ID를 식별하는video
리소스가 포함됩니다. -
2단계: 동영상 상태 확인하기
videos.list
메서드를 호출하여 동영상의 상태를 확인합니다.id
매개변수의 값을 1단계에서 가져온 동영상 ID로 설정합니다.part
매개변수의 값을processingDetails
로 설정합니다.요청이 성공적으로 처리되면 API 응답에
video
리소스가 포함됩니다.processingDetails.processingStatus
속성 값을 확인하여 YouTube에서 동영상을 계속 처리하고 있는지 확인합니다. YouTube에서 동영상 처리를 완료하면 속성 값이processing
이 아닌succeeded
또는failed
와 같은 값으로 변경됩니다.요청 본문은
id
속성이 삭제하려는 동영상의 동영상 ID를 지정하는video
리소스입니다. 이 예시에서 리소스에는recordingDetails
객체도 포함됩니다.아래 요청은 동영상의 상태를 확인합니다. API 탐색기에서 요청을 완료하려면
id
속성 값을 설정해야 합니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet,processingDetails &id=VIDEO_ID
참고: 애플리케이션에서 API를 폴링하여 새로 업로드된 동영상의 상태를 주기적으로 확인할 수 있습니다. 동영상이 처리되면 애플리케이션에서 동영상 상태에 따라 게시판을 만들거나 다른 작업을 진행할 수 있습니다.
동영상 업데이트
이 예에서는 동영상이 녹화된 시간과 장소에 관한 정보를 추가하도록 동영상을 업데이트하는 방법을 보여줍니다. 이 예시에는 다음 단계가 있습니다.
-
1단계: 동영상 ID 가져오기
위의 단계에 따라 현재 인증된 사용자의 채널에 대해 업로드된 동영상을 가져옵니다. 이 목록을 사용하여 각 동영상의 ID를 키로 사용하는 동영상 목록을 표시할 수 있습니다.
참고: 검색 결과를 가져오거나 재생목록의 항목을 나열하는 등 동영상 ID를 가져오는 다른 방법도 많습니다. 하지만 동영상은 소유자만 업데이트할 수 있으므로 API 요청을 승인하는 사용자가 소유한 동영상 목록을 가져오는 것이 이 프로세스의 첫 번째 단계일 가능성이 높습니다.
-
2단계: 동영상 업데이트하기
videos.update
메서드를 호출하여 특정 동영상을 업데이트합니다.part
매개변수의 값을recordingDetails
로 설정합니다. (매개변수 값은 업데이트되는 동영상의 메타데이터 필드에 따라 달라집니다.)요청 본문은
id
속성이 업데이트할 동영상의 동영상 ID를 지정하는video
리소스입니다. 이 예시에서 리소스에는recordingDetails
객체도 포함됩니다.아래 샘플 리소스는 2013년 10월 30일에 보스턴에서 녹화된 동영상을 나타냅니다.
{ "id": "VIDEO_ID", "recordingDetails": { "location": { "latitude": "42.3464", "longitude": "-71.0975" } "recordingDate": "2013-10-30T23:15:00.000Z" } }
API 탐색기에서 요청을 완료하려면
id
속성 값을 설정해야 합니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update? part=snippet
맞춤 썸네일 이미지를 업로드하고 동영상에 설정하기
v3 API의 thumbnails.set
메서드를 사용하여 맞춤 미리보기 이미지를 업로드하고 동영상에 설정할 수 있습니다. 요청에서 videoId
매개변수의 값은 썸네일이 사용될 동영상을 식별합니다.
이 메서드에 필요한 미디어 파일 업로드 기능이 API 탐색기에서 지원되지 않으므로 API 탐색기를 사용하여 이 쿼리를 테스트할 수 없습니다.
동영상 삭제
이 예시에서는 동영상을 삭제하는 방법을 보여줍니다. 이 예시에는 다음 단계가 있습니다.
-
1단계: 동영상 ID 가져오기
위의 단계에 따라 현재 인증된 사용자의 채널에 대해 업로드된 동영상을 가져옵니다. 이 목록을 사용하여 각 동영상의 ID를 키로 사용하는 동영상 목록을 표시할 수 있습니다.
참고: 검색 결과를 가져오거나 재생목록의 항목을 나열하는 등 동영상 ID를 가져오는 다른 방법도 많습니다. 하지만 동영상은 소유자만 삭제할 수 있으므로 API 요청을 승인하는 사용자가 소유한 동영상 목록을 가져오는 것이 이 프로세스의 첫 번째 단계일 가능성이 높습니다.
-
2단계: 동영상 삭제하기
videos.delete
메서드를 호출하여 특정 동영상을 삭제합니다. 요청에서id
매개변수는 삭제할 동영상의 동영상 ID를 지정합니다. 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. API 탐색기에서 이 쿼리를 테스트하는 경우id
매개변수 값을 유효한 동영상 ID로 대체해야 합니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.delete? id=VIDEO_ID
악성 동영상 신고
이 예에서는 악성 콘텐츠가 포함된 동영상을 신고하는 방법을 보여줍니다. 이 예시에는 다음 단계가 있습니다.
-
1단계: 동영상이 신고되는 이유를 설명하는 ID 가져오기
videoAbuseReportReasons.list
메서드에 승인된 요청을 전송하여 동영상을 신고하는 유효한 이유 목록을 가져옵니다. 아래 샘플videoAbuseReportReason
리소스에는 스팸 또는 오해의 소지가 있는 콘텐츠가 포함된 동영상을 신고하기 위한 정보가 포함되어 있습니다.{ "kind": "youtube#videoAbuseReportReason", "etag": "\"tbWC5XrSXxe1WOAx6MK9z4hHSU8/Or2VqBIilpHU7j__oPzUFCvGVBw\"", "id": "S", "snippet": { "label": "Spam or misleading", "secondaryReasons": [ { "id": "27", "label": "Spam or mass advertising" }, { "id": "28", "label": "Misleading thumbnail" }, { "id": "29", "label": "Malware or phishing" }, { "id": "30", "label": "Pharmaceutical drugs for sale" }, { "id": "31", "label": "Other misleading info" } ] } }
리소스에 표시된 것처럼 이 이유는 보조 이유 목록과 연결됩니다. 스팸이 포함된 동영상을 신고할 때는 이유 ID를 제공해야 하며 보조 이유도 제공하는 것이 좋습니다.
-
2단계: 악용 콘텐츠로 동영상 신고하기
JSON 객체의videos.reportAbuse
메서드에 승인된 요청을 전송하여 실제로 동영상을 신고합니다. 요청 본문은 신고되는 동영상과 신고 이유를 모두 식별하는 JSON 객체입니다. 1단계에서 설명한 것처럼 일부 유형의 이유에는 보조 이유가 지원되며 적극 권장됩니다.videoId
속성은 신고되는 동영상을 식별합니다.아래 샘플 JSON 객체는 스팸 또는 혼동을 야기하는 콘텐츠가 포함되어 있으며, 특히 혼동을 야기하는 썸네일 이미지를 사용한 동영상에 플래그를 지정합니다. 위의 샘플 JSON 객체에 표시된 것처럼 스팸 또는 혼동을 야기하는 콘텐츠의 ID는 S입니다. 사용자를 현혹하는 썸네일의 ID는 28입니다.
{ "videoId": "VIDEO_ID", "reasonId": "S", "secondaryReasonId": "28", "comments": "Testing the video flagging feature.", "language": "en" }
videos.reportAbuse
요청은 OAuth 2.0을 사용하여 승인해야 합니다. 아래 링크를 클릭하면 API 탐색기에 위의 JSON 객체가 로드됩니다. 쿼리를 테스트하려면videoId
속성 값을 유효한 동영상 ID로 대체해야 합니다. 이 요청을 제출하면 실제로 동영상에 신고가 접수됩니다.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse