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는 이 값이 시간의 길이를 지정함을 나타내며 문자 MS는 각각 분과 초를 나타냅니다. MS 문자 앞에 오는 # 문자는 둘 다 동영상의 분 또는 초 숫자를 지정하는 정수입니다. 예를 들어 값 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 – 화면 떨림이 있고 보정할 수 있습니다.