Introduction
Les playlists pour un compte peuvent être recherchées en fournissant un q
paramètre à l'appel ci-dessus de la même manière que la fonctionnalité de recherche vidéo fournie. Sachez cependant que un nombre beaucoup plus petit de champs peut être recherchéet que seules les propriétés de la liste de lecture sont recherchées, et non les propriétés des vidéos contenues dans la liste de lecture.
Tout terme non qualifié / par défaut recherchera tout texte correspondant dans le nom, le champ reference_id ou id du champ d’une playlist, par exemple une recherche de ?q=news+2016
correspondrait à l'un des éléments suivants s'ils existent:
- Une playlist avec un nom de
Exciting 2016 News
- Une playlist avec un identifiant de 2016
- Une playlist avec un
reference_id
ofnews 2016
Comme implicite ci-dessus plusieurs termes fournis sont OR
'ensemble, et les chaînes contenant un ou plusieurs des termes fournis seront retournées. Les valeurs fournies sont stemmed, donc les variations sur les mots seront appariés. La correspondance du préfixe est ne sont pas actuellement supporté. Ainsi, par exemple, une recherche de p*
ne retournera pas les résultats commençant par "p" et la recherche de play*
renvoie les résultats contenant "playlist".
Mots ignorés
Certains mots sont ignorés dans les chaînes de recherche, car ils sont si communs qu'ils sont susceptibles de renvoyer de nombreux résultats sans rapport avec ce que vous recherchez réellement. Voici une liste de mots qui sont ignorés par la recherche:
"a", "an", "and", "are", "as", "à", "être", "mais", "par", "pour", "si", "dans", "dans" "," est "," il "," non "," non "," de "," sur "," ou "," tel "," que "," le "," leur "," alors ", "là", "ces", "ils", "ceci", "à", "était", "va", "avec"
Des champs
Des champs spécifiques peuvent être interrogés en utilisant le {field:}{value}
syntaxe telle que ?q=news+2016+type:EXPLICIT
. Les champs fournis de cette manière doivent correspondre exactement. Comme d'autres termes, ceux-ci seront OR
Ed.
Les champs suivants sont actuellement supportés:
- type
- prénom
- la description
- Pièce d'identité
Termes requis
Vous pouvez exiger des termes en les préfixant avec un encodage URI +
signe (% 2B) - exemple: q=name:%2Bnews+%2B2016
(qui ne renverrait que des playlists avec des noms comprenant à la fois "news" et "2016").
Termes exclus
Termes de préfixe avec un codage URI -
signer pour exclure les playlists avec ce terme. Par exemple: q=name:%2Bnews+%2D2016
retournera les vidéos qui ont des noms contenant des "nouvelles" mais ne sont pas contenant "2016".
Stemming
Stemming se réfère à stocker et rechercher les racines des mots. Cela veut dire que les termes "jouer", "jouer", "jouer", "jouer" ... seront tous stockés comme "jeu" et quand une recherche est faite pour l'un de ces termes, la recherche sera en conséquence traduite pour rechercher "jouer". La racine ne s'applique qu'à la racine du mot et non à une chaîne qui commence ou fait partie du mot. Par conséquent, une recherche sur name:play
retournera des vidéos avec des noms contenant "play", "play", "playing" et "jouable", mais ne renverra pas de vidéos avec des noms contenant "display" ou "playlist".
ET / OU
Vous pouvez combiner les conditions de recherche avec AND
et OR
Opérateurs logiques. Pour éviter toute ambiguïté (est AND
un opérateur ou une partie de la chaîne de recherche?), vous devez mettre des termes qui précèdent les opérateurs logiques entre parenthèses comme ceci:
q=(Really Short Videos) AND type:EXPLICIT
Encodée, cette demande de recherche ressemblerait à ceci:
q=name:%28Really%20Short%20Videos%29%20type:EXPLICIT
Des exemples complets
Recherche par type
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=type:ACTIVATED_NEWEST_TO_OLDEST
Recherche par nom avec exclusions
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=%2Bname=morningnews+%2Ddecription=weekend