Videos

2020년 7월 28일 이후에 만든 확인되지 않은 API 프로젝트에서 videos.insert 엔드포인트를 통해 업로드된 모든 동영상은 비공개 보기 모드로 제한됩니다. 이 제한을 해제하려면 각 API 프로젝트는 감사를 거쳐 서비스 약관을 준수하는지 확인해야 합니다. 자세한 내용은 API 업데이트 기록을 참고하세요.

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

방법

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

getRating
지정된 사용자가 동영상 목록에 부여한 평점을 검색합니다. 지금 사용해보기
list
API 요청 매개변수와 일치하는 동영상 목록을 반환합니다. 지금 사용해보기
삽입
YouTube에 동영상을 업로드하고 원하는 경우 동영상의 메타데이터를 설정합니다.
업데이트
동영상의 메타데이터를 업데이트합니다. 지금 사용해보기
delete
YouTube 동영상을 삭제합니다. 지금 사용해보기
rate[세율]
동영상에 좋아요 또는 싫어요 평가를 추가하거나 이러한 평가를 삭제합니다. 지금 사용해보기
reportAbuse
악성 콘텐츠가 포함된 동영상을 신고하세요. 지금 사용해보기

리소스 표현

다음 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,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "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,
    "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
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

속성

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

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#video입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube에서 동영상을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 제목, 설명, 카테고리 등 동영상에 대한 기본 세부정보가 포함됩니다.
snippet.publishedAt datetime
동영상이 게시된 날짜 및 시간입니다. 이 시간은 동영상이 업로드된 시간과 다를 수 있습니다. 예를 들어 동영상을 비공개 동영상으로 업로드한 후 나중에 공개로 설정하는 경우 이 속성은 동영상이 공개된 시간을 지정합니다.

다음과 같은 특별한 경우가 몇 가지 있습니다.
  • 동영상이 비공개 동영상으로 업로드되고 채널 소유자가 동영상 메타데이터를 검색하는 경우 속성 값은 동영상이 업로드된 날짜와 시간을 지정합니다.
  • 일부 공개 동영상으로 업로드된 경우 속성 값은 동영상을 업로드한 날짜와 시간도 지정합니다. 이 경우 동영상의 고유 동영상 ID를 아는 누구나 동영상 메타데이터를 검색할 수 있습니다.
값은 ISO 8601 형식으로 지정됩니다.
snippet.channelId string
YouTube가 동영상이 업로드된 채널을 고유하게 식별하는 데 사용하는 ID입니다.
snippet.title string
동영상 제목입니다. 속성 값의 최대 길이는 100자이며 <>를 제외한 모든 유효한 UTF-8 문자를 포함할 수 있습니다. videos.update 메서드를 호출하고 video 리소스의 snippet 부분을 업데이트하는 경우 이 속성의 값을 설정해야 합니다.
snippet.description string
동영상 설명입니다. 속성 값의 최대 길이는 5,000바이트이며 <>를 제외한 유효한 모든 UTF-8 문자를 포함할 수 있습니다.
snippet.thumbnails object
동영상과 연결된 썸네일 이미지의 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
snippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default – 기본 썸네일 이미지입니다. 동영상의 기본 썸네일 또는 동영상을 참조하는 리소스(예: 재생목록 항목 또는 검색결과)의 너비는 120픽셀, 높이 90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)에서 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high - 썸네일의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우, 너비는 480픽셀, 높이는 360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
  • standard - 썸네일 이미지의 high 해상도 이미지보다 해상도가 더 높은 버전입니다. 이 동영상은 일부 동영상 및 재생목록과 관련된 동영상을 비롯해 동영상과 관련된 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비 640px, 높이 480px입니다.
  • maxres - 썸네일 이미지의 가장 높은 해상도 버전입니다. 이 이미지 크기는 일부 동영상 및 동영상을 참조하는 기타 리소스(예: 재생목록 항목 또는 검색결과)에 사용할 수 있습니다. 너비 1,280픽셀, 높이 720픽셀의 이미지입니다.
snippet.thumbnails.(key).url string
이미지의 URL입니다.
snippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
snippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.
snippet.channelTitle string
동영상이 속한 채널의 채널 제목입니다.
snippet.tags[] list
동영상과 연결된 키워드 태그의 목록입니다. 태그에는 공백이 포함될 수 있습니다. 속성 값의 최대 길이는 500자(영문 기준)입니다. 글자 수 제한 계산 방식에 관한 다음 규칙을 참고하세요.
  • 속성 값은 목록이며 목록의 항목 간 쉼표가 한도에 포함됩니다.
  • 태그에 공백이 포함된 경우 API 서버는 따옴표로 묶인 것처럼 태그 값을 처리하며 따옴표는 문자 수 제한에 포함됩니다. 따라서 Foo-Baz 태그에는 7자가 포함되지만 Foo Baz 태그에는 9자가 포함됩니다.
snippet.categoryId string
동영상과 연결된 YouTube 동영상 카테고리입니다. videos.update 메서드를 호출하고 video 리소스의 snippet 부분을 업데이트하는 경우 이 속성의 값을 설정해야 합니다.
snippet.liveBroadcastContent string
동영상이 예정된/활성 실시간 방송인지를 나타냅니다. 동영상이 예정된/활성 실시간 방송이 아닌 경우에는 '없음'입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • live
  • none
  • upcoming
snippet.defaultLanguage string
video 리소스의 snippet.titlesnippet.description 속성에 있는 텍스트의 언어입니다.
snippet.localized object
snippet.localized 객체에는 동영상의 현지화된 제목과 설명 또는 동영상 메타데이터의 기본 언어 제목이 있습니다.
  • videos.list 요청이 hl 매개변수를 사용하여 현지화된 텍스트를 반환해야 하고 그리고 현지화된 텍스트를 이 언어로 사용할 수 있는 경우 현지화된 텍스트가 리소스 스니펫에 반환됩니다.
  • hl 매개변수 값이 지정되지 않았거나 값이 지정되었지만 지정된 언어로 현지화된 메타데이터를 사용할 수 없는 경우 기본 언어의 메타데이터가 반환됩니다.
속성에 읽기 전용 값이 포함되어 있습니다. 현지화된 제목을 추가, 업데이트 또는 삭제하려면 localizations 객체를 사용합니다.
snippet.localized.title string
현지화된 동영상 제목입니다.
snippet.localized.description string
현지화된 동영상 설명입니다.
snippet.defaultAudioLanguage string
default_audio_language 속성은 동영상의 기본 오디오 트랙에서 사용되는 언어를 지정합니다.
contentDetails object
contentDetails 객체에는 동영상 길이, 동영상에 자막을 사용할 수 있는지 여부 등 동영상 콘텐츠에 대한 정보가 포함되어 있습니다.
contentDetails.duration string
동영상의 길이입니다. 속성 값은 ISO 8601 길이입니다. 예를 들어, 길이가 1분 이상이고 길이가 1시간 미만인 동영상의 경우 길이는 PT#M#S 형식이고, 여기서 문자 PT는 값이 기간을 지정함을 나타내고, MS 문자는 각각 분과 초를 나타냅니다. MS 문자 앞에 있는 # 문자는 둘 다 동영상의 분 (또는 초)을 지정하는 정수입니다. 예를 들어 값 PT15M33S은 동영상 길이가 15분 33초임을 나타냅니다.

동영상 길이가 1시간 이상이면 재생 시간은 PT#H#M#S 형식입니다. 여기서 문자 H 앞에 있는 #는 동영상의 길이를 시간 단위로 지정하며, 다른 모든 세부정보는 위에 설명된 것과 동일합니다. 동영상의 길이가 1일 이상인 경우 문자 PT가 구분되며 값의 형식은 P#DT#H#M#S입니다. 자세한 내용은 ISO 8601 사양을 참조하세요.
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.acbRating string
동영상의 ACB (Australian Classification Board) 또는 ACMA (Australian Communications and Media Authority) 등급입니다. ACMA 등급은 어린이 TV 프로그램을 분류하는 데 사용됩니다.

이 속성의 유효한 값은 다음과 같습니다.
  • acbC – 오스트레일리아 통신 및 미디어 당국으로부터 C 등급 분류를 받은 프로그램 이 프로그램은 만 14세 미만의 어린이 (미취학 아동 제외)를 대상으로 합니다.
  • acbE~E
  • acbG~G
  • acbM~M
  • acbMa15plus~MA15+
  • acbP – 오스트레일리아 통신 및 미디어 당국으로부터 P 등급 분류를 받은 프로그램 이 프로그램은 미취학 아동을 대상으로 합니다.
  • acbPg~PG
  • acbR18plus~18세 이상
  • acbUnrated
contentDetails.contentRating.agcomRating string
이탈리아의 Autorità (le Garanzie nelle Comunicazioni)에서의 동영상 평점입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • agcomT~T
  • agcomUnrated
  • agcomVm14~VM14
  • agcomVm18~VM18
contentDetails.contentRating.anatelRating string
칠레 텔레비전 동영상의 Anatel (Asociación Nacional de Televisión) 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • anatelA~A
  • anatelF~F
  • anatelI~I
  • anatelI10~I-10
  • anatelI12~I-12
  • anatelI7~I-7
  • anatelR~R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
동영상의 영국 영화 등급 분류 위원회 (BBFC) 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • bbfc12~12
  • bbfc12a~12A
  • bbfc15~15
  • bbfc18~18
  • bbfcPg~PG
  • bbfcR18~R18
  • bbfcU~U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
태국 영화위원회의 동영상 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • bfvc13~13
  • bfvc15~15
  • bfvc18~18
  • bfvc20~20
  • bfvcB~B
  • bfvcE~E
  • bfvcG~G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
오스트리아 미디어 분류 위원회 (Bundesministerium für Unterricht, Kunst und Kultur)의 동영상 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • bmukk10~10+
  • bmukk12~12세 이상
  • bmukk14~14세 이상
  • bmukk16~16세 이상
  • bmukk6~6 이상
  • bmukk8~8+
  • bmukkAa – 제한되지 않음
  • bmukkUnrated
contentDetails.contentRating.catvRating string
캐나다 TV 등급 시스템: 캐나다 TV 등급 분류입니다. 자세한 내용은 캐나다 방송 표준 위원회 웹사이트를 참조하세요.

이 속성에 유효한 값은 다음과 같습니다.
  • catv14plus~14세 이상
  • catv18plus~18세 이상
  • catvC~C
  • catvC8~C8
  • catvG~G
  • catvPg~PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
캐나다 프랑스어 방송에 대한 캐나다 무선통신위원회 (CRTC)의 동영상 등급입니다. 자세한 내용은 캐나다 방송 표준 위원회 웹사이트를 참조하세요.

이 속성에 유효한 값은 다음과 같습니다.
  • catvfr13plus~13세 이상
  • catvfr16plus~16세 이상
  • catvfr18plus~18세 이상
  • catvfr8plus~8+
  • catvfrG~G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
동영상의 Central Board of Film Certification (CBFC - India) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • cbfcA~A
  • cbfcS~S
  • cbfcU~U
  • cbfcUnrated
  • cbfcUA~U.A
  • cbfcUA7plus~U.A
  • cbfcUA13plus~U.A
  • cbfcUA16plus~U.A
contentDetails.contentRating.cccRating string
동영상의 Consejo de Calificación Cinematográfica (칠레) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • ccc14~14세 이상
  • ccc18~18세 이상
  • ccc18s~18+ - contenido 포르노 포르노
  • ccc18v~18+ - contenido excesivamente 폭력적
  • ccc6 – 6+ - Conv no menores de 7 años
  • cccTe – Todo 안내
  • cccUnrated
contentDetails.contentRating.cceRating string
포르투갈의 동영상 등급은 다음과 같습니다.

이 속성에 유효한 값은 다음과 같습니다.
  • cceM12~12
  • cceM14~14
  • cceM16~16
  • cceM18~18
  • cceM4~4
  • cceM6~6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
동영상의 스위스 평점입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • chfilm0~0
  • chfilm12~12
  • chfilm16~16
  • chfilm18~18
  • chfilm6~6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
동영상의 캐나다 홈 비디오 등급 시스템 (CHVRS) 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • chvrs14a~14A
  • chvrs18a~18A
  • chvrsE~E
  • chvrsG~G
  • chvrsPg~PG
  • chvrsR~R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Commission de detrtrle des Films (벨기에)의 동영상 평점입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • cicfE~E
  • cicfKntEna~KNT/ENA
  • cicfKtEa~KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
루마니아 CONALIUL NALAL AL AUDIOVIZUALULUI (CNA)의 동영상 평점입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • cna12~12
  • cna15~15
  • cna18~18
  • cna18plus~18세 이상
  • cnaAp~AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
프랑스의 등급 분류 - 수수료 면제 분류 영화

이 속성에 유효한 값은 다음과 같습니다.
  • cnc10~10
  • cnc12~12
  • cnc16~16
  • cnc18~18
  • cncE~E
  • cncT~T
  • cncUnrated
contentDetails.contentRating.csaRating string
프랑스의 Conseil supérieur de l?audiovisuel에서 가져온 동영상 등급으로, 방송 콘텐츠를 평가합니다.

이 속성의 유효한 값은 다음과 같습니다.
  • csa10~10
  • csa12~12
  • csa16~16
  • csa18~18
  • csaInterdiction – 인터프리트
  • csaT~T
  • csaUnrated
contentDetails.contentRating.cscfRating string
룩셈부르크 위원회 감시 델라 분류 영화 (CSCF)의 동영상 등급.

이 속성에 유효한 값은 다음과 같습니다.
  • cscf12~12
  • cscf16~16
  • cscf18~18
  • cscf6~6
  • cscf9~9
  • cscfA~A
  • cscfAl~AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
체코에서의 동영상 평점.

이 속성에 유효한 값은 다음과 같습니다.
  • czfilm12~12
  • czfilm14~14
  • czfilm18~18
  • czfilmU~U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
동영상의 Sameamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - 브라질) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • djctq10~10
  • djctq12~12
  • djctq14~14
  • djctq16~16
  • djctq18~18
  • djctqL~L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
해당 동영상이 DJCQT (브라질) 등급을 받은 이유를 설명하는 이유입니다.
contentDetails.contentRating.ecbmctRating string
터키의 등급 분류 - 문화관광부의 평가 및 분류 위원회

이 속성의 유효한 값은 다음과 같습니다.
  • ecbmct13a~13A
  • ecbmct13plus~13세 이상
  • ecbmct15a~15A
  • ecbmct15plus~15세 이상
  • ecbmct18plus~18세 이상
  • ecbmct7a~7A
  • ecbmct7plus~7세 이상
  • ecbmctG~G
  • ecbmctUnrated
  • ecbmct6a~6A
  • ecbmct6plus~6 이상
  • ecbmct10a~10A
  • ecbmct10plus~10+
  • ecbmct16plus~16세 이상
contentDetails.contentRating.eefilmRating string
에스토니아에서의 동영상 등급.

이 속성에 유효한 값은 다음과 같습니다.
  • eefilmK12~K-12
  • eefilmK14~K-14
  • eefilmK16~K-16
  • eefilmK6~K-6
  • eefilmL~L
  • eefilmMs12~MS-12
  • eefilmMs6~MS-6
  • eefilmPere – 페어
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
이집트에서의 동영상 등급.

이 속성에 유효한 값은 다음과 같습니다.
  • egfilm18~18
  • egfilmBn~BN
  • egfilmGn~GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
동영상의 Eirin (映倫) 등급입니다. Eirin은 일본 등급 시스템입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • eirinG~G
  • eirinPg12~12세
  • eirinR15plus~15세 이상
  • eirinR18plus~18세 이상
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
말레이시아 영화 검열위원회의 영화 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • fcbm18~18
  • fcbm18pa~18PA
  • fcbm18pl~18PL
  • fcbm18sg~18SG
  • fcbm18sx~18SX
  • fcbmP13~P13
  • fcbmPg13~13세
  • fcbmU~U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
홍콩 영화, 신문, 기사 관리국의 동영상 평점입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • fcoI~I
  • fcoIi~I
  • fcoIia~IIA
  • fcoIib~IBB
  • fcoIii~III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
이 속성은 2015년 11월 2일부터 지원 중단되었습니다. 대신 contentDetails.contentRating.cncRating 속성을 사용하세요.

이 동영상의 Central Center du cinéma et de l'image animé (프랑스 문화부) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • fmoc10~10
  • fmoc12~12
  • fmoc16~16
  • fmoc18~18
  • fmocE~E
  • fmocU~U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
남아프리카 공화국 영화 및 간행물 위원회의 동영상 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • fpb10~10
  • fpb1012Pg~10~12PG
  • fpb13~13
  • fpb16~16
  • fpb18~18
  • fpb79Pg~7~9PG
  • fpbA~A
  • fpbPg~PG
  • fpbUnrated
  • fpbX18~X18
  • fpbXx~XX
contentDetails.contentRating.fpbRatingReasons[] list
동영상이 FPB (남아프리카 공화국) 등급을 받은 이유
contentDetails.contentRating.fskRating string
동영상의 FSK (Freiwillige Selbstkontrolle der Filmwirtschaft - 독일) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • fsk0~FSK 0
  • fsk12~12월 FSK
  • fsk16~FSK 16
  • fsk18~FSK 18
  • fsk6~FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
그리스에서의 동영상 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • grfilmE~E
  • grfilmK~K
  • grfilmK12~K-12
  • grfilmK13~K-13
  • grfilmK15~K-15
  • grfilmK17~K-17
  • grfilmK18~K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
동영상의 Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - 스페인) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • icaa12~12
  • icaa13~13
  • icaa16~16
  • icaa18~18
  • icaa7~7
  • icaaApta~APTA
  • icaaUnrated
  • icaaX~X
contentDetails.contentRating.ifcoRating string
동영상의 아일랜드 영화 분류국 (IFCO - Ireland) 등급입니다. 자세한 내용은 IFCO 웹사이트를 참고하세요.

이 속성에 유효한 값은 다음과 같습니다.
  • ifco12~12
  • ifco12a~12A
  • ifco15~15
  • ifco15a~15A
  • ifco16~16
  • ifco18~18
  • ifcoG~G
  • ifcoPg~PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
이스라엘에서의 동영상 평점.

이 속성에 유효한 값은 다음과 같습니다.
  • ilfilm12~12
  • ilfilm16~16
  • ilfilm18~18
  • ilfilmAa~AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
동영상의 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - 아르헨티나) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • incaaAtp - ATP (Apta para todo publico)
  • incaaC~X (Solo apta para Mayores de 18 años, de exhibición condicionada)
  • incaaSam13~13 (Solo apta para Mayores de 13 años)
  • incaaSam16~16 (Solo apta para Mayores de 16 años)
  • incaaSam18~18 (Solo apta para Mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
케냐 영화 분류 위원회의 동영상 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • kfcb16plus~16
  • kfcbG~GE
  • kfcbPg~PG
  • kfcbR~18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (네덜란드).

이 속성의 유효한 값은 다음과 같습니다.
  • kijkwijzer12~12
  • kijkwijzer16~16
  • kijkwijzer18~18
  • kijkwijzer6~6
  • kijkwijzer9~9
  • kijkwijzerAl~AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
동영상의 한국 영상물등급위원회 (영상물등급위원회) 등급입니다. 영상물등급위원회(KMRB)는 대한민국의 동영상을 평가합니다.

이 속성의 유효한 값은 다음과 같습니다.
  • kmrb12plus – 12세 이상
  • kmrb15plus – 15세 이상
  • kmrbAll – 전체관람가
  • kmrbR – 신규 방문자 불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
인도네시아 렘바가 센서 필름의 동영상 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • lsf13~13
  • lsf17~17
  • lsf21~21
  • lsfA~A
  • lsfBo~BO
  • lsfD~D
  • lsfR~R
  • lsfSu~SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
몰타 영화 연령 분류 위원회의 동영상 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • mccaa12~12
  • mccaa12a~12A
  • mccaa14 – 14 - 이 평점은 2013년에 도입된 새로운 분류 구조에서 삭제되었습니다.
  • mccaa15~15
  • mccaa16 – 16 - 이 평점은 2013년에 도입된 새로운 분류 구조에서 삭제되었습니다.
  • mccaa18~18
  • mccaaPg~PG
  • mccaaU~U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
이 동영상의 등급은 덴마크 영화 협회(Det Danske Filminstitut)의 어린이 및 청소년 미디어 위원회(Media Council for Children and Young People)에서 산출한 값입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • mccyp11~11
  • mccyp15~15
  • mccyp7~7
  • mccypA~A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
베트남의 동영상 등급 시스템 - MCST

이 속성에 유효한 값은 다음과 같습니다.
  • mcst0~0
  • mcst16plus~16세 이상
  • mcstC13~C13
  • mcstC16~C16
  • mcstC18~C18
  • mcstP~P
  • mcstUnrated
contentDetails.contentRating.mdaRating string
싱가포르 미디어 개발청 (MDA)의 동영상 등급, 특히 영화 위원회 (BFC)의 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • mdaG~G
  • mdaM18~M18
  • mdaNc16~NC16
  • mdaPg~PG
  • mdaPg13~13세
  • mdaR21~R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
노르웨이 미디어 기관 Medietilsynet의 동영상 평점입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • medietilsynet11~11
  • medietilsynet12~12
  • medietilsynet15~15
  • medietilsynet18~18
  • medietilsynet6~6
  • medietilsynet7~7
  • medietilsynet9~9
  • medietilsynetA~A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
핀란드의 Kansallinen Audiovisuaalinen Instituutti (시청각 연구소)의 동영상 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • meku12~12
  • meku16~16
  • meku18~18
  • meku7~7
  • mekuS~S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
동영상에 대한 Ministero dei Beni e delle Attività Culturali e del Turismo (이탈리아).

이 속성의 유효한 값은 다음과 같습니다.
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
동영상의 Ministerio de Cultura (콜롬비아) 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • moc12~12
  • moc15~15
  • moc18~18
  • moc7~7
  • mocBanned – 차단됨
  • mocE~E
  • mocT~T
  • mocUnrated
  • mocX~X
contentDetails.contentRating.moctwRating string
동영상의 타이완 문화부 (文設部) 평점

이 속성에 유효한 값은 다음과 같습니다.
  • moctwG~G
  • moctwP~P
  • moctwPg~PG
  • moctwR~R
  • moctwR12~R-12
  • moctwR15~R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
동영상의 MPAA (Motion Picture Association of America) 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • mpaaG~G
  • mpaaNc17~NC-17
  • mpaaPg~PG
  • mpaaPg13~13세
  • mpaaR~R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
영화 예고편 및 미리보기에 대한 미국 영화 협회의 등급입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • mpaatGb~GB (녹색 밴드 - 모든 잠재고객 승인)
  • mpaatRb~RB (레드 밴드 - 만 17세 이상 권장)
contentDetails.contentRating.mtrcbRating string
영화 및 TV 리뷰 및 분류 위원회 (필리핀)의 동영상 평점

이 속성에 유효한 값은 다음과 같습니다.
  • mtrcbG~G
  • mtrcbPg~PG
  • mtrcbR13~R-13
  • mtrcbR16~R-16
  • mtrcbR18~R-18
  • mtrcbUnrated
  • mtrcbX~X
contentDetails.contentRating.nbcRating string
동영상의 동영상 등급은 몰디브 국립 분류국(NB)에 있습니다.

이 속성에 유효한 값은 다음과 같습니다.
  • nbc12plus~12세 이상
  • nbc15plus~15세 이상
  • nbc18plus~18세 이상
  • nbc18plusr~18세 이상
  • nbcG~G
  • nbcPg~PG
  • nbcPu~PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
불가리아 국립영화센터의 동영상 등급.

이 속성에 유효한 값은 다음과 같습니다.
  • nfrcA~A
  • nfrcB~B
  • nfrcC~C
  • nfrcD~D
  • nfrcUnrated
  • nfrcX~X
contentDetails.contentRating.nfvcbRating string
동영상의 나이지리아 국립 영화 및 동영상 검열 위원회(MRC)의 평점입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • nfvcb12~12
  • nfvcb12a~12A
  • nfvcb15~15
  • nfvcb18~18
  • nfvcbG~G
  • nfvcbPg~PG
  • nfvcbRe~RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
동영상에 대한 나시오날레 키노 센트럴 (라트비아 국립영화센터)의 평점.

이 속성에 유효한 값은 다음과 같습니다.
  • nkclv12plus~12세 이상
  • nkclv18plus~18세 이상
  • nkclv7plus~7세 이상
  • nkclvU~U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
동영상의 OFLC(Office of Film and Literature Classification) 등급(OFLC - 뉴질랜드) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • oflcG~G
  • oflcM~M
  • oflcPg~PG
  • oflcR13~R13
  • oflcR15~R15
  • oflcR16~R16
  • oflcR18~R18
  • oflcRp13~RP13
  • oflcRp16~RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
페루의 동영상 평점입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • pefilm14~14
  • pefilm18~18
  • pefilmPg~PG
  • pefilmPt~PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
베네수엘라에서의 동영상 평점.

이 속성에 유효한 값은 다음과 같습니다.
  • resorteviolenciaA~A
  • resorteviolenciaB~B
  • resorteviolenciaC~C
  • resorteviolenciaD~D
  • resorteviolenciaE~E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
동영상의 일반 라디오, 텔레비전, 영화 (MRC) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • rtcA~A
  • rtcAa~AA
  • rtcB~B
  • rtcB15~B15
  • rtcC~C
  • rtcD~D
  • rtcUnrated
contentDetails.contentRating.rteRating string
아일랜드의 Raidió Teilifís Éireann에서 기록한 동영상 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • rteCh~CH
  • rteGa~GA
  • rteMa~MA
  • rtePs~PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
동영상의 러시아 연방 영화 등록국 (MKRF - RU) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • russia0~0+
  • russia12~12세 이상
  • russia16~16세 이상
  • russia18~18세 이상
  • russia6~6 이상
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
슬로바키아에서의 동영상 등급.

이 속성에 유효한 값은 다음과 같습니다.
  • skfilmG~G
  • skfilmP2~P2
  • skfilmP5~P5
  • skfilmP8~P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
아이슬란드에서의 동영상 평점.

이 속성에 유효한 값은 다음과 같습니다.
  • smais12~12
  • smais14~14
  • smais16~16
  • smais18~18
  • smais7~7
  • smaisL~L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
동영상의 상태: Statens medieråd (스웨덴 국립 미디어 위원회)

이 속성에 유효한 값은 다음과 같습니다.
  • smsa11~11
  • smsa15~15
  • smsa7~7
  • smsaA~전체 연령대
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
동영상의 TVPG (가족용 콘텐츠 등급) 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • tvpgG~TV-G
  • tvpgMa~TV-MA
  • tvpgPg~TV-PG
  • tvpgUnrated
  • tvpgY~TV-Y
  • tvpgY7~TV-Y7
  • tvpgY7Fv~TV-Y7-FV
  • pg14~TV-14
contentDetails.contentRating.ytRating string
YouTube에서 연령 제한 콘텐츠를 식별하는 데 사용하는 등급입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • ytAgeRestricted
contentDetails.projection string
동영상의 투영 형식을 지정합니다.

이 속성에 유효한 값은 다음과 같습니다.
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
동영상 업로더가 동영상의 맞춤 썸네일 이미지를 제공했는지 여부를 나타냅니다. 이 속성은 동영상 업로더에게만 표시됩니다.
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
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
동영상의 공개 설정 상태입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • private
  • public
  • unlisted
status.publishAt datetime
동영상이 게시되도록 예약된 날짜 및 시간입니다. 동영상의 공개 상태가 비공개인 경우에만 설정할 수 있습니다. 값은 ISO 8601 형식으로 지정됩니다. 이 속성의 동작에 대한 다음 두 가지 추가 사항을 알 수 있습니다.
  • videos.update 메서드를 호출할 때 이 속성 값을 설정하면 동영상이 이미 비공개인 경우에도 status.privacyStatus 속성 값을 private로 설정해야 합니다.
  • 요청으로 인해 과거의 특정 시점에 동영상이 게시되도록 예약되면 동영상이 즉시 게시됩니다. 따라서 status.publishAt 속성을 과거의 날짜 및 시간으로 설정하는 효과는 동영상의 privacyStatusprivate에서 public로 변경하는 것과 동일합니다.
status.license string
동영상 라이선스입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • creativeCommon
  • youtube
status.embeddable boolean
이 값은 동영상을 다른 웹사이트에 퍼갈 수 있는지 여부를 나타냅니다.
status.publicStatsViewable boolean
이 값은 동영상의 보기 페이지에 있는 확장된 동영상 통계를 공개적으로 볼 수 있는지를 나타냅니다. 기본적으로 이러한 통계는 표시되며 이 속성의 값이 false로 설정되더라도 동영상의 조회수 및 평점과 같은 통계는 공개적으로 표시됩니다.
status.madeForKids boolean
이 값은 동영상이 아동 대상으로 지정되었는지를 나타내며 동영상의 현재 '아동용' 상태를 포함합니다. 예를 들어 selfDeclaredMadeForKids 속성 값에 따라 상태가 결정될 수 있습니다. 채널, 동영상 또는 방송의 시청자층 설정에 대한 자세한 내용은 YouTube 고객센터를 참조하세요.
status.selfDeclaredMadeForKids boolean
videos.insert 또는 videos.update 요청에서 이 속성을 사용하면 채널 소유자가 동영상을 아동 대상으로 지정할 수 있습니다. videos.list 요청에서는 채널 소유자가 API 요청을 승인한 경우에만 속성 값이 반환됩니다.
statistics object
statistics 객체에는 동영상에 관한 통계가 포함되어 있습니다.
statistics.viewCount unsigned long
동영상이 조회된 횟수입니다.
statistics.likeCount unsigned long
동영상에 좋아요를 표시한 사용자 수입니다.
statistics.dislikeCount unsigned long
참고: statistics.dislikeCount 속성은 2021년 12월 13일부터 비공개로 설정되었습니다. 즉, 동영상 소유자가 API 요청을 인증한 경우에만 속성이 API 응답에 포함됩니다. 자세한 내용은 업데이트 기록을 참고하세요.

동영상에 싫어요 표시를 한 사용자 수입니다.
statistics.favoriteCount unsigned long
참고: 이 속성은 지원 중단되었습니다. 2015년 8월 28일부터 지원이 중단되었습니다. 이제 속성 값이 항상 0로 설정됩니다.
statistics.commentCount unsigned long
동영상의 댓글 수입니다.
player object
player 객체에는 삽입된 플레이어에서 동영상을 재생하는 데 사용할 정보가 포함되어 있습니다.
player.embedHtml string
동영상을 재생하는 플레이어를 삽입하는 <iframe> 태그
  • 리소스 검색 API 요청이 maxHeight 또는 maxWidth 매개변수의 값을 지정하면 삽입된 플레이어의 크기가 maxHeight 또는 maxWidth 요구사항을 충족하도록 조정됩니다.
  • 동영상의 가로세로 비율을 알 수 없는 경우 내장 플레이어의 기본값은 4:3 형식입니다.
player.embedHeight long
player.embedHtml 속성에 반환된 내장 플레이어의 높이입니다. 이 속성은 요청이 maxHeight 또는 maxWidth 매개변수의 값을 지정하고 동영상의 가로세로 비율이 알려진 경우에만 반환됩니다.
player.embedWidth long
player.embedHtml 속성에 반환된 내장 플레이어의 너비입니다. 이 속성은 요청이 maxHeight 또는 maxWidth 매개변수의 값을 지정하고 동영상의 가로세로 비율이 알려진 경우에만 반환됩니다.
topicDetails object
topicDetails 객체는 동영상과 관련된 주제에 대한 정보를 요약합니다.

중요: 주제 ID와 관련된 향후 변경사항에 대한 자세한 내용은 topicDetails.relevantTopicIds[]topicDetails.topicIds[] 속성의 정의와 업데이트 기록을 참고하세요.
topicDetails.topicIds[] list
중요: 이 속성은 2016년 11월 10일부터 지원 중단되었습니다. API가 더 이상 이 속성의 값을 반환하지 않으며 이제 동영상과 연결된 모든 주제가 topicDetails.relevantTopicIds[] 속성 값으로 반환됩니다.
topicDetails.relevantTopicIds[] list
동영상과 관련된 주제 ID 목록입니다.

이 속성은 2016년 11월 10일부터 지원이 중단되었습니다. 2017년 11월 10일까지 지원됩니다.

중요: Freebase 및 Freebase API에 대한 지원 중단으로 인해 주제 ID는 2017년 2월 27일부터 다르게 작동하기 시작했습니다. 그때 YouTube는 선별된 주제 ID를 표시하기 시작했습니다.

topicDetails.topicCategories[] list
동영상 콘텐츠에 대한 대략적인 설명을 제공하는 위키백과 URL 목록입니다.
recordingDetails object
recordingDetails 객체는 동영상이 녹화된 위치, 날짜, 주소에 대한 정보를 요약합니다.
recordingDetails.locationDescription string
이 속성은 2017년 6월 1일부터 지원 중단되었습니다. 자세한 내용은 지원 중단 공지사항을 참고하세요.

동영상이 녹화된 위치의 텍스트 설명입니다.
recordingDetails.location object
동영상과 연결된 위치정보입니다. 하위 속성 값은 동영상 소유자가 동영상과 연결하고자 하는 위치를 식별합니다. 이 값은 수정 가능하며 공개 동영상에서 검색할 수 있으며 공개 동영상에 대해 사용자에게 표시될 수 있습니다.
recordingDetails.location.latitude double
이 속성은 2017년 6월 1일부터 지원 중단되었습니다. 자세한 내용은 지원 중단 공지사항을 참고하세요.

위도
recordingDetails.location.longitude double
이 속성은 2017년 6월 1일부터 지원 중단되었습니다. 자세한 내용은 지원 중단 공지사항을 참고하세요.

경도입니다.
recordingDetails.location.altitude double
이 속성은 2018년 7월 9일부로 지원 중단되었습니다. 자세한 내용은 지원 중단 공지사항을 참고하세요.

기준 타원체 위의 고도(미터)입니다.
recordingDetails.recordingDate datetime
동영상이 녹화된 날짜 및 시간입니다. 값은 ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) 형식으로 지정됩니다.
fileDetails object
fileDetails 객체는 파일의 해상도, 재생 시간, 오디오 및 동영상 코덱, 스트림 비트 전송률 등 YouTube에 업로드된 동영상 파일에 대한 정보를 요약합니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다.

fileDetails 객체의 processingDetails.fileAvailability 속성에 값이 available인 경우에만 반환됩니다.
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.creationTime string
업로드된 동영상 파일이 만들어진 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 현재 지원되는 ISO 8601 형식은 다음과 같습니다.
  • 날짜만: YYYY-MM-DD
  • 기본 시간: YYYY-MM-DDTHH:MM:SS
  • 시간대 표시 시간: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
processingDetails 객체는 업로드된 동영상 파일을 처리하는 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 객체는 processingDetails.tagSuggestionsAvailability 속성 또는 processingDetails.editorSuggestionsAvailability 속성의 값이 available인 경우에만 반환됩니다.
suggestions.processingErrors[] list
YouTube가 업로드된 동영상을 처리할 수 없게 하는 오류 목록 이러한 오류는 동영상의 현재 처리 상태와 관계없이 결국 상태가 거의 failed가 됨을 나타냅니다.

이 속성에 유효한 값은 다음과 같습니다.
  • archiveFile – 보관 파일 (예: ZIP 보관 파일)입니다.
  • audioFile – 파일에 오디오만 포함됩니다 (예: MP3 파일).
  • docFile – 문서 또는 텍스트 파일 (예: MS Word 문서).
  • imageFile – 이미지 파일 (예: JPEG 이미지)입니다.
  • notAVideoFile – 동영상이 아닌 기타 파일입니다.
  • projectFile – 영화 프로젝트 파일 (예: Microsoft Windows Movie Maker Project).
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 – 동영상이 흔들리고 흔들릴 수 있습니다.
liveStreamingDetails object
liveStreamingDetails 객체에는 실시간 동영상 브로드캐스트에 대한 메타데이터가 포함되어 있습니다. 동영상이 예정된 실시간 방송이거나 완료된 실시간 방송인 경우에만 객체가 video 리소스에 표시됩니다.
liveStreamingDetails.actualStartTime datetime
방송이 실제로 시작된 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 이 값은 방송이 시작되기 전까지는 사용할 수 없습니다.
liveStreamingDetails.actualEndTime datetime
방송이 실제로 종료된 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 이 값은 방송이 끝날 때까지 사용할 수 없습니다.
liveStreamingDetails.scheduledStartTime datetime
방송이 시작되도록 예약된 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.
liveStreamingDetails.scheduledEndTime datetime
방송이 종료되도록 예약된 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 값이 비어 있거나 속성이 없으면 방송이 무기한 계속되도록 예약됩니다.
liveStreamingDetails.concurrentViewers unsigned long
현재 방송을 시청 중인 시청자 수입니다. 방송에 현재 시청자가 있고 방송 소유자가 동영상의 조회수를 숨기지 않은 경우, 속성과 그 값은 표시됩니다. YouTube는 방송이 끝나면 방송의 동시 시청자 수를 추적하지 않습니다. 따라서 이 속성은 이미 종료된 실시간 방송의 동영상을 시청한 시청자 수를 식별하지 않습니다.
YouTube Data API에서 반환하는 동시 시청자 수는 YouTube 분석을 통해 제공되는 처리된 스팸 방지 동시 시청자 수와 다를 수 있습니다. YouTube 고객센터에서 실시간 스트리밍 측정항목에 대해 자세히 알아보세요.
liveStreamingDetails.activeLiveChatId string
이 동영상에 연결된 현재 진행 중인 실시간 채팅의 ID입니다. 이 필드는 동영상이 현재 실시간 채팅이 가능한 실시간 방송인 경우에만 채워집니다. 이 필드를 완료하기 위해 브로드캐스트가 전환되고 나면 실시간 채팅이 종료됩니다. 실시간 방송의 경우 실시간 채팅 ID가 더 이상 이 동영상에 연결되지 않으며 영구 페이지에 표시되는 새 동영상에 연결됩니다.
localizations object
localizations 객체에는 동영상의 메타데이터 번역이 포함되어 있습니다.
localizations.(key) object
키 값과 연결된 현지화된 텍스트의 언어입니다. 값은 BCP-47 언어 코드가 포함된 문자열입니다.
localizations.(key).title string
현지화된 동영상 제목입니다.
localizations.(key).description string
현지화된 동영상 설명입니다.