CMS API: 비디오 검색 v2

서문

에서 사용하는 비디오 검색 버전 2는 구문을CMS API단순화하고 더 간단하게 사용할 수 있도록 합니다.

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

• 새 v2 검색을 사용하려면:

      .../videos?query={search_string}

• 원래 검색을 사용하려면:

      .../videos?q={search_string}

기본 사항

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

예:

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

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

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

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

무시된 단어

특정 단어는 너무 일반적이어서 실제로 검색하는 것과 관련이없는 많은 결과를 반환 할 가능성이 있기 때문에 검색 문자열에서 무시됩니다. 다음은 검색에서 무시되는 단어 목록입니다.

“a”, “a”, “와”, “있다”, “로”, “에서”, “수”, “하지만”, “에”, “경우”, “에”, “이다”, “아니오”, “하지”, “의”, “on”, “또는”, “그런”, “그”, “그”, “그”, “그들의”, “그때”, “거기”, “이들”, “그들”, “이”, “에”, “이었다”, “의지”, “와”

또한 하이픈, 밑줄, 줄바꿈, "$", "& ", "*" 등은 단어 구분 기호로 취급됩니다. 예를 들어 와 같은 검색 문자열은 로small-town처리됩니다small town .

형태소 분석이란 무엇입니까?

형태소 분석이 지원되는 비디오 필드는 검색 단어의 줄기가 공통인 단어를 반환합니다. 또한 형태소 분석은 부분 단어가 아닌 전체 단어 만 입력하는 것을 지원합니다.

• 예 1: 를running검색하면 다음running내용이 포함된 결과가 반환됩니다. runruns
• 예 2: 에서vid검색해도 다음을 포함하는 결과는 반환되지 않습니다. video

형태소 분석을 사용한 검색은 다음 필드에서 작동합니다.

• custom_fields
• description
• name
• long_description
• tags
• labels
• variants

고급 검색

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

구문 검색

다음과 같이 따옴표로 묶어 단일 단어가 아닌 구를 검색 할 수 있습니다.

• "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 형식을 사용하여 지정됩니다.

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

알려진 문제

• 중복 결과:경우에 따라 검색 결과의 일부 항목이 두 번 이상 나타날 수 있습니다.

  해결 방법: 검색 결과가 중복되지 않도록하려면 항상 검색 요청에sort매개 변수를 사용하십시오.