Videos

video 리소스는 YouTube 동영상을 나타냅니다.

메소드

API는 videos 리소스에 다음 메소드를 지원합니다.

getRating: 지정된 동영상의 목록에 대해 인증된 사용자가 적용한 평가를 검색합니다. 지금 사용해 보세요.
list: API 요청 매개변수와 일치하는 동영상의 목록을 반환합니다. 지금 사용해 보세요.
insert: YouTube에 동영상을 업로드하고 동영상의 메타데이터를 선택적으로 설정합니다.
update: 동영상의 메타데이터를 업데이트합니다. 지금 사용해 보세요.
delete: YouTube 동영상을 삭제합니다. 지금 사용해 보세요.
rate: 동영상에 좋아요 또는 싫어요 평가를 추가하거나 이러한 평가를 삭제합니다. 지금 사용해 보세요.

리소스 표현

아래의 JSON 구조는 videos 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "mpaaRating": string,
      "tvpgRating": string,
      "bbfcRating": string,
      "chvrsRating": string,
      "eirinRating": string,
      "cbfcRating": string,
      "fmocRating": string,
      "icaaRating": string,
      "acbRating": string,
      "oflcRating": string,
      "fskRating": string,
      "kmrbRating": string,
      "djctqRating": string,
      "russiaRating": string,
      "rtcRating": string,
      "ytRating": string
    }
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean
  },
  "statistics": {
    "viewCount": unsigned long,
    "likeCount": unsigned long,
    "dislikeCount": unsigned long,
    "favoriteCount": unsigned long,
    "commentCount": unsigned long
  },
  "player": {
    "embedHtml": string
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ]
  },
  "recordingDetails": {
    "locationDescription": string,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "recordingLocation": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성 이름
`kind`	`string` API 리소스의 유형입니다. 값은 `youtube#video`가 됩니다.
`etag`	`etag` 이 리소스의 Etag입니다.
`id`	`string` YouTube가 동영상을 고유하게 식별하는 데 사용하는 ID입니다.
`snippet`	`object` `snippet` 개체는 동영상의 제목, 설명, 카테고리 등 동영상에 대한 기본 세부정보를 포함합니다.
`snippet.publishedAt`	`datetime` 동영상을 업로드한 날짜 및 시간입니다. 값은 ISO 8601(`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.
`snippet.channelId`	`string` YouTube가 동영상이 업로드된 채널을 고유하게 식별하는 데 사용하는 ID입니다.
`snippet.title`	`string` 동영상의 제목입니다.
`snippet.description`	`string` 동영상이 설명입니다.
`snippet.thumbnails`	`object` 동영상에 관련된 미리보기 이미지 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
`snippet.thumbnails.(key)`	`object` 유효한 키 값은 다음과 같습니다. `default` – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다. `medium` – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. `high` – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
`snippet.thumbnails.(key).url`	`string` 이미지의 URL입니다.
`snippet.thumbnails.(key).width`	`unsigned integer` 이미지의 너비입니다.
`snippet.thumbnails.(key).height`	`unsigned integer` 이미지의 높이입니다.
`snippet.channelTitle`	`string` 동영상이 속하는 채널의 채널 제목입니다.
`snippet.tags[]`	`list` 동영상에 연결된 키워드 태그의 목록입니다. 태그는 공백을 포함할 수 있습니다. 이 필드는 동영상 업로더에게만 표시됩니다.
`snippet.categoryId`	`string` 동영상과 연결된 YouTube 동영상 카테고리의 카테고리 ID입니다.
`contentDetails`	`object` `contentDetails` 개체는 동영상의 길이 및 가로 세로 비율 등 동영상 콘텐츠에 대한 정보를 포함합니다.
`contentDetails.duration`	`string` 동영상의 길이입니다. 태그 값은 ISO 8601 길이(`PT#M#S` 형식)입니다. 여기서 문자 `PT`는 이 값이 시간의 길이를 지정함을 나타내며 문자 `M` 및 `S`는 각각 분과 초를 나타냅니다. `M`과 `S` 문자 앞에 오는 `#` 문자는 둘 다 동영상의 분 또는 초 숫자를 지정하는 정수입니다. 예를 들어 값 `PT15M51S`는 동영상 길이가 15분 51초임을 나타냅니다.
`contentDetails.dimension`	`string` 동영상을 3D로 볼 수 있는지 또는 2D로 볼 수 있는지를 나타냅니다.
`contentDetails.definition`	`string` 동영상을 고화질(`HD`)에서 볼 수 있는지 또는 표준 화질에서만 볼 수 있는지를 나타냅니다. 이 속성에 유효한 값은 다음과 같습니다. `hd` `sd`
`contentDetails.caption`	`string` 동영상에 캡션을 사용할 수 있는지 여부를 나타냅니다. 이 속성에 유효한 값은 다음과 같습니다. `false` `true`
`contentDetails.licensedContent`	`boolean` 동영상이 YouTube 콘텐츠 파트너가 소유권을 주장한 콘텐츠인 라이선스 콘텐츠를 표시하는지 여부를 나타냅니다.
`contentDetails.regionRestriction`	`object` `regionRestriction` 개체는 동영상을 볼 수 있거나 볼 수 없는 국가에 대한 정보를 포함합니다. 이 개체는 `contentDetails.regionRestriction.allowed` 속성 또는 `contentDetails.regionRestriction.blocked` 속성을 포함합니다.
`contentDetails.regionRestriction.allowed[]`	`list` 동영상을 볼 수 있는 국가를 식별하는 지역 코드 목록입니다. 이 속성이 존재하지만 속성 값에 없는 국가에서는 동영상 표시가 차단됩니다. 이 속성이 존재하지만 목록이 비어 있는 경우 동영상은 모든 국가에서 차단됩니다.
`contentDetails.regionRestriction.blocked[]`	`list` 동영상이 차단된 국가를 식별하는 지역 코드 목록입니다. 이 속성이 존재하지만 속성 값에 없는 국가에서는 동영상을 볼 수 있습니다. 이 속성이 존재하지만 목록이 비어 있는 경우 동영상은 모든 국가에서 볼 수 있습니다.
`contentDetails.contentRating`	`object` 다양한 평가 방식으로 동영상이 받은 등급을 지정합니다.
`contentDetails.contentRating.mpaaRating`	`string` 동영상의 MPAA(미국 영화 협회) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `mpaaG` – G `mpaaNc17` – NC-17 `mpaaPg` – PG `mpaaPg13` – PG-13 `mpaaR` – R `mpaaUnrated`
`contentDetails.contentRating.tvpgRating`	`string` 동영상의 TVPG 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `tvpg14` – TV-14 `tvpgG` – TV-G `tvpgMa` – TV-MA `tvpgPg` – TV-PG `tvpgUnrated` `tvpgY` – TV-Y `tvpgY7` – TV-Y7 `tvpgY7Fv` – TV-Y7-FV
`contentDetails.contentRating.bbfcRating`	`string` 동영상의 BBFC(British Board of Film Classification) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `bbfc12` – 12 `bbfc12a` – 12A `bbfc15` – 15 `bbfc18` – 18 `bbfcPg` – PG `bbfcR18` – R18 `bbfcU` – U `bbfcUnrated`
`contentDetails.contentRating.chvrsRating`	`string` 동영상의 CHVRS(Canadian Home Video Rating System) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `chvrs14a` – 14A `chvrs18a` – 18A `chvrsE` – E `chvrsG` – G `chvrsPg` – PG `chvrsR` – R `chvrsUnrated`
`contentDetails.contentRating.eirinRating`	`string` 동영상의 Eirin(映倫) 등급입니다. Eirin은 일본 등급 시스템입니다. 이 속성에 유효한 값은 다음과 같습니다. `eirinG` – G `eirinPg12` – PG-12 `eirinR15plus` – R15+ `eirinR18plus` – R18+ `eirinUnrated`
`contentDetails.contentRating.cbfcRating`	`string` 동영상의 CBFC(Central Board of Film Certification - 인도) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `cbfcA` – A `cbfcS` – S `cbfcU` – U `cbfcUA` – U/A `cbfcUnrated`
`contentDetails.contentRating.fmocRating`	`string` 동영상의 Centre national du cinéma et de l'image animé(프랑스 문화부) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `fmoc10` – 10 `fmoc12` – 12 `fmoc16` – 16 `fmoc18` – 18 `fmocE` – E `fmocU` – U `fmocUnrated`
`contentDetails.contentRating.icaaRating`	`string` 동영상의 ICAA(Instituto de la Cinematografía y de las Artes Audiovisuales - 스페인) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `icaa12` – 12 `icaa13` – 13 `icaa16` – 16 `icaa18` – 18 `icaa7` – 7 `icaaApta` – APTA `icaaUnrated` `icaaX` – X
`contentDetails.contentRating.acbRating`	`string` 동영상의 ACB(Australian Classification Board) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `acbE` – E `acbG` – G `acbM` – M `acbMa15plus` – MA15+ `acbPg` – PG `acbR18plus` – R18+ `acbUnrated`
`contentDetails.contentRating.oflcRating`	`string` 동영상의 OFLC(Office of Film and Literature Classification - 뉴질랜드) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `oflcG` – G `oflcM` – M `oflcPg` – PG `oflcR13` – R13 `oflcR15` – R15 `oflcR16` – R16 `oflcR18` – R18 `oflcUnrated`
`contentDetails.contentRating.fskRating`	`string` 동영상의 FSK(Freiwillige Selbstkontrolle der Filmwirtschaft - Germany) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `fsk0` – FSK 0 `fsk12` – FSK 12 `fsk16` – FSK 16 `fsk18` – FSK 18 `fsk6` – FSK 6 `fskUnrated`
`contentDetails.contentRating.kmrbRating`	`string` 동영상의 영상물등급위원회(영상물등급위원회(KMRB) 등급입니다. 영상물등급위원회(KMRB)는 한국의 동영상을 평가합니다. 이 속성에 유효한 값은 다음과 같습니다. `kmrb12plus` – 12세 이상 관람가 `kmrb15plus` – 15세 이상 관람가 `kmrbAll` – 전체관람가 `kmrbR` – 청소년 관람불가 `kmrbTeenr` `kmrbUnrated`
`contentDetails.contentRating.djctqRating`	`string` 동영상의 DJCQT(Departamento de Justiça, Classificação, Qualificação e Títulos - 브라질) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `djctq10` – 10 `djctq12` – 12 `djctq14` – 14 `djctq16` – 16 `djctq18` – 18 `djctqL` – L `djctqUnrated`
`contentDetails.contentRating.russiaRating`	`string` 동영상의 MKRF(National Film Registry of the Russian Federation - 러시아) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `russia0` – 0+ `russia12` – 12+ `russia16` – 16+ `russia18` – 18+ `russia6` – 6+ `russiaUnrated`
`contentDetails.contentRating.rtcRating`	`string` 동영상의 General Directorate of Radio, Television and Cinematography(멕시코) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `rtcA` – A `rtcAa` – AA `rtcB` – B `rtcB15` – B15 `rtcC` – C `rtcD` – D `rtcUnrated`
`contentDetails.contentRating.ytRating`	`string` YouTube가 연령 제한 콘텐츠를 식별하기 위해 사용하는 등급입니다. 이 속성에 유효한 값은 다음과 같습니다. `ytAgeRestricted`
`status`	`object` `status` 개체는 동영상의 업로드, 처리, 개인정보 보호 상태에 대한 정보를 포함합니다.
`status.uploadStatus`	`string` 업로드한 동영상의 상태입니다. 이 속성에 유효한 값은 다음과 같습니다. `deleted` `failed` `processed` `rejected` `uploaded`
`status.failureReason`	`string` 이 값은 동영상이 업로드하지 못한 이유를 설명합니다. `uploadStatus` 속성이 업로드 실패를 나타내는 경우에만 이 속성이 존재합니다. 이 속성에 유효한 값은 다음과 같습니다. `codec` `conversion` `emptyFile` `invalidFile` `tooSmall` `uploadAborted`
`status.rejectionReason`	`string` 이 값은 YouTube가 업로드한 동영상을 거부한 이유를 설명합니다. `uploadStatus` 속성이 업로드가 거부되었음을 나타내는 경우에만 이 속성이 존재합니다. 이 속성에 유효한 값은 다음과 같습니다. `claim` `copyright` `duplicate` `inappropriate` `length` `termsOfUse` `trademark` `uploaderAccountClosed` `uploaderAccountSuspended`
`status.privacyStatus`	`string` 개인정보 보호 상태입니다. 이 속성에 유효한 값은 다음과 같습니다. `private` `public` `unlisted`
`status.license`	`string` 동영상의 라이선스입니다. 이 속성에 유효한 값은 다음과 같습니다. `creativeCommon` `youtube`
`status.embeddable`	`boolean` 이 값은 동영상을 다른 웹사이트에 삽입할 수 있는지 여부를 나타냅니다.
`status.publicStatsViewable`	`boolean` 이 값은 동영상 보기 페이지의 확장 동영상 통계가 모든 사용자에게 공개되는지 여부를 나타냅니다. 기본적으로 이 통계는 보이며 이 속성이 `false`로 설정되어도 동영상의 조회수 및 평가는 모든 사용자에게 공개됩니다.
`statistics`	`object` `statistics` 개체는 동영상에 대한 통계를 포함합니다.
`statistics.viewCount`	`unsigned long` 동영상이 조회된 횟수입니다.
`statistics.likeCount`	`unsigned long` 추천 버튼을 눌러서 동영상을 좋아함을 나타낸 사용자 수입니다.
`statistics.dislikeCount`	`unsigned long` 추천 안함 버튼을 눌러서 동영상을 싫어함을 나타낸 사용자 수입니다.
`statistics.favoriteCount`	`unsigned long` 현재 동영상을 즐겨찾기에 등록한 사용자 수입니다.
`statistics.commentCount`	`unsigned long` 동영상의 댓글 수입니다.
`player`	`object` `player` 개체는 내장 플레이어에서 동영상을 재생하기 위해 사용하려는 정보를 포함합니다.
`player.embedHtml`	`string` 동영상을 재생하는 플레이어를 삽입하는 `<iframe>` 태그입니다.
`topicDetails`	`object` `topicDetails` 개체는 동영상과 관련된 Freebase 주제에 대한 정보를 요약합니다.
`topicDetails.topicIds[]`	`list` 동영상과 가장 관련된 Freebase 주제 ID 목록입니다. 동영상 가운데에 추천된 주제이며 동영상 내용이 주로 이 주제에 대한 것이라고 말할 수 있습니다. Freebase Topic API를 사용하여 각 주제에 대한 정보를 검색할 수 있습니다.
`topicDetails.relevantTopicIds[]`	`list` 이 주제는 동영상에만 관련된다는 것을 제외하면 topic_id와 비슷합니다. 동영상에서 언급되거나 표시될 수 있는 주제입니다. Freebase Topic API를 사용하여 각 주제에 대한 정보를 검색할 수 있습니다.
`recordingDetails`	`object` `recordingDetails` 개체는 동영상이 녹화된 위치, 날짜, 주소에 대한 정보를 요약합니다.
`recordingDetails.locationDescription`	`string` 동영상이 녹화된 위치의 텍스트 설명입니다.
`recordingDetails.location`	`object` 동영상과 관련된 지리적 위치 정보입니다.
`recordingDetails.location.latitude`	`double` 위도(도)입니다.
`recordingDetails.location.longitude`	`double` 경도(도)입니다.
`recordingDetails.location.altitude`	`double` 기준 타원체 위의 고도(미터)입니다.
`recordingDetails.recordingDate`	`datetime` 동영상이 녹화된 날짜 및 시간입니다. 값은 ISO 8601(`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.
`fileDetails`	`object` `fileDetails` 개체는 파일의 해상도, 기간, 오디오 및 동영상 코덱, 스트림 전송률 등 YouTube로 업로드한 동영상 파일에 대한 정보를 요약합니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다.
`fileDetails.fileName`	`string` 업로드한 파일의 이름입니다. 이 필드는 동영상 파일 또는 다른 유형의 파일이 업로드되면 존재합니다.
`fileDetails.fileSize`	`unsigned long` 업로드한 파일의 크기(바이트)입니다. 이 필드는 동영상 파일 또는 다른 유형의 파일이 업로드되면 존재합니다.
`fileDetails.fileType`	`string` YouTube의 동영상 처리 엔진에서 감지한 업로드한 파일의 유형입니다. 현재 YouTube는 동영상 파일만 처리하지만 이 필드는 동영상 파일 또는 다른 파일 유형이 업로드되면 존재합니다. 이 속성에 유효한 값은 다음과 같습니다. `archive` – 이 파일은 .zip 보관 파일과 같은 보관 파일입니다. `audio` – 이 파일은 .mp3 파일과 같은 알려진 오디오 파일 형식입니다. `document` – 이 파일은 MS Word와 같은 문서 또는 텍스트 파일입니다. `image` – 이 파일은 .jpeg 이미지와 같은 이미지 파일입니다. `other` – 이 파일은 동영상이 아닌 다른 파일 형식입니다. `project` – 이 파일은 실제 동영상 데이터를 포함하지 않는 Microsoft Windows Movie Maker 프로젝트와 같은 동영상 프로젝트 파일입니다. `video` – 이 파일은 .mp4 파일과 같은 알려진 동영상 파일 형식입니다.
`fileDetails.container`	`string` 업로드한 동영상 파일의 컨테이너 형식입니다.
`fileDetails.videoStreams[]`	`list` 업로드한 동영상 파일에 포함된 동영상 스트림의 목록입니다. 목록의 각 형식은 동영상 스트림에 대한 상세한 메타데이터를 포함합니다.
`fileDetails.videoStreams[].widthPixels`	`unsigned integer` 인코딩한 동영상 콘텐츠의 너비(픽셀)입니다. 동영상의 인코딩 가로 세로 비율을 `width_pixels`/`height_pixels`로 계산할 수 있습니다.
`fileDetails.videoStreams[].heightPixels`	`unsigned integer` 인코딩한 동영상 콘텐츠의 높이(픽셀)입니다.
`fileDetails.videoStreams[].frameRateFps`	`double` 동영상 스트림의 프레임 속도(초당 프레임 수)입니다.
`fileDetails.videoStreams[].aspectRatio`	`double` 동영상 콘텐츠의 표시 가로 세로 비율이며 동영상을 표시해야 하는 가로 세로 비율을 지정합니다.
`fileDetails.videoStreams[].codec`	`string` 스트림이 사용하는 동영상 코덱입니다.
`fileDetails.videoStreams[].bitrateBps`	`unsigned long` 동영상 스트림의 전송률(초당 비트 수)입니다.
`fileDetails.videoStreams[].rotation`	`string` YouTube에서 동영상을 제대로 표시하기 위해 원본 콘텐츠를 회전해야 하는 정도입니다. 이 속성에 유효한 값은 다음과 같습니다. `clockwise` – 동영상을 시계 방향으로 90도 회전해야 합니다. `counterClockwise` – 동영상을 시계 반대 방향으로 90도 회전해야 합니다. `none` – 동영상을 회전할 필요가 없습니다. `other` – 동영상을 일반적인 단순한 방법이 아닌 다른 방법으로 회전해야 합니다. `upsideDown` – 동영상을 180도 회전해야 합니다.
`fileDetails.videoStreams[].vendor`	`string` 동영상 공급업체를 고유하게 식별하는 값입니다. 이 값은 일반적으로 4자리 공급업체 코드입니다.
`fileDetails.audioStreams[]`	`list` 업로드한 동영상 파일에 포함된 오디오 스트림의 목록입니다. 목록의 각 형식은 오디오 스트림에 대한 상세한 메타데이터를 포함합니다.
`fileDetails.audioStreams[].channelCount`	`unsigned integer` 스트림이 포함하는 오디오 채널의 수입니다.
`fileDetails.audioStreams[].codec`	`string` 스트림이 사용하는 오디오 코덱입니다.
`fileDetails.audioStreams[].bitrateBps`	`unsigned long` 오디오 스트림의 전송률(초당 비트 수)입니다.
`fileDetails.audioStreams[].vendor`	`string` 동영상 공급업체를 고유하게 식별하는 값입니다. 이 값은 일반적으로 4자리 공급업체 코드입니다.
`fileDetails.durationMs`	`unsigned long` 업로드한 동영상의 길이(밀리초)입니다.
`fileDetails.bitrateBps`	`unsigned long` 업로드한 동영상 파일의 통합(동영상 및 오디오) 전송률(초당 비트 수)입니다.
`fileDetails.recordingLocation`	`object` 업로드한 동영상이 녹화된 장소를 식별하는 지리학적 좌표입니다. 좌표는 WGS 84를 사용하여 정의합니다.
`fileDetails.recordingLocation.latitude`	`double` 위도(도)입니다.
`fileDetails.recordingLocation.longitude`	`double` 경도(도)입니다.
`fileDetails.recordingLocation.altitude`	`double` 기준 타원체 위의 고도(미터)입니다.
`fileDetails.creationTime`	`string` 업로드한 동영상 파일을 만든 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 현재 다음과 같은 ISO 8601 형식이 지원됩니다. 날짜만: `YYYY-MM-DD` 기본 형식: `YYYY-MM-DDTHH:MM:SS` 시간대 표시 시간: `YYYY-MM-DDTHH:MM:SS+HH:MM`
`processingDetails`	`object` `processingProgress` 개체는 업로드한 동영상 파일을 처리할 때 YouTube 처리에 대한 정보를 요약합니다. 이 개체의 속성은 YouTube가 동영상 처리를 마칠 때까지 남은 예상 시간 및 현재 처리 상태를 식별합니다. 또한 이 부분은 동영상에 파일 세부정보나 미리보기 이미지 등 다른 데이터나 콘텐츠 유형이 있는지 여부를 나타냅니다. `processingProgress` 개체는 폴링하도록 만들어져서 업로드한 동영상이 업로드한 동영상 파일을 처리할 때 YouTube에서 처리한 진행률을 추적할 수 있습니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다.
`processingDetails.processingStatus`	`string` 동영상의 처리 상태입니다. 이 값은 YouTube가 동영상을 처리할 수 있었는지 또는 동영상이 여전히 처리 중인지를 나타냅니다. 이 속성에 유효한 값은 다음과 같습니다. `failed` – 동영상을 처리하지 못했습니다. ProcessingFailureReason을 참조하세요. `processing` – 동영상을 현재 처리 중입니다. ProcessingProgress를 참조하세요. `succeeded` – 동영상을 처리했습니다. `terminated` – 처리 정보를 더 이상 볼 수 없습니다.
`processingDetails.processingProgress`	`object` `processingProgress` 개체는 동영상을 처리할 때 YouTube 처리에 대한 정보를 포함합니다. 이 값은 동영상의 처리 상태가 `processing`인 경우에만 관련이 있습니다.
`processingDetails.processingProgress.partsTotal`	`unsigned long` 동영상에 대해 처리해야 할 예상 총 부분 수입니다. 이 숫자는 YouTube에서 동영상을 처리할 때 더 정확한 예상치로 업데이트될 수 있습니다.
`processingDetails.processingProgress.partsProcessed`	`unsigned long` YouTube에서 처리한 동영상 부분의 수입니다. 다음과 같이 YouTube에서 처리한 동영상의 비율을 계산할 수 있습니다. `100 * parts_processed / parts_total` 예상 부분 수는 증가하는데 이미 처리된 부분 수는 늘어나지 않으므로 YouTube가 동영상을 처리할 때 계산된 처리가 주기적으로 줄어들 수 있습니다.
`processingDetails.processingProgress.timeLeftMs`	`unsigned long` YouTube에서 동영상 처리를 완료하는 데 필요한 예상 시간(밀리초)입니다.
`processingDetails.processingFailureReason`	`string` YouTube에서 동영상을 처리하지 못한 이유입니다. 이 속성은 `processingStatus` 속성의 값이 `failed`인 경우에만 값이 있습니다. 이 속성에 유효한 값은 다음과 같습니다. `other` – 일부 처리 구성요소가 실패했습니다. `streamingFailed` – 동영상을 스트리머로 보낼 수 없습니다. `transcodeFailed` – 콘텐츠 코드를 변환하지 못했습니다. `uploadFailed` – 파일을 게재하지 못했습니다.
`processingDetails.fileDetailsAvailability`	`string` 이 값은 업로드한 동영상에 파일 세부정보가 있는지 여부를 나타냅니다. `videos.list()` 요청에서 `fileDetails` 부분을 요청하여 동영상의 파일 세부정보를 검색할 수 있습니다.
`processingDetails.processingIssuesAvailability`	`string` 이 값은 동영상 처리 엔진에서 YouTube의 동영상 처리 기능을 향상할 수 있는 제안, 동영상 처리 문제를 설명하는 경고, 동영상 처리 문제를 만드는 오류를 생성했는지 여부를 나타냅니다. `videos.list()` 요청에서 `suggestions` 부분을 요청하여 이 제안을 검색할 수 있습니다.
`processingDetails.tagSuggestionsAvailability`	`string` 이 값은 동영상에 키워드(태그) 제안이 있는지 여부를 나타냅니다. 다른 사용자가 동영상을 쉽게 찾을 수 있도록 동영상의 메타데이터에 태그를 추가할 수 있습니다. `videos.list()` 요청에서 `suggestions` 부분을 요청하여 이 제안을 검색할 수 있습니다.
`processingDetails.editorSuggestionsAvailability`	`string` 이 값은 동영상에 동영상 품질이나 재생 환경을 향상시킬 수 있는 동영상 편집 제안이 있는지 여부를 나타냅니다. `videos.list()` 요청에서 `suggestions` 부분을 요청하여 이 제안을 검색할 수 있습니다.
`processingDetails.thumbnailsAvailability`	`string` 이 값은 동영상에 미리보기 이미지가 생성되었는지 여부를 나타냅니다.
`suggestions`	`object` `suggestions` 개체는 업로드한 동영상의 동영상 품질이나 메타데이터를 향상시키기 위한 추천을 식별하는 제안을 요약합니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다.
`suggestions.processingErrors[]`	`list` YouTube가 업로드된 동영상을 처리하지 못하게 하는 오류 목록입니다. 이 오류는 동영상의 현재 처리 상태에 관계 없이 결국에는 거의 확실히 `failed`가 될 것을 나타냅니다. 이 속성에 유효한 값은 다음과 같습니다. `archiveFile` – ZIP 보관 파일과 같은 보관 파일입니다. `audioFile` – MP3 파일과 같은 오디오만 포함하는 파일입니다. `docFile` – MS Word와 같은 문서 또는 텍스트 파일입니다. `imageFile` – JPEG 이미지와 같은 이미지 파일입니다. `notAVideoFile` – 동영상이 아닌 다른 파일입니다. `projectFile` – Microsoft Windows Movie Maker 프로젝트와 같은 영화 프로젝트 파일입니다.
`suggestions.processingWarnings[]`	`list` YouTube가 업로드한 동영상을 변환 코딩하는 데 문제가 있거나 변환 코딩이 잘못되는 원인의 목록입니다. 이러한 경고는 YouTube에서 업로드한 동영상 파일을 실제로 처리하기 전에 생성됩니다. 또한, 동영상 처리가 반드시 실패한다는 것을 나타내지는 않지만 동기화 문제, 동영상 아티팩트, 오디오 트랙 누락 등을 일으킬 수 있는 문제를 식별합니다. 이 속성에 유효한 값은 다음과 같습니다. `hasEditlist` – 편집 목록은 현재 지원되지 않습니다. `inconsistentResolution` – 충돌 컨테이너 및 스트림 해상도입니다. `problematicAudioCodec` – 문제를 일으킨다고 알려진 오디오 코덱이 사용되었습니다. `problematicVideoCodec` – 문제를 일으킨다고 알려진 동영상 코덱이 사용되었습니다. `unknownAudioCodec` – 인식할 수 없는 오디오 코덱이며 코드가 변환되지 않을 것입니다. `unknownContainer` – 인식할 수 없는 파일 형식이며 코드가 변환되지 않을 것입니다. `unknownVideoCodec` – 인식할 수 없는 동영상 코덱이며 코드가 변환되지 않을 것입니다.
`suggestions.processingHints[]`	`list` YouTube의 동영상 처리 기능을 향상시킬 수 있는 제안의 목록입니다. 이 속성에 유효한 값은 다음과 같습니다. `nonStreamableMov` – MP4 파일은 스트리밍되지 않고 처리 속도가 느려집니다. `sendBestQualityVideo` – 동영상의 더 나은 품질 버전입니다.
`suggestions.tagSuggestions[]`	`list` 동영상의 메타데이터에 추가하여 YouTube에서 검색하거나 찾아 볼 때 동영상을 찾을 가능성을 향상시킬 수 있는 키워드 태그 목록입니다.
`suggestions.tagSuggestions[].tag`	`string` 동영상에 추천된 키워드 태그입니다.
`suggestions.tagSuggestions[].categoryRestricts[]`	`list` 태그가 관련된 동영상 카테고리 모음입니다. 이 정보를 사용하여 동영상 업로더가 동영상과 연결한 동영상 카테고리를 기준으로 적합한 태그 제안을 표시할 수 있습니다. 키워드에 제한사항이 정의되지 않은 경우, 태그 제안은 기본적으로 모든 카테고리에 관련되어 있습니다.
`suggestions.editorSuggestions[]`	`list` 업로드한 동영상의 동영상 품질 또는 재생 환경을 향상시킬 수 있는 동영상 편집 작업 목록입니다. 이 속성에 유효한 값은 다음과 같습니다. `audioQuietAudioSwap` – 오디오 트랙이 무음인 것 같고 나은 품질로 교환될 수 있습니다. `videoAutoLevels` – 사진 밝기 수준이 어두운 것 같고 수정할 수 있습니다. `videoCrop` – 사진 주변에 감지된 여백(매트)를 자를 수 있습니다. `videoStabilize` – 화면 떨림이 있고 보정할 수 있습니다.