Return to Video

YouTube API: 검색 기능 설명

  • 0:00 - 0:09
    안녕하세요 Jeff Fisher입니다. YouTube API 를 사용한
    동영상 검색법에 대해 말씀드리겠습니다.
  • 0:09 - 0:13
    YouTube에하는 일반적인 작업은
    동영상을 검색하는 것입니다.
  • 0:13 - 0:16
    동영상 피드를 사용하여 API로 비디오를 검색합니다.
  • 0:16 - 0:20
    "q" 파라미터를 사용하여 검색어를 명시합니다.
  • 0:20 - 0:25
    좀 더 복잡한 검색어는 URL escape 처리로
    명시할 수 있습니다.
  • 0:25 - 0:28
    API에는 다양한 버전에 있는데,
  • 0:28 - 0:34
    "v" 파라미터나 특수 헤더로
    버전을 명시할 수 있습니다.
  • 0:34 - 0:39
    YouTube에는 "cute puppy" 동영상이 많기 때문에
    모든 검색 결과를 한꺼번에 처리하고 싶지 않으시죠.
  • 0:39 - 0:45
    "max-results" 파라미터로
    갯수를 명시할 수 있습니다.
  • 0:45 - 0:49
    한번에 10개를 원하면서 10 페이지까지 원할수도 있죠.
  • 0:49 - 0:54
    rel="next"로 세팅된 link 엘리먼트에
    API로 리턴된 피드를 볼 수 있습니다.
  • 0:54 - 0:58
    이는 다음 결과 페이지에 대해서 알려주며
    피드를 통해서 페이징 하는 올바른 방법입니다.
  • 0:58 - 1:04
    "next"링크를 보면, "start-index" 파라미터가 있는데,
    이것은 다음 페이지의 시작을 알려줍니다.
  • 1:04 - 1:11
    하지만 이 파라미터를 매뉴얼하게 세팅해서는 안되며
    대신 피드로부터 "next"값을 extract하도록 합니다.
  • 1:11 - 1:16
    YouTube API를 사용할 수 있는
    다른 쿼리 파라미터들에 대해서 알아보겠습니다.
  • 1:16 - 1:22
    첫째, "orderby"에 대해서 알아보겠습니다.
    디폴트로 결과는 관련 순서로 리턴이 됩니다.
  • 1:22 - 1:29
    하지만 주회수, 평가점수, 게시일 등의 순서로
    리턴되게 할 수도 있습니다.
  • 1:29 - 1:34
    "author" 파라미터로 특정 YouTube 사용자가 게시한
    모든 동영상을 검색할 수도 있습니다.
  • 1:34 - 1:38
    업로드 피드를 받는 것과 동일한 작업입니다.
  • 1:38 - 1:42
    API 버전 2 에서는 위치기반 검색을 추가했습니다.
  • 1:42 - 1:49
    위도와 경도 정보를 입력하여
    해당 위치 근방에서 발생한 동영상을 찾을 수 있죠.
  • 1:49 - 1:53
    다수의 동영상이 '런던'과 같은
    위치 설명만을 가지고 있기 때문에
  • 1:53 - 1:59
    분명한 위도, 경도 정보를 가진 동영상이
    리턴되기를 원한다면
  • 1:59 - 2:03
    감탄부호(!)를 쿼리에 추가하세요.
  • 2:03 - 2:10
    임베디드 가능한 동영상만을 보려면
    "format" 파라미터를 사용합니다.
  • 2:10 - 2:14
    특정 언어로 된 결과만을 원한다면
    language restrict를 사용할 수 있습니다.
  • 2:14 - 2:22
    참고로 이는 단지 동영상 메타데이타이며
    오디오 트랙 언어는 아닙니다.
  • 2:22 - 2:25
    safeSearch 값도 명시할 수 있는데,
    디폴트는 보통값 "moderate"입니다.
  • 2:25 - 2:32
    하지만 제한된 컨텐츠를 필터링하기 위해
    "strict" 또는 "none"을 설정할 수도 있습니다.
  • 2:32 - 2:34
    어떤 동영상은 특정 지역에서 재생되지 않습니다.
  • 2:34 - 2:39
    국가 코드나 IP 주소를 넘겨줘서
    사용자의 지역을 명시할 수 있습니다.
  • 2:39 - 2:41
    IP 주소를 넘기는 경우 국가 코드를 확인할 수 있습니다.
  • 2:41 - 2:46
    이는 재생할 수 없는 동영상을 걸러내어 사용자 경험을
    개선하기 위한 것일 뿐임을 참고하세요.
  • 2:46 - 2:52
    이 파라미터를 사용한다고 해서
    재생할 수 있는 동영상에 영향을 주지 않습니다.
  • 2:52 - 2:57
    YouTube에는 Comedy, News, Politics 등
    다양한 동영상 카테고리가 있습니다.
  • 2:57 - 3:04
    Comedy 카테고리 안에 있는 동영상만을 원한다면
    "category" 파라미터를 사용하시면 됩니다.
  • 3:04 - 3:09
    다른 Google Data API에 익숙하다면
    아래와 같은 구문을 사용할 수 있습니다.
  • 3:09 - 3:18
    "puppy"라는 태그를 가지고 있는 모든 동영상 검색과 같이
    태그 검색을 하고 싶으시면 동일한 메카니즘을 이용하세요.
  • 3:18 - 3:24
    동영상 카테고리는 대문자로 시작합니다.
    반면 태그는 소문자로 시작하구요.
  • 3:24 - 3:28
    다시 말하면 위의 검색은 Comedy 카테고리에 있는
    모든 동영상 검색이고
  • 3:28 - 3:33
    아래는 "comedy"라는
    태그를 가지고 있는 동영상 검색입니다.
  • 3:33 - 3:37
    우리가 다루었던 다른 쿼리 파라미터들을
    조합해서 사용할 수도 있습니다.
  • 3:37 - 3:42
    예를 들어, 외부 웹페이지에 임베디드 가능한
    Comedy 카테고리에 있는
  • 3:42 - 3:48
    고양이(kitten) 동영상을 검색하고자 한다면
    이 쿼리를 사용할 수 있습니다.
  • 3:48 - 3:52
    YouTube는 또한 인기있는 동영상 리스트를 제공합니다.
  • 3:52 - 3:55
    스탠다드 피드(standard feeds)로 알려져 있는데,
  • 3:55 - 4:02
    최상위 평가 점수, 최다 조회수,
    최다 댓글수 등이 있습니다.
  • 4:02 - 4:06
    최상위 평가 점수 동영상 중에서 "time" 파라미터를 사용하여
    금주에 게시된 동영상을 검색할 수도 있습니다.
  • 4:06 - 4:14
    최상위 평가 점수 동영상 중에서
    이번 달이나 오늘 게시된 동영상도 볼 수 있습니다.
  • 4:14 - 4:21
    최상위 평가 점수를 받은 동영상 중에서 Comedy와 같이
    특정 카테고리 안에 있는 동영상을 볼 수도 있습니다.
  • 4:21 - 4:25
    앞서 다뤘던 "category" 파라미터 사용과는
    차이가 있음을 주의하세요,
  • 4:25 - 4:30
    상단의 피드는 Comedy 카테고리 내에 있는
    평가 상위 100개 동영상입니다.
  • 4:30 - 4:39
    반면 하단은 YouTube에 있는 평가 상위 100개 동영상 중에서 Comedy 카테고리에 속한 것들 입니다.
  • 4:39 - 4:48
    일본에서 평가 상위에 있는 Comedy 동영상과 같이
    지역에 따라 다른 스탠다드 피드를 볼 수도 있습니다.
  • 4:48 - 4:51
    YouTube API 사용에 많은 흥미를 가지시길 기대합니다.
  • 4:51 - 4:57
    하지만 시작에 앞서,
    몇 가지 주의 사항을 말씀드리겠습니다.
  • 4:57 - 5:04
    비디오 검색 피드에서 1000개 이상을 검색할 수 없습니다.
    YouTube.com에서와 마찬가지죠.
  • 5:04 - 5:07
    openSearch totalResults 값은 근사치입니다.
  • 5:07 - 5:14
    그래서 페이지 번호를 매뉴얼하게 매겨선 안됩니다.
    대신 "next" 링크를 사용하시면 됩니다.
  • 5:14 - 5:18
    앞서 cute puppy 동영상을 검색했던
    예제로 돌아가봅시다.
  • 5:18 - 5:23
    YouTube는 거대한 동영상 웹사이트이기 때문에
    검색 정보는 캐시에 저장된 정보일 수 있습니다.
  • 5:23 - 5:28
    이는 가장 최근 업로드된 cute puppy 동영상은
    검색 결과에 표시되지 않을 수도 있다는 뜻이죠.
  • 5:28 - 5:32
    이는 또한 동영상 제목과 설명과 같은 정보가
  • 5:32 - 5:36
    검색 목록에 업데이트되기까지
    한두 시간 소요될 수도 있다는 뜻입니다.
  • 5:36 - 5:43
    또한 조회수나 선호도 등의 해당 동영상의 통계가
    최신 정보가 아닐 수도 있습니다.
  • 5:43 - 5:50
    또한 private 에서 public으로 공개 여부가 바뀐 경우
    검색 목록에 들어가는데 더 오랜 시간이 걸릴 수도 있습니다.
  • 5:50 - 5:55
    정보를 받고자 하는 동영상의 ID를 알고 있는 경우라면
  • 5:55 - 6:01
    YouTube에서 동영상을 검색하는것과 유사하게
    이것도 캐시에 저장된 정보일 것입니다.
  • 6:01 - 6:08
    또한 사용자로서 승인되지 않았을 때 업로드 피드를 통해서
    정보를 받으려고 하는 경우에도 마찬가지입니다.
  • 6:08 - 6:16
    하지만 승인된 경우라면 캐시로 저장되지 않은
    정보를 받을 것이고 이 정보는 최신입니다.
  • 6:16 - 6:20
    또한 사용자로서 승인을 받은 상태로
    업로드 피드를 받는 다면
  • 6:20 - 6:25
    캐시로 저장되지 않은 정보를 받게 될 것입니다.
  • 6:25 - 6:31
    이는 YouTube가 가지고 있는 최신 정보를 받는 다는 뜻이죠.
    그 정보는 게시 시간 순서에 따라 정렬될 것입니다.
  • 6:31 - 6:35
    하지만 해당 피드에 "orderby"와 같은
    쿼리 파라미터를 추가하면
  • 6:35 - 6:41
    인증이 되었다 하더라도, 결과는 캐시로 저장이 됩니다.
  • 6:41 - 6:46
    캐싱 프로세스에 영향을 주지 않는 쿼리 파라미터는
    start-index와 max-results 입니다.
  • 6:46 - 6:50
    따라서 피드를 통해서 페이지 처리를 할 수 있는 것이죠.
  • 6:50 - 6:53
    저희가 제공하는 클라이언트 라이브러리를
    사용하고 계시다면
  • 6:53 - 6:57
    YouTube의 검색 쿼리를 만드는 데 도움이 되는
    오브젝트와 메소드가 있습니다.
  • 6:57 - 7:01
    자세한 내용은 클라이언트 라이브러리용 문서를 확인하세요.
  • 7:01 - 7:07
    이 동영상에서 다룬 모든 정보는 code.google.com에 있는 문서에서 확인하실 수 있습니다.
  • 7:07 -
    감사합니다.
Title:
YouTube API: 검색 기능 설명
Description:

Jeff Fisher가 API를 사용하여 YouTube 검색에 이용할 수 있는 다양한 파라미터와 필터에 대해 개괄적으로 설명합니다.

관련 문서는 http://code.google.com/apis/youtube 에서 확인하세요.
more » « less
Video Language:
English
Duration:
07:09

Korean subtitles

Revisions

Our website uses cookies for analysis purposes.