지원 지원 문의 | 시스템 상태 시스템 상태

CMS API: 비디오 검색 v2

이 항목에서는 비디오 검색 버전 2를 사용하는 구문에 대해 설명합니다. CMS API.

소개

에 의해 사용되는 비디오 검색 버전 2 CMS API 구문을 단순화하고 사용하기가 더 쉽습니다.

사용할 구문을 선택하는 것은 적절한 URL 매개 변수를 선택하는 간단한 문제입니다.

  • 새로운 v2 검색을 사용하려면 : 
        .../videos?query={search_string}
  • 원래 검색을 사용하려면 
        .../videos?q={search_string}

기초

검색 문자열의 기본 요소는 검색어필드 이름이 앞에 붙을 수 있습니다. 필드 이름이 포함 된 경우 해당 메타 데이터 필드 만 검색됩니다. 그렇지 않으면 아래에 나열된 여러 필드가 검색됩니다.

예 :

기본 검색
검색 문자열 반환되는 것
bird 그 단어 "bird아래에 나열된 입력란에 "
name:bird '라는 단어가있는 동영상bird" name (제목)이 반환됩니다.

검색 할 필드 이름을 제공하지 않으면 요청이 다음 필드에서 해당 값을 검색합니다.

  • id
  • name
  • description
  • long_description
  • text (실제 메타 데이터 필드는 아니지만 해당 필드를 검색하는 데 사용할 수있는 의사 필드 name, description및 long_description - 예. text:bird)
  • tags
  • reference_id
  • custom_fields (모든 사용자 정의 필드 검색)
  • custom_field_name (특정 이름이 지정된 사용자 정의 필드를 검색)

지원되는 검색 필드는 다음과 같습니다.

지원되는 검색 필드
분야 법적 가치
name 문자열 또는 따옴표 붙은 문자열
본문 문자열 또는 따옴표 붙은 문자열 ( name, description및 long_description)
tags 문자열 또는 따옴표 붙은 문자열 (여러 태그는 쉼표로 구분해야 함)
custom_fields 문자열 또는 따옴표 붙은 문자열 (모든 사용자 정의 필드 검색 - 특정 사용자 정의 필드 사용 가능 내부의 이름)
reference_id 문자열 또는 따옴표 붙은 문자열
state ACTIVE, INACTIVE, PENDING, DELETED (지난 10 일 이내에 삭제 된 비디오 만 반환됩니다)
updated_at 날짜 시간 또는 범위 (아래 세부 사항)
created_at 날짜 시간 또는 범위 (아래 세부 사항)
schedule.starts_at 날짜 시간 또는 범위 (아래 세부 사항)
schedule.ends_at 날짜 시간 또는 범위 (아래 세부 사항)
published_at 날짜 시간 또는 범위 (아래 세부 사항)
complete true or false

위에 표시된 두 예에서 모두 'bird다음 섹션에서는 검색어가 지정된 검색어 만있는 동영상으로 만 제한하는 방법에 대해 설명합니다.

검색 결과를 원하는 비디오로 정확하게 제한하는 데 도움이되는 수정자가 있습니다.

검색 수정 자
편집 설명 예
+ 더하기 (+) 기호가있는 검색어 앞에는 반환 된 동영상이 있음을 나타냅니다. 절대로 필요한 것 지정된 용어가있다
  • +bird (보고 만 "이있는 동영상bird위에 나열된 필드에서 ")
  • +tags:bird (보고 만 "이있는 동영상bird" tags)
- or NOT 빼기 (-) 기호로 검색어 앞에 접두사 또는 NOT 반환 된 비디오를 나타냅니다 하지 않아야 지정된 용어가있다
  • -birds or NOT birds (해당 동영상 만 표시 지원 "bird위에 나열된 필드에서 ")
  • -name:birds or NOT name:birds (해당 동영상 만 표시 지원 "bird" name)
(term) AND (term)
or
(term) OR (term)		 논리 AND 및 OR 연산자를 사용하면 복잡한 검색어에 대해 여러 검색어를 결합 할 수 있습니다
  • (+name:heron) AND (+tags:bird) (있는 비디오를 반환합니다 두 "heron" name 와 "bird" tags)
  • (+name:heron) OR (+tags:bird) (있는 비디오를 반환합니다 중 "heron" name 와 "bird" tags)
  • ((+name:heron) AND (+tags:bird)) AND (NOT tags:internal) (있는 비디오를 반환합니다 두 "heron" name 와 "bird" tags하지만, 지원 태그 "internal")

문구 검색

따옴표로 묶어 한 단어가 아닌 구를 검색 할 수 있습니다.

  • "blue heron"
  • name:"blue heron"

날짜 / 시간

다음을 사용하여 날짜-시간 간격으로 검색 할 수 있습니다.

[{start} TO {end}]

단일 날짜 / 시간을 검색하려면 start 및 end 같은 값으로 :

[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z]

날짜-시간 값은 ISO 8601 형식을 사용하여 지정됩니다.

날짜 / 시간 형식
날짜 시간 형성 예
날짜 시간 yyyy-MM-ddThh-mm-ss.sssZ 2019-09-30T14:24:33.512Z
와일드 카드 (시작 또는 종료 날짜 / 시간에 사용할 수 있음) *
  • 2019-09-30T14:24:33.512Z TO *
  • * TO 2019-09-30T14:24:33.512-4:00Z

다음은 샘플 날짜 / 시간 검색 문자열입니다.

샘플 데이터 / 시간 검색
검색 문자열 설명
+updated_at:[2019-09-30T00:00:00.000Z TO 2019-10-07T00:00:00.000Z] 30 년 2019 월 7 일 ~ 2019 년 XNUMX 월 XNUMX 일 사이에 업데이트 된 비디오
+created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] 30 년 2019 월 XNUMX 일에 추가 된 비디오
+created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] 2 년 00 월 4 일 오후 30 시부 터 오후 30시 2019 분 (UTC) 사이에 추가 된 비디오
+created_at:[* TO 2019-09-30T00:00:00.000Z] 30 년 2019 월 XNUMX 일 이전에 추가 된 비디오
24 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지