API CMS: Recherche de listes de lecture

Dans cette rubrique, vous apprendrez comment rechercher des listes de lecture dans votre compte Video Cloud. Le CMS API fournit un moyen programmatique de rechercher des listes de lecture dans votre bibliothèque Video Cloud. Ici, nous allons examiner la syntaxe de recherche.

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 de news 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