서문
에서 사용하는 비디오 검색 버전 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
"이 여전히 반환 될 수 있습니다. 다음 섹션에서는 지정된 용어가있는 동영상으로 만 검색 결과를 제한하는 방법을 설명합니다.
고급 검색
검색 결과를 원하는 비디오로 정확하게 제한하는 데 도움이되는 몇 가지 수정자가 있습니다.
수정 자 | 설명 | 예 |
---|---|---|
+ |
검색 용어 앞에 더하기 (+) 기호를 붙이면 반환 된 동영상이절대로 필요한 것지정된 용어가있다 |
|
- 또는NOT |
마이너스 (-) 기호를 검색어 앞에 붙이거나NOT 반환 된 동영상이안돼지정된 용어가있다 |
|
(term) AND (term) 또는 (term) OR (term) |
논리적AND 과OR 연산자를 사용하면 복잡한 쿼리에 대해 여러 검색어를 결합 할 수 있습니다. |
|
구문 검색
다음과 같이 따옴표로 묶어 단일 단어가 아닌 구를 검색 할 수 있습니다.
"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 |
와일드 카드 (시작 또는 종료 날짜 / 시간에 사용할 수 있음) | * |
|
다음은 몇 가지 샘플 날짜 / 시간 검색 문자열입니다.
검색 문자열 | 설명 |
---|---|
+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 일 이전에 추가 된 동영상 |