지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    CMS API: 비디오 검색 v2

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

    서문

    에서 사용하는 비디오 검색 버전 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또는false

    위의 두 예에서 ""라는 단어가없는 동영상은bird "이 여전히 반환 될 수 있습니다. 다음 섹션에서는 지정된 용어가있는 동영상으로 만 검색 결과를 제한하는 방법을 설명합니다.

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

    검색 수정 자
    수정 자 설명 예
    + 검색 용어 앞에 더하기 (+) 기호를 붙이면 반환 된 동영상이절대로 필요한 것지정된 용어가있다
    • +bird (보고뿐 " bird "위에 나열된 필드)
    • +tags:bird (보고뿐 " bird "에서tags )
    -또는NOT 마이너스 (-) 기호를 검색어 앞에 붙이거나NOT반환 된 동영상이안돼지정된 용어가있다
    • -birds또는NOT birds (하는 비디오 만 반환아니가지고 " bird "위에 나열된 필드)
    • -name:birds또는NOT name:birds (하는 비디오 만 반환아니가지고 " bird "에서name )
    (term) AND (term)
    또는
    (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] 2019 년 9 월 30 일부터 2019 년 10 월 7 일 사이에 업데이트 된 동영상
    +created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] 2019 년 9 월 30 일에 추가 된 동영상
    +created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] 2019 년 9 월 30 일 오후 2 시부 터 오후 4시 30 분 (UTC) 사이에 추가 된 동영상
    +created_at:[* TO 2019-09-30T00:00:00.000Z] 2019 년 9 월 30 일 이전에 추가 된 동영상