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
썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 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
이미지의 높이입니다.