Videos

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

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

메서드

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

getRating

권한이 있는 사용자가 지정된 동영상 목록에 부여한 평점을 가져옵니다. 지금 사용해보기

list

API 요청 매개변수와 일치하는 동영상 목록을 반환합니다. 지금 사용해보기

batchGetStats

API 요청 매개변수와 일치하는 동영상 통계 목록을 가져옵니다. 지금 사용해보기

insert

YouTube에 동영상을 업로드하고 선택적으로 동영상의 메타데이터를 설정합니다.

업데이트

동영상의 메타데이터를 업데이트합니다. 지금 사용해보기

삭제

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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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 - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 320px이고 높이가 180px입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. high - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 480px이고 높이가 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다. standard: high 해상도 이미지보다 훨씬 높은 해상도의 썸네일 이미지입니다. 이 이미지는 일부 동영상과 동영상을 참조하는 기타 리소스(예: 재생목록 항목 또는 검색 결과)에서 사용할 수 있습니다. 이 이미지는 너비가 640px이고 높이가 480px입니다. maxres: 썸네일 이미지의 최고 해상도 버전입니다. 이 이미지 크기는 일부 동영상과 재생목록 항목, 검색 결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비가 1280px이고 높이가 720px입니다.
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 동영상이 예정된/활성 상태의 라이브 방송인지 나타냅니다. 동영상이 예정된/활성 라이브 방송이 아닌 경우 값은 none입니다. 이 속성의 유효한 값은 다음과 같습니다. live none upcoming
snippet.defaultLanguage	string video 리소스의 snippet.title 및 snippet.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 문자는 값이 기간을 지정함을 나타내고 M 및 S 문자는 각각 분과 초의 길이를 나타냅니다. M 및 S 문자 앞에 있는 # 문자는 모두 동영상의 분 (또는 초) 수를 지정하는 정수입니다. 예를 들어 PT15M33S 값은 동영상의 길이가 15분 33초임을 나타냅니다. 동영상의 길이가 1시간 이상인 경우 기간은 PT#H#M#S 형식입니다. 여기서 H 문자 앞에 있는 #은 동영상의 길이를 시간으로 지정하며 다른 모든 세부정보는 위에 설명된 것과 동일합니다. 동영상의 길이가 1일 이상인 경우 P 및 T 문자가 분리되고 값의 형식은 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) 또는 오스트레일리아 통신 및 미디어 당국 (ACMA) 등급입니다. ACMA 등급은 아동용 텔레비전 프로그램을 분류하는 데 사용됩니다. 이 속성의 유효한 값은 다음과 같습니다. acbC – 오스트레일리아 통신 및 미디어청에서 C 등급을 부여한 프로그램입니다. 이 프로그램은 14세 미만 어린이 (미취학 아동 제외)가 시청할 수 있습니다. acbE – E acbG – G acbM – M acbMa15plus – MA15+ acbP – 오스트레일리아 통신 및 미디어 당국에서 P 등급을 부여한 프로그램입니다. 이 프로그램은 미취학 아동을 대상으로 합니다. acbPg – PG acbR18plus – 만 18세 이상 acbUnrated
contentDetails.contentRating.agcomRating	string 이탈리아의 Autorità per le Garanzie nelle Comunicazioni (AGCOM)에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. agcomT~T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string 칠레 TV의 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 분류 시스템 캐나다 영어 방송에 대한 캐나다 방송통신위원회 (CRTC)의 동영상 등급입니다. 자세한 내용은 캐나다 방송 표준 위원회 웹사이트를 참고하세요. 이 속성의 유효한 값은 다음과 같습니다. 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 동영상의 인도 영화 검열위원회 (CBFC) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. 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세 이상 - 포르노 콘텐츠 ccc18v – 18세 이상 - 과도하게 폭력적인 콘텐츠 ccc6 – 6+ - Inconveniente para menores de 7 años cccTe – 모든 시청자 cccUnrated
contentDetails.contentRating.cceRating	string 포르투갈의 Comissão de Classificação de Espect´culos에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. 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 벨기에 영화 검열 위원회의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string 루마니아 CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA)의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18세 이상 cnaAp – 아시아 태평양 cnaUnrated
contentDetails.contentRating.cncRating	string 프랑스의 등급 분류 시스템 - Commission de classification cinematographique 이 속성의 유효한 값은 다음과 같습니다. 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 룩셈부르크의 Commission de surveillance de la classification des films (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 동영상의 Departamento 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 – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string 이집트의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string 동영상의 Eirin (映倫) 등급입니다. Eirin은 일본 등급 분류입니다. 이 속성에 사용할 수 있는 값은 다음과 같습니다. eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – 만 18세 이상 eirinUnrated
contentDetails.contentRating.fcbmRating	string 말레이시아 영화 검열 위원회의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18PA fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU~U fcbmUnrated
contentDetails.contentRating.fcoRating	string 홍콩 영화, 신문, 기사 관리청의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. fcoI – I fcoIi – II fcoIia – IIA fcoIib – IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string 이 속성은 2015년 11월 2일에 지원 중단되었습니다. 대신 contentDetails.contentRating.cncRating 속성을 사용하세요. 동영상의 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.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 동영상의 Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - 독일) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. fsk0 – FSK 0 fsk12 – FSK 12 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 - 아일랜드) 등급입니다. 자세한 내용은 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 - Argentina) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. incaaAtp – ATP (Apta para todo publico) incaaC – X (18세 이상만 해당, 제한된 전시) incaaSam13 – 13 (만 13세 이상만 이용 가능) incaaSam16 – 16 (16세 이상만 해당) incaaSam18 – 18 (만 18세 이상만 이용 가능) 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 kijkwijzer14 – 14 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 인도네시아 Lembaga Sensor Film의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. 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)의 아동 및 청소년 미디어 위원회에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. 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 mcstT13 – T13 mcstT16 – T16 mcstT18 – T18 mcstK~K
contentDetails.contentRating.mdaRating	string 싱가포르의 미디어 개발청 (MDA), 특히 영화 검열 위원회 (BFC)에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 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) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-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 몰디브 국립 분류국의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. nbc12plus – 12세 이상 nbc15plus – 15세 이상 nbc18plus – 18세 이상 nbc18plusr~18+R 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 나이지리아 국립 영화 및 비디오 검열 위원회의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Nacionãlais Kino centrs (라트비아 국립 영화 센터)의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. nkclv12plus – 12세 이상 nkclv18plus – 18세 이상 nkclv7plus – 7세 이상 nkclvU~U nkclvUnrated
contentDetails.contentRating.oflcRating	string 동영상의 뉴질랜드 영화 및 문학 분류 사무국 (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 동영상의 멕시코 일반 라디오, 텔레비전, 영화 감독국 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string 아일랜드 Raidió Teilifís Éireann의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. rteCh – CH rteGa - 정식 버전 rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string 동영상의 러시아 연방 국립 영화 등록부 (MKRF - 러시아) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다. 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 동영상의 TV 시청 가이드라인 (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로 설정해야 합니다. 이 속성은 동영상의 공개 상태가 private이고 동영상이 게시된 적이 없는 경우에만 설정할 수 있습니다. 요청에서 과거의 특정 시간에 동영상이 게시되도록 예약하면 동영상이 즉시 게시됩니다. 따라서 status.publishAt 속성을 과거의 날짜와 시간으로 설정하는 효과는 동영상의 privacyStatus을 private에서 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 요청을 승인한 경우에만 반환됩니다.
status.containsSyntheticMedia	boolean videos.insert 또는 videos.update 요청에서 이 속성을 사용하면 채널 소유자가 동영상에 사실적인 변경되었거나 합성된 (A/S) 콘텐츠가 포함되어 있음을 공개할 수 있습니다. A/S 콘텐츠와 관련된 YouTube 정책에 대해 자세히 알아보세요. A/S 콘텐츠의 예로는 다음이 포함된 동영상이 있습니다. 실제 인물이 실제로 말하거나 하지 않은 행동을 한 것처럼 보이게 만듦 실제 사건 또는 장소의 영상을 변경 실제로는 발생하지 않았으나 진짜처럼 보이는 장면을 생성
statistics	object statistics 객체에는 동영상에 관한 통계가 포함됩니다.
statistics.viewCount	unsigned long 동영상의 조회수입니다. 2025년 3월 31일부터 Shorts 동영상의 경우 viewCount가 최소 시청 시간 요건 없이 Shorts 동영상의 재생 또는 다시보기가 시작되는 횟수를 반환합니다.
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 동영상의 댓글 수입니다.
paidProductPlacementDetails	object paidProductPlacementDetails 객체에는 동영상의 유료 PPL에 관한 정보가 포함되어 있습니다.
paidProductPlacementDetails.hasPaidProductPlacement	boolean 콘텐츠에 유료 PPL이 사용되는 경우 true로 설정됩니다. 기본값은 false입니다.
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가 지원 중단됨에 따라 2017년 2월 27일부터 주제 ID가 다르게 작동합니다. 당시 YouTube는 선별된 주제 ID를 소수 반환하기 시작했습니다. 2017년 2월 15일 현재 지원되는 주제 ID 보기 주제 음악 주제 /m/04rlf 음악 (상위 주제) /m/02mscn 기독교 음악 /m/0ggq0m 클래식 음악 /m/01lyv 국가 /m/02lkt 일렉트로닉 음악 /m/0glt670 힙합 음악 /m/05rwpb 인디 음악 /m/03_d0 재즈 /m/028sqc 아시아 음악 /m/0g293 라틴 아메리카 음악 /m/064t9 팝 음악 /m/06cqb 레게 /m/06j6l 리듬 앤 블루스 /m/06by7 록 음악 /m/0gywn 소울 음악 게임 주제 /m/0bzvm2 게임 (상위 주제) /m/025zzc 액션 게임 /m/02ntfj 액션 어드벤처 게임 /m/0b1vjn 캐주얼 게임 /m/02hygl 뮤직 비디오 게임 /m/04q1x3q 퍼즐 비디오 게임 /m/01sjng 레이싱 비디오 게임 /m/0403l3g 롤플레잉 비디오 게임 /m/021bp2 시뮬레이션 비디오 게임 /m/022dc6 스포츠 게임 /m/03hf_rm 전략 비디오 게임 스포츠 주제 /m/06ntj 스포츠 (상위 주제) /m/0jm_ 미식축구 /m/018jz 야구 /m/018w8 농구 /m/01cgz 복싱 /m/09xp_ 크리켓 /m/02vx4 미식축구 /m/037hz 골프 /m/03tmr 아이스 하키 /m/01h7lh 종합 격투기 /m/0410tth 모터스포츠 /m/07bs0 테니스 /m/07_53 배구 엔터테인먼트 주제 /m/02jjt 엔터테인먼트 (상위 주제) /m/09kqc 유머 /m/02vxn 영화 /m/05qjc 공연 예술 /m/066wd 프로 레슬링 /m/0f2f9 TV 프로그램 라이프스타일 주제 /m/019_rr 라이프스타일 (상위 주제) /m/032tl 패션 /m/027x7n 피트니스 /m/02wbm 음식 /m/03glg 취미 /m/068hy 반려동물 /m/041xxh 신체적 매력[미용] /m/07c1v 기술 /m/07bxq 관광 /m/07yv9 차량 사회 주제 /m/098wr 사회 (상위 주제) /m/09s1f 비즈니스 /m/0kt51 건강 /m/01h6rj 군대 /m/05qt0 정치 /m/06bvp 종교 기타 주제 /m/01k8wb 지식
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에 업로드된 동영상 파일에 관한 정보를 캡슐화합니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다. processingDetails.fileAvailability 속성 값이 available인 경우에만 fileDetails 객체가 반환됩니다.
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 동영상 스트림의 비트 전송률(bps)입니다.
fileDetails.videoStreams[].rotation	string YouTube에서 동영상을 올바르게 표시하기 위해 원본 소스 콘텐츠를 회전해야 하는 각도입니다. 이 속성의 유효한 값은 다음과 같습니다. clockwise - 동영상을 시계 방향으로 90도 회전해야 합니다. counterClockwise – 동영상을 시계 반대 방향으로 90도 회전해야 합니다. none - 동영상을 회전할 필요가 없습니다. other – 동영상이 사소하지 않은 다른 방식으로 회전되어야 합니다. upsideDown - 동영상을 거꾸로 회전해야 합니다.
fileDetails.videoStreams[].vendor	string 동영상 공급업체를 고유하게 식별하는 값입니다. 이 값은 일반적으로 4자리 공급업체 코드입니다.
fileDetails.audioStreams[]	list 업로드된 동영상 파일에 포함된 오디오 스트림 목록입니다. 목록의 각 형식은 오디오 스트림에 대한 상세한 메타데이터를 포함합니다.
fileDetails.audioStreams[].channelCount	unsigned integer 스트림에 포함된 오디오 채널 수입니다.
fileDetails.audioStreams[].codec	string 스트림에서 사용하는 오디오 코덱입니다.
fileDetails.audioStreams[].bitrateBps	unsigned long 오디오 스트림의 비트 전송률(bps)입니다.
fileDetails.audioStreams[].vendor	string 동영상 공급업체를 고유하게 식별하는 값입니다. 이 값은 일반적으로 4자리 공급업체 코드입니다.
fileDetails.durationMs	unsigned long 업로드된 동영상의 길이(밀리초)입니다.
fileDetails.bitrateBps	unsigned long 업로드된 동영상 파일의 결합된(동영상 및 오디오) 비트 전송률(bps)입니다.
fileDetails.creationTime	string 업로드된 동영상 파일이 생성된 날짜와 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 현재 지원되는 ISO 8601 형식은 다음과 같습니다. 날짜만: YYYY-MM-DD Naive time: 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 무비 메이커 프로젝트)
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 현지화된 동영상 설명입니다.