2020년 7월 28일 이후에 생성된 확인되지 않은 API 프로젝트에서
videos.insert
엔드포인트를 통해 업로드된 모든 동영상은 비공개 보기 모드로 제한됩니다. 이러한 제한을 해제하려면 각 API 프로젝트에서 감사를 수행하여 서비스 약관을 준수하는지 확인해야 합니다. 자세한 내용은 API 업데이트 기록을 참고하세요.
video
리소스는 YouTube 동영상을 나타냅니다.
방법
API는 videos
리소스에 다음 메서드를 지원합니다.
- getRating
- 지정된 동영상 목록에 대해 인증된 사용자가 적용한 평가를 검색합니다. 지금 사용해보기
- list
- API 요청 매개변수와 일치하는 동영상 목록을 반환합니다. 지금 사용해보기
- 삽입
- YouTube에 동영상을 업로드하고 동영상의 메타데이터를 선택적으로 설정합니다.
- 업데이트
- 동영상의 메타데이터를 업데이트합니다. 지금 사용해보기
- 삭제
- YouTube 동영상을 삭제합니다. 지금 사용해보기
- rate[세율]
- 동영상에 좋아요 또는 싫어요 평가를 추가하거나 동영상에서 평가를 삭제합니다. 지금 사용해보기
- 악용사례 신고
- 악성 콘텐츠가 포함된 동영상을 신고합니다. 지금 사용해보기
리소스 표현
다음 JSON 구조는 videos
리소스의 형식을 보여줍니다.
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "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 동영상이 게시된 날짜와 시간입니다. 이 시간은 동영상이 업로드된 시간과 다를 수 있습니다. 예를 들어 동영상을 비공개 동영상으로 업로드했다가 나중에 공개로 설정하는 경우 이 속성은 동영상이 공개된 시간을 지정합니다. 다음과 같은 몇 가지 특별한 경우가 있습니다.
|
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 분류 시스템(Canadian TV Classification System) 캐나다 영어 방송에 대해 Canadian Radio-Television and Telecommunications Commission(CRTC)에서 제공하는 동영상 등급입니다. 자세한 내용은 Canadian Broadcast Standards Council 웹사이트를 참고하세요. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.catvfrRating |
string 캐나다 라디오 텔레비전 및 통신 위원회 (CRTC)에서 캐나다 프랑스어 방송에 대한 동영상 평가입니다. 자세한 내용은 Canadian Broadcast Standards Council 웹사이트를 참고하세요. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cbfcRating |
string 동영상의 Central Board of Film Certification (CBFC - 인도) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 (Canadian Home Video Rating System) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cicfRating |
string Commission de Contrôle des Films (벨기에)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cnaRating |
string 루마니아의 CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cncRating |
string 프랑스의 등급 시스템 - 수수료 등급 분류 영화 촬영술 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.csaRating |
string 방송 콘텐츠를 평가하는 프랑스 Conseil supérieur de l?audiovisuel의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.cscfRating |
string 룩셈부르크의 CSCF (Commission de surveillance de laClassification des movies)의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 이집트의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 동영상의 Irish Film Classification Office (IFCO - Ireland) 등급입니다. 자세한 내용은 IFCO 웹사이트를 참고하세요. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.ilfilmRating |
string 이스라엘의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.incaaRating |
string 동영상의 IncAA (Instituto Nacional de Cine y Artes Audiovisuales - 아르헨티나) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kfcbRating |
string 케냐 영화 등급 분류 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (네덜란드)입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.kmrbRating |
string 동영상의 영상물등급위원회 (영상물등급위원회) 등급입니다. 영상물등급위원회(KMRB)에서 대한민국의 동영상을 평가합니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.lsfRating |
string 인도네시아 Lembaga 센서 필름에서 가져온 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mccaaRating |
string 몰타 영화 연령 분류 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mccypRating |
string Danish Film Institute (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 타이완 문화부 (文部)에서 받은 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mpaaRating |
string 동영상의 MPAA (Motion Picture Association of America) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mpaatRating |
string Motion Picture Association of America의 영화 예고편 및 미리보기 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.mtrcbRating |
string 영화 및 TV 프로그램 검토 및 분류 위원회 (필리핀)에서 제공한 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nbcRating |
string 몰디브 국가 분류 협회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nfrcRating |
string 불가리아 국립 영화 센터의 동영상 평점. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nfvcbRating |
string 나이지리아 국립 영화 및 동영상 검열 위원회의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.nkclvRating |
string 라트비아 국립영화센터 (Ncionálais Kino centrs)의 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.oflcRating |
string 동영상의 OFLC (Office of Film and Literature Classification - 뉴질랜드) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.pefilmRating |
string 페루의 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.resorteviolenciaRating |
string 베네수엘라의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.rtcRating |
string 동영상의 General Directorate of Radio, Television and Cinematography (멕시코) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.rteRating |
string 아일랜드 Raidió Teilifís Éireann의 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.russiaRating |
string 동영상의 MKRF - 러시아 연방 영화 등록처 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.skfilmRating |
string 슬로바키아의 동영상 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.smaisRating |
string 아이슬란드의 동영상 평점 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.smsaRating |
string Statens medier 개수 (스웨덴 국립미디어위원회)의 동영상 평가 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.tvpgRating |
string 동영상의 TVPG (TVPG) 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.contentRating.ytRating |
string YouTube에서 연령 제한 콘텐츠를 식별하기 위해 사용하는 등급입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.projection |
string 동영상의 프로젝션 형식을 지정합니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails.hasCustomThumbnail |
boolean 동영상 업로더가 동영상의 맞춤 썸네일 이미지를 제공했는지 여부를 나타냅니다. 이 속성은 동영상 업로더에게만 표시됩니다. |
status |
object status 객체에는 동영상의 업로드, 처리, 공개 설정 상태에 대한 정보가 포함됩니다. |
status.uploadStatus |
string 업로드된 동영상의 상태입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 요청을 승인한 경우에만 반환됩니다. |
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> 태그입니다. |
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 동영상 콘텐츠에 관한 대략적인 설명을 제공하는 Wikipedia 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 동영상 스트림의 비트 전송률(초당 비트 수)입니다. |
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 업로드한 동영상 파일의 결합(동영상 및 오디오) 비트 전송률(초당 비트 수)입니다. |
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 현지화된 동영상 설명입니다. |