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

속성

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