Search

검색결과에는 API 요청에 지정된 검색 매개변수와 일치하는 YouTube 동영상, 채널 또는 재생목록의 정보가 포함되어 있습니다. 검색결과는 동영상과 같이 고유하게 식별할 수 있는 리소스를 보여주지만, 자체적으로는 영구적인 데이터를 가지지 않습니다.

메소드

API는 검색에 다음 메소드를 지원합니다.

list
API 요청에 지정된 쿼리 매개변수와 일치하는 검색결과의 모음을 반환합니다. 기본적으로 검색결과의 집합은 쿼리 매개변수와 일치하는 video, channel, playlist 리소스를 식별하지만, 특정 유형의 리소스만 검색하도록 쿼리를 구성할 수도 있습니다. 지금 사용해 보세요.

리소스 표현

아래의 JSON 구조는 검색결과 형식을 보여줍니다.

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string
  }
}

속성

다음 표는 검색결과에 표시되는 속성을 정의합니다.

속성 이름
kind string
API 리소스의 유형입니다. 값은 youtube#searchResult가 됩니다.
etag etag
이 리소스의 Etag입니다.
id object
id 개체는 검색 요청에 일치하는 리소스를 고유하게 식별하는 데 사용할 수 있는 정보를 포함합니다.
id.kind string
API 리소스의 유형입니다.
id.videoId string
id.type 속성의 값이 youtube#video인 경우, 이 속성이 표시되고 속성의 값은 YouTube가 검색 쿼리에 일치하는 동영상을 고유하게 식별하는 데 사용하는 ID를 포함합니다.
id.channelId string
id.type 속성의 값이 youtube#channel인 경우, 이 속성이 표시되고 속성의 값은 YouTube가 검색 쿼리에 일치하는 채널을 고유하게 식별하는 데 사용하는 ID를 포함합니다.
id.playlistId string
id.type 속성의 값이 youtube#playlist인 경우, 이 속성이 표시되고 속성의 값은 YouTube가 검색 쿼리에 일치하는 재생목록을 고유하게 식별하는 데 사용하는 ID를 포함합니다.
snippet object
snippet 개체는 제목이나 설명 등 검색결과에 대한 기본 세부정보를 포함합니다. 예를 들어, 검색결과가 동영상인 경우 제목은 동영상의 제목이고 설명은 동영상의 설명입니다.
snippet.publishedAt datetime
검색결과가 식별하는 리소스의 작성 날짜 및 시간입니다. 값은 ISO 8601(YYYY-MM-DDThh:mm:ss.sZ) 형식으로 지정됩니다.
snippet.channelId string
YouTube가 검색결과가 식별하는 리소스를 게시한 채널을 고유하게 식별하는 데 사용하는 값입니다.
snippet.title string
검색결과의 제목입니다.
snippet.description string
검색결과의 설명입니다.
snippet.thumbnails object
검색결과에 관련된 미리보기 이미지 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
snippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
snippet.thumbnails.(key).url string
이미지의 URL입니다.
snippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
snippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.
snippet.channelTitle string
검색결과가 식별하는 리소스를 게시한 채널의 제목입니다.