구현: 동영상

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

채널의 업로드된 동영상 가져오기

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

이 예에서는 전반적인 인기도를 결정하기 위해 다양한 신호를 결합하는 알고리즘을 사용하여 선택된 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
        &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와 같은 값으로 변경됩니다.

    요청 본문은 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 탐색기를 사용하여 이 쿼리를 테스트할 수 없습니다.

관련 코드 샘플: 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