2020년 7월 28일 이후에 생성된 확인되지 않은 API 프로젝트의
videos.insert
엔드포인트를 통해 업로드된 모든 동영상은 비공개 보기 모드로 제한됩니다. 이 제한을 해제하려면 각 API 프로젝트가 감사를 실시하여 서비스 약관을 준수하는지 확인해야 합니다. 자세한 내용은 API 업데이트 기록을 참고하세요.
video
리소스는 YouTube 동영상을 나타냅니다.
메서드
API는 videos
리소스에 대해 다음 메서드를 지원합니다.
- getRating
- 승인된 사용자가 지정된 동영상 목록에 부여한 평점을 가져옵니다. 지금 사용해보기
- list
- 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 동영상이 게시된 날짜 및 시간입니다. 이 시간은 동영상을 업로드한 시간과 다를 수 있습니다. 예를 들어 동영상을 비공개 동영상으로 업로드한 후 나중에 공개하면 이 속성에는 동영상이 공개된 시간이 지정됩니다. 다음과 같은 몇 가지 특수한 경우가 있습니다.
|
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 유효한 키 값은 다음과 같습니다.
|
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자(영문 기준)입니다. 글자 수 제한 계산 방식과 관련하여 다음 규칙을 참조하세요.
|
snippet.categoryId |
string 동영상과 연결된 YouTube 동영상 카테고리입니다. videos.update 메서드를 호출하고 video 리소스의 snippet 부분을 업데이트하는 경우 이 속성의 값을 설정해야 합니다. |
snippet.liveBroadcastContent |
string 동영상이 예정된/진행 중인 라이브 방송인지 나타냅니다. 또는 동영상이 예정된/활성 실시간 방송이 아닌 경우 '없음'입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
snippet.defaultLanguage |
string video 리소스의 snippet.title 및 snippet.description 속성에 있는 텍스트의 언어입니다. |
snippet.localized |
object snippet.localized 객체에는 동영상의 현지화된 제목 및 설명 또는 동영상 메타데이터의 기본 언어로 된 제목이 포함됩니다.
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 )로 시청할 수 있는지 또는 표준 화질로만 시청할 수 있는지 나타냅니다.이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.caption |
string 동영상에 자막을 사용할 수 있는지 여부를 나타냅니다. 이 속성의 유효한 값은 다음과 같습니다.
|
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 프로그램을 분류하는 데 사용됩니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.agcomRating |
string 이탈리아의 Autorità per le Garanzie nelle Comunicazioni(AGCOM)에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.anatelRating |
string 칠레 TV에 대한 동영상의 Anatel (Asociación Nacional de Televisión) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.bbfcRating |
string 동영상의 BBFC (British Board of Film Classification) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.bfvcRating |
string 태국 영화 및 동영상 검열 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.bmukkRating |
string 오스트리아 미디어 분류 위원회 (Bundesministerium für Unterricht, Kunst und Kultur)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.catvRating |
string 캐나다 TV 등급 시스템 - 캐나다 TV 분류 시스템: 캐나다 영어 방송에 대해 캐나다 라디오, TV, 통신위원회(CRTC)에서 부여한 동영상 등급입니다. 자세한 내용은 캐나다 방송 표준위원회 웹사이트를 참고하세요. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.catvfrRating |
string 캐나다 프랑스어 방송에 대한 캐나다 라디오텔레비전 및 통신위원회(CRTC)의 동영상 등급입니다. 자세한 내용은 캐나다 방송 표준 위원회 웹사이트를 참고하세요. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cbfcRating |
string 동영상의 CBFC (Central Board of Film Certification - 인도) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cccRating |
string 동영상의 Consejo de Calificación Cinematográfica(칠레) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cceRating |
string 포르투갈의 Comissão de Classificação de Espect´culos에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.chfilmRating |
string 스위스에서 동영상의 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.chvrsRating |
string 동영상의 캐나다 홈비디오 등급 시스템(CHVRS) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cicfRating |
string Commission de Contrôle des Films(벨기에)의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cnaRating |
string 루마니아 CONSILIUL NATIONAL AL AUDIOVIZUALULUI(CNA)의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cncRating |
string 프랑스의 등급 시스템 - Commission de classification cinematographique 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.csaRating |
string broadcasting content를 평가하는 프랑스의 Conseil supérieur de l?audiovisuel에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cscfRating |
string 룩셈부르크 CSCF (CCC)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.czfilmRating |
string 체코 공화국에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.djctqRating |
string 동영상의 Departamento de Justiça, Classificação, Qualificação e Títulos(DJCQT - 브라질) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.djctqRatingReasons[] |
list 동영상에 DJCQT(브라질) 등급이 부여된 이유를 설명하는 내용입니다. |
contentDetails.contentRating.ecbmctRating |
string 튀르키예의 평가 시스템 - 문화관광부 평가 및 분류위원회 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.eefilmRating |
string 에스토니에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.egfilmRating |
string EG에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.eirinRating |
string 동영상의 Eirin (映倫) 등급입니다. Eirin은 일본 등급 분류 체계입니다. 이 숙박 시설에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.fcbmRating |
string 말레이시아 영화 검열위원회에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.fcoRating |
string 홍콩 영화, 신문, 기사 관리국의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.fmocRating |
string 이 속성은 2015년 11월 2일부터 지원 중단되었습니다. 대신 contentDetails.contentRating.cncRating 속성을 사용하세요.동영상의 프랑스 문화부(Centre national du cinéma et de l'image animé) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.fpbRating |
string 남아프리카 공화국의 영화 및 출판위원회에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.fpbRatingReasons[] |
list 동영상이 FPB (남아프리카 공화국) 등급을 받은 이유 |
contentDetails.contentRating.fskRating |
string 동영상의 Freiwillige Selbstkontrolle der Filmwirtschaft(FSK - 독일) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.grfilmRating |
string 그리스에서 동영상의 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.icaaRating |
string 동영상의 ICAA (Instituto de la Cinematografía y de las Artes Audiovisuales - 스페인) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.ifcoRating |
string 동영상의 아일랜드 영화 분류 위원회(IFCO - 아일랜드) 등급입니다. 자세한 내용은 IFCO 웹사이트를 참고하세요. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.ilfilmRating |
string 이스라엘에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.incaaRating |
string 동영상의 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - 아르헨티나) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kfcbRating |
string 케냐 영화 분류 위원회(Kenya Film Classification Board)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (네덜란드). 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kmrbRating |
string 동영상의 대한민국 영상물등급위원회(KMRB) 등급입니다. KMRB는 대한민국에서 동영상에 등급을 부여합니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.lsfRating |
string 인도네시아 Lembaga Sensor Film의 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mccaaRating |
string 몰타 영화 연령 분류 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mccypRating |
string 덴마크 영화 협회 (Det Danske Filminstitut) 아동 및 청소년 미디어 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mcstRating |
string 베트남 - MCST에 적용되는 동영상 등급 분류 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mdaRating |
string 싱가포르 미디어 개발청(MDA) 및 특히 영화 검열 위원회(BFC)에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.medietilsynetRating |
string 노르웨이 미디어 당국인 Medietilsynet에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mekuRating |
string 핀란드 국립시청각연구소 (Kansallinen Audiovisualinen Instituutti)의 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mibacRating |
string 동영상의 평점: Ministero dei Beni e delle Attività Culturali e del Turismo (이탈리아)의 평점입니다. 이 숙박 시설에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mocRating |
string 동영상의 Ministerio de Cultura(콜롬비아) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.moctwRating |
string 대만 문화부 (文文BM)의 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mpaaRating |
string 동영상의 MPAA(미국 영화 협회) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mpaatRating |
string 영화 예고편 및 미리보기에 대한 미국 영화 협회의 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mtrcbRating |
string 영화 및 TV 검토 및 분류위원회(필리핀)에서 부여한 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nbcRating |
string 말레이시아 국가 분류국의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nfrcRating |
string 불가리아 국립 영화 센터의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nfvcbRating |
string 나이지리아 국가 영화 및 동영상 검열 위원회의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nkclvRating |
string Nacionillais Kino (라트비아 국립영화센터)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.oflcRating |
string 동영상의 뉴질랜드 영화 및 문학 등급 위원회(OFLC) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.pefilmRating |
string 페루에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.resorteviolenciaRating |
string 베네수엘라에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.rtcRating |
string 동영상의 멕시코 방송, 텔레비전, 영화 제작 총국 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.rteRating |
string 아일랜드의 Raidió Teilifís Éireann에서 받은 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.russiaRating |
string 동영상의 MKRF (National Film Registry of the Russian Federation - 러시아) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.skfilmRating |
string 슬로바키아에서의 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.smaisRating |
string 아이슬란드에서의 동영상 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.smsaRating |
string 스웨덴 국가미디어위원회 (Statens medieråd)의 동영상 평점입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.tvpgRating |
string 동영상의 TV 시청 가이드라인(TVPG) 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.ytRating |
string YouTube에서 연령 제한 콘텐츠를 식별하는 데 사용하는 등급입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.projection |
string 동영상의 프로젝션 형식을 지정합니다. 이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails.hasCustomThumbnail |
boolean 동영상 업로더가 동영상의 맞춤 썸네일 이미지를 제공했는지 여부를 나타냅니다. 이 속성은 동영상 업로더에게만 표시됩니다. |
status |
object status 객체에는 동영상의 업로드, 처리, 공개 상태에 관한 정보가 포함됩니다. |
status.uploadStatus |
string uploaded 동영상의 상태입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
status.failureReason |
string 이 값은 동영상 업로드에 실패한 이유를 설명합니다. 이 속성은 uploadStatus 속성이 업로드에 실패했다고 나타내는 경우에만 표시됩니다.이 속성의 유효한 값은 다음과 같습니다.
|
status.rejectionReason |
string 이 값은 YouTube에서 업로드된 동영상을 거부한 이유를 설명합니다. 이 속성은 uploadStatus 속성이 업로드가 거부되었음을 나타내는 경우에만 존재합니다.이 속성에 유효한 값은 다음과 같습니다.
|
status.privacyStatus |
string 동영상의 개인 정보 보호 상태입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
status.publishAt |
datetime 동영상 게시가 예약된 날짜 및 시간입니다. 동영상의 공개 상태가 비공개인 경우에만 설정할 수 있습니다. 값은 ISO 8601 형식으로 지정됩니다. 이 속성의 동작에 관한 다음 두 가지 추가 사항에 유의하세요.
|
status.license |
string 동영상의 라이선스입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 동영상이 조회된 횟수입니다. |
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> 태그입니다. |
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를 반환하기 시작했습니다. |
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는 동영상 파일만 처리하지만 동영상 파일 또는 다른 유형의 파일이 업로드되었는지와 관계없이 이 필드는 표시됩니다. 이 속성의 유효한 값은 다음과 같습니다.
|
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에서 동영상을 올바르게 표시하기 위해 원본 소스 콘텐츠를 회전해야 하는 각도입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
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 업로드된 동영상 파일의 합산(동영상 및 오디오) 비트 전송률(bps)입니다. |
fileDetails.creationTime |
string 업로드한 동영상 파일이 만들어진 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. 현재 다음 ISO 8601 형식이 지원됩니다.
|
processingDetails |
object processingDetails 객체는 업로드된 동영상 파일 처리 중인 YouTube의 진행 상황에 관한 정보를 캡슐화합니다. 객체의 속성은 현재 처리 상태와 YouTube에서 동영상 처리를 완료할 때까지 남은 예상 시간을 나타냅니다. 또한 이 부분은 동영상에 파일 세부정보나 미리보기 이미지 등 다른 데이터나 콘텐츠 유형이 있는지 여부를 나타냅니다.processingProgress 객체는 업로드된 동영상이 YouTube에서 업로드된 동영상 파일을 처리하는 진행 상황을 추적할 수 있도록 폴링되도록 설계되었습니다. 이 데이터는 동영상 소유자만 검색할 수 있습니다. |
processingDetails.processingStatus |
string 동영상의 처리 상태입니다. 이 값은 YouTube에서 동영상을 처리할 수 있었는지 또는 동영상이 아직 처리 중인지를 나타냅니다. 이 속성에 사용할 수 있는 유효한 값은 다음과 같습니다.
|
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 인 경우에만 값을 갖습니다.이 속성의 유효한 값은 다음과 같습니다.
|
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 임을 나타냅니다.이 속성에 유효한 값은 다음과 같습니다.
|
suggestions.processingWarnings[] |
list YouTube에서 업로드된 동영상을 트랜스코딩하는 데 어려움이 있거나 잘못된 트랜스코딩이 발생할 수 있는 이유 목록입니다. 이러한 경고는 YouTube에서 업로드된 동영상 파일을 실제로 처리하기 전에 생성됩니다. 또한 동영상 처리가 실패할 것이라는 것을 반드시 나타내지는 않지만 동기화 문제, 동영상 아티팩트, 누락된 오디오 트랙과 같은 문제를 일으킬 수 있는 문제도 식별합니다. 이 속성의 유효한 값은 다음과 같습니다.
|
suggestions.processingHints[] |
list YouTube의 동영상 처리 기능을 개선할 수 있는 제안 목록입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
suggestions.tagSuggestions[] |
list 사용자가 YouTube에서 검색하거나 탐색할 때 동영상을 찾을 가능성을 높이기 위해 동영상의 메타데이터에 추가할 수 있는 키워드 태그 목록입니다. |
suggestions.tagSuggestions[].tag |
string 동영상에 추천된 키워드 태그입니다. |
suggestions.tagSuggestions[].categoryRestricts[] |
list 태그와 관련된 동영상 카테고리 집합입니다. 이 정보를 사용하여 동영상 업로더가 동영상과 연결한 동영상 카테고리를 기준으로 적절한 태그 제안을 표시할 수 있습니다. 키워드에 제한사항이 정의되지 않은 경우, 태그 제안은 기본적으로 모든 카테고리에 관련되어 있습니다. |
suggestions.editorSuggestions[] |
list 업로드된 동영상의 동영상 품질 또는 재생 환경을 개선할 수 있는 동영상 편집 작업의 목록입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 현지화된 동영상 설명입니다. |