구현: 동영상

다음 예는 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 클라이언트 라이브러리를 사용할 수 없는 개발자를 주요 대상으로 합니다.

  • 동영상 업로드를 위한 자바스크립트 예에서는 교차 출처 리소스 공유 (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차적인 이유도 입력하는 것이 좋습니다.

  • 2단계: 악성 콘텐츠로 동영상 신고하기

    동영상을 실제로 신고하려면 videos.reportAbuse 메서드에 승인된 요청을 보내세요. 요청 본문은 신고된 동영상과 신고된 이유를 모두 식별하는 JSON 객체입니다. 1단계에 언급된 것처럼 일부 유형의 이유로는 2차적인 이유가 지원되며 적극 권장됩니다.

    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