CMS API: Recherche de playlists

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 of news 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 n'est 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 OREd.

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 n'est 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