서문
제공된 비디오 검색 기능과 유사하게 위 호출에q매개 변수를 제공하여 계정의 재생 목록을 검색할 수 있습니다. 그러나훨씬 적은 수의 필드를 검색할 수 있습니다. , 재생 목록에 포함된 비디오의 속성이 아닌 재생 목록 속성만 검색됩니다.
정규화되지 않은/기본 단어가 있으면 재생 목록의 이름, reference_id 또는 id 필드에서 일치하는 텍스트를 검색합니다. 예를 들어 검색어는 다음 항목 중 하나와 일치합니다. ?q=news+2016
- 이름이 다음과 같은 플레이리스트
Exciting 2016 News - ID가 2016 인 재생 목록
- 다음 항목이 포함된
reference_id플레이리스트news 2016
위에서OR암시한 바와 같이 제공된 여러 용어는 함께 입력되며 제공된 용어 중 하나 이상이 포함된 문자열이 반환됩니다. 제공된 값은어간으로구분되므로 단어의 변형이 일치합니다. 접두사 일치는 ~ 아니다현재 지원됩니다. 따라서 예를 들어 검색은 “p”로 시작하는 결과를p*반환하지 않으며 “playlist”를 포함하는 결과를play*반환하지 않습니다.
무시된 단어
특정 단어는 너무 일반적이어서 실제로 검색하는 것과 관련이없는 많은 결과를 반환 할 가능성이 있기 때문에 검색 문자열에서 무시됩니다. 다음은 검색에서 무시되는 단어 목록입니다.
“a”, “a”, “와”, “있다”, “로”, “에서”, “수”, “하지만”, “에”, “경우”, “에”, “이다”, “아니오”, “하지”, “의”, “on”, “또는”, “그런”, “그”, “그”, “그”, “그들의”, “그때”, “거기”, “이들”, “그들”, “이”, “에”, “이었다”, “의지”, “와”
또한 하이픈, 밑줄, 줄바꿈, "$", "& ", "*" 등은 단어 구분 기호로 취급됩니다. 예를 들어 와 같은 검색 문자열은 로small-town처리됩니다small town .
필드
등의{field:}{value}구문을 사용하여 특정 필드를 쿼리할 수?q=news+2016+type:EXPLICIT있습니다. 이 방법으로 제공된 필드는 정확히 일치해야합니다. 다른 용어와 마찬가지로 이 약관도OR 'ed'될 것입니다.
현재 지원되는 필드는 다음과 같습니다.
- 유형
- 이름
- 설명
- 참조 ID
필수 용어
용어 앞에 URI로 인코딩된+기호 (%2B) 를 붙여 용어를 요구할 수 있습니다. 예를 들면 다음과 같습니다q=name:%2Bnews+%2B2016 . 이 경우 이름에 “news”와 “2016"이 모두 포함된 재생목록만 반환됩니다.
제외 된 용어
검색어 앞에 URI 인코딩-기호를 붙이면 해당 용어가 포함된 재생목록이 제외됩니다. 예: q=name:%2Bnews+%2D2016는 이름에 “news”는 포함되지만 “2016"은포함하지 않는 동영상을 반환합니다.
형태소 분석
어간법이란 단어의 어근을 저장하고 검색하는 것을 말합니다. 이것이 의미하는 바는 "play", "playing", "plays", "played"...라는 용어가 모두 "play"로 저장되고 해당 용어에 대한 검색이 완료되면 그에 따라 검색이 번역된다는 것입니다. "놀이"를 검색합니다. 어간은 단어의 어근에만 적용되며 단어의 일부이거나 시작하는 문자열에는 적용되지 않습니다. 따라서 를name:play검색하면 이름에 '재생', '재생 중', '재생 중', '재생 가능'이 포함된 동영상이 반환되지만 이름에 '디스플레이' 또는 '재생목록'이 포함된 동영상은 반환되지 않습니다.
및 / 또는
검색 조건을AND및OR논리 연산자와 결합할 수 있습니다. 모호성을 방지하려면 ( AND연산자입니까, 검색 문자열의 일부입니까?), 다음과 같이 논리 연산자 앞에 오는 용어를 괄호 안에 넣어야 합니다.
q=(Really Short Videos) AND type:EXPLICIT인코딩 된이 검색 요청은 다음과 같습니다.
q=name:%28Really%20Short%20Videos%29%20type:EXPLICIT전체 예
유형으로 검색
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=type:ACTIVATED_NEWEST_TO_OLDEST
제외 된 이름으로 검색
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=%2Bname=morningnews+%2Ddecription=weekend