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,
    "liveBroadcastContent": string
  }
}

속성

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