thumbnail
리소스는 리소스와 연결된 다양한 썸네일 이미지 크기를 식별합니다. 미리보기 이미지의 특징은 다음과 같습니다.
- 리소스의
snippet.thumbnails
속성은 해당 리소스에 사용 가능한 썸네일 이미지를 식별하는 객체입니다. thumbnail
리소스에는 일련의 객체가 포함되어 있습니다. 각 객체의 이름(default
,medium
,high
등)은 썸네일 이미지 크기를 나타냅니다.- 다양한 유형의 리소스를 통해 미리보기 이미지의 다양한 크기를 지원할 수 있습니다.
- 서로 다른 리소스 유형이 동일한 썸네일 이미지의 크기를 서로 다르게 정의할 수 있습니다. 예를 들어
video
리소스의default
썸네일 이미지는 일반적으로 120x90픽셀이고,channel
리소스의default
썸네일 이미지는 일반적으로 88x88픽셀입니다. - 동일한 유형의 리소스는 원본 이미지의 해상도나 YouTube에 업로드된 콘텐츠의 해상도에 따라 특정 이미지의 썸네일 이미지 크기가 다를 수 있습니다. 예를 들어 HD 동영상은 HD가 아닌 동영상보다 더 높은 해상도의 미리보기를 지원할 수 있습니다.
- 썸네일 이미지 크기에 대한 정보가 포함된 각 객체에는
width
속성과height
속성이 있습니다. 하지만 width와 height 속성은 반환되지 않을 수도 있습니다. - 업로드한 썸네일 이미지가 필요한 크기와 일치하지 않는 경우 이미지의 크기를 변경하여 올바른 가로세로 비율로 변경하지 않습니다. 이미지가 잘리지는 않으나 올바른 크기로 맞추기 위해 이미지에 검은색 띠가 포함될 수 있습니다.
방법
API는 thumbnails
리소스에 다음 메서드를 지원합니다.
- 세트
- 맞춤 동영상 썸네일을 YouTube에 업로드하고 동영상에 설정합니다.
리소스 표현
다음 JSON 구조는 thumbnails
리소스의 형식을 보여줍니다.
{ "default": { "url": string, "width": unsigned integer, "height": unsigned integer }, "medium": { "url": string, "width": unsigned integer, "height": unsigned integer }, "high": { "url": string, "width": unsigned integer, "height": unsigned integer }, "standard": { "url": string, "width": unsigned integer, "height": unsigned integer }, "maxres": { "url": string, "width": unsigned integer, "height": unsigned integer } }
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 | |
---|---|
default |
object 기본 썸네일 이미지입니다. 동영상의 기본 썸네일(또는 재생목록 항목 또는 검색결과와 같이 동영상을 참조하는 리소스)은 너비 120픽셀, 높이 90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다. |
default.url |
string 이미지의 URL입니다. |
default.width |
unsigned integer 이미지의 너비입니다. |
default.height |
unsigned integer 이미지의 높이입니다. |
medium |
object 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 320픽셀, 높이 180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. |
medium.url |
string 이미지의 URL입니다. |
medium.width |
unsigned integer 이미지의 너비입니다. |
medium.height |
unsigned integer 이미지의 높이입니다. |
high |
object 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 480px, 높이 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다. |
high.url |
string 이미지의 URL입니다. |
high.width |
unsigned integer 이미지의 너비입니다. |
high.height |
unsigned integer 이미지의 높이입니다. |
standard |
object high 이미지보다 훨씬 높은 해상도의 썸네일 이미지입니다. 이 이미지는 일부 동영상 및 동영상을 참조하는 기타 리소스(예: 재생목록 항목 또는 검색결과)에 사용할 수 있습니다. 이미지 너비 640px, 높이 480px입니다. |
standard.url |
string 이미지의 URL입니다. |
standard.width |
unsigned integer 이미지의 너비입니다. |
standard.height |
unsigned integer 이미지의 높이입니다. |
maxres |
object 썸네일 이미지의 가장 높은 해상도 버전입니다. 이 이미지 크기는 일부 동영상 및 동영상을 참조하는 다른 리소스(예: 재생목록 항목 또는 검색결과)에서 사용할 수 있습니다. 이미지 너비 1280px, 높이 720px입니다. |
maxres.url |
string 이미지의 URL입니다. |
maxres.width |
unsigned integer 이미지의 너비입니다. |
maxres.height |
unsigned integer 이미지의 높이입니다. |