구현: 동영상

다음 예에서는 YouTube Data API (v3)를 사용하여 동영상과 관련된 기능을 실행하는 방법을 보여줍니다.

채널의 업로드된 동영상 검색

이 예에서는 특정 채널에 업로드된 동영상을 검색합니다. 이 예에는 두 단계가 있습니다.

이 예에서는 YouTube에서 가장 인기 있는 동영상 목록을 가져오는 방법을 보여줍니다. 이 목록은 다양한 신호를 결합하여 전반적인 인기도를 판단하는 알고리즘을 사용하여 선택됩니다.

인기 급상승 동영상 목록을 가져오려면 videos.list 메서드를 호출하고 chart 매개변수의 값을 mostPopular로 설정합니다. 이 목록을 가져올 때 다음 매개변수 중 하나 또는 둘 다를 설정할 수도 있습니다.

  • regionCode: 지정된 지역의 동영상 목록을 반환하도록 API에 지시합니다.
  • videoCategoryId: 가장 인기 있는 동영상을 가져와야 하는 동영상 카테고리를 식별합니다.

아래 요청은 스페인에서 가장 인기 있는 스포츠 동영상을 검색합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &chart=mostPopular
        &regionCode=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)으로 변경됩니다.

    요청 본문은 video 리소스이며 여기서 id 속성은 삭제하려는 동영상의 동영상 ID를 지정합니다. 이 예에서는 리소스에 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로 설정합니다. 매개변수 값은 업데이트되는 동영상의 메타데이터 필드에 따라 다릅니다.

    요청 본문은 video 리소스이며 여기서 id 속성은 업데이트하려는 동영상의 동영상 ID를 지정합니다. 이 예에서는 리소스에 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 탐색기를 사용하여 이 쿼리를 테스트할 수 없습니다.

관련 코드 샘플: PHP, Python

동영상 삭제

이 예에서는 동영상을 삭제하는 방법을 보여줍니다. 이 예시에는 다음 단계가 있습니다.

  • 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단계: 악성 콘텐츠로 동영상 신고하기

    videos.reportAbuse 메서드에 승인된 요청을 전송하여 동영상을 실제로 신고합니다. 요청 본문은 신고된 동영상과 신고 이유를 모두 식별하는 JSON 객체입니다. 1단계에서 언급했듯이 일부 유형의 경우 보조 이유가 지원되며 적극 권장됩니다.

    JSON 객체의 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