Introduction
Les listes de lecture d'un compte peuvent être recherchées en fournissant un q
à 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 playlist sont recherchées, pas les propriétés des vidéos contenues dans la playlist.
Tous les termes non qualifiés/par défaut rechercheront toute correspondance de texte dans le champ name, reference_id ou id d'une liste de lecture, par exemple une recherche de ?q=news+2016
correspondrait à l'un des éléments suivants s'ils existent :
- Une liste de lecture avec le nom de
Exciting 2016 News
- Une Playlist avec un identifiant de 2016
- Une liste de lecture avec un
reference_id
denews 2016
Comme suggéré ci-dessus, plusieurs termes fournis sont OR
'ed ensemble, et les chaînes contenant un ou plusieurs des termes fournis seront renvoyées. Les valeurs fournies sont tige , de sorte que les variations sur les mots seront mises en correspondance. La correspondance de préfixe est ne pas actuellement pris en charge. Ainsi, par exemple, une recherche de p*
ne renverra pas de résultats commençant par "p" ni une 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 courants qu'ils sont susceptibles de renvoyer de nombreux résultats sans rapport avec ce que vous recherchez réellement. Vous trouverez ci-dessous une liste de mots ignorés par la recherche :
"un", "un", "et", "sont", "comme", "à", "être", "mais", "par", "pour", "si", "dans", "dans ", "est", "il", "non", "pas", "de", "sur", "ou", "tel", "que", "le", "leur", "alors", "là", "ces", "ils", "ceci", "à", "était", "sera", "avec"
En outre, les caractères non alphanumériques tels que les traits d'union, les traits de soulignement, les sauts de ligne, "$", "&", "*", etc. sont traités comme des délimiteurs de mots. Par exemple, une chaîne de recherche telle small-town
que small town
.
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 pris en charge :
- type
- nom
- description
- Pièce d'identité
Conditions requises
Vous pouvez exiger des termes en les préfixant avec un code URI +
signe (%2B) - exemple : q=name:%2Bnews+%2B2016
(qui renverrait uniquement les listes de lecture avec des noms comprenant à la fois "news" et "2016").
Termes exclus
Termes de préfixe avec un code URI -
signe pour exclure les listes de lecture avec ce terme. Par exemple: q=name:%2Bnews+%2D2016
renverra les vidéos dont le nom contient "news" mais ne pas contenant "2016".
Racisme
Stemming se réfère au stockage et à la recherche des racines des mots. Cela signifie que les termes "jouer", "jouer", "jouer", "jouer"... pour rechercher "jouer". Stem 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
renverra des vidéos avec des noms contenant "play", "played", "playing" et "playable", mais ne renverra pas de vidéos avec des noms qui contiennent "display" ou "playlist".
ET/OU
Vous pouvez combiner des 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 les termes qui précèdent les opérateurs logiques entre parenthèses comme ceci :
q=(Really Short Videos) AND type:EXPLICIT
Encodée, cette requête de recherche ressemblerait à ceci :
q=name:%28Really%20Short%20Videos%29%20type:EXPLICIT
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