Thumbnails

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
썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
medium.url string
이미지의 URL입니다.
medium.width unsigned integer
이미지의 너비입니다.
medium.height unsigned integer
이미지의 높이입니다.
high object
미리보기 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
high.url string
이미지의 URL입니다.
high.width unsigned integer
이미지의 너비입니다.
high.height unsigned integer
이미지의 높이입니다.
standard object
high 해상도 이미지보다 훨씬 높은 해상도 버전의 썸네일 이미지입니다. 이 이미지는 일부 동영상 및 재생목록 항목이나 검색결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비 640픽셀, 높이 480픽셀입니다.
standard.url string
이미지의 URL입니다.
standard.width unsigned integer
이미지의 너비입니다.
standard.height unsigned integer
이미지의 높이입니다.
maxres object
썸네일 이미지의 최고 해상도 버전입니다. 이 이미지 크기는 일부 동영상 및 재생목록 항목이나 검색결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 가로 1,280픽셀, 세로 720픽셀입니다.
maxres.url string
이미지의 URL입니다.
maxres.width unsigned integer
이미지의 너비입니다.
maxres.height unsigned integer
이미지의 높이입니다.