Thumbnails

thumbnail 리소스는 리소스와 연결된 다양한 썸네일 이미지 크기를 식별합니다. 미리보기 이미지의 특징은 다음과 같습니다.

• 리소스의 snippet.thumbnails 속성은 해당 리소스에 사용할 수 있는 썸네일 이미지를 식별하는 객체입니다.
• thumbnail 리소스에는 일련의 객체가 포함되어 있습니다. 각 객체 (default, medium, high 등)의 이름은 썸네일 이미지 크기를 나타냅니다.
• 다양한 유형의 리소스를 통해 미리보기 이미지의 다양한 크기를 지원할 수 있습니다.
• 리소스 유형에 따라 이름이 동일한 썸네일 이미지의 크기가 다르게 정의될 수 있습니다. 예를 들어 video 리소스의 default 썸네일 이미지는 일반적으로 120px x 90px이고 channel 리소스의 default 썸네일 이미지는 일반적으로 88px x 88px입니다.
• 동일한 유형의 리소스라도 원본 이미지의 해상도 또는 YouTube에 업로드된 콘텐츠에 따라 특정 이미지의 썸네일 이미지 크기가 다를 수 있습니다. 예를 들어 HD 동영상은 HD가 아닌 동영상보다 더 높은 해상도의 미리보기를 지원할 수 있습니다.
• 썸네일 이미지 크기에 관한 정보가 포함된 각 객체에는 width 속성과 height 속성이 있습니다. 하지만 width와 height 속성은 반환되지 않을 수도 있습니다.
• 업로드된 썸네일 이미지가 필수 크기와 일치하지 않으면 가로세로 비율을 변경하지 않고 올바른 크기에 맞게 이미지 크기가 조정됩니다. 이미지가 잘리지는 않으나 올바른 크기로 맞추기 위해 이미지에 검은색 띠가 포함될 수 있습니다.

메서드

API는 thumbnails 리소스에 대해 다음 메서드를 지원합니다.

set

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
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.