API de CMS: Búsqueda de listas de reproducción

En este tema, aprenderá a buscar listas de reproducción en su cuenta de Brightcove. La CMS API proporciona una forma programática de buscar listas de reproducción en su biblioteca de Video Cloud. Aquí veremos la sintaxis de búsqueda.

Introducción

Las listas de reproducción de una cuenta se pueden buscar proporcionando un q parámetro a la llamada anterior de manera similar a la función de búsqueda de video proporcionada. Sin embargo, tenga en cuenta que se puede buscar un número mucho menor de campos y que solo se busquen las propiedades de la lista de reproducción, no las propiedades de los videos contenidos en la lista de reproducción.

Cualquier término no calificado / predeterminado buscará cualquier coincidencia de texto en el campo name, reference_id o id de una lista de reproducción, por ejemplo, una búsqueda de ?q=news+2016 coincidiría con cualquiera de los siguientes si existen:

  • Una lista de reproducción con el nombre de Exciting 2016 News
  • Una lista de reproducción con una identificación de 2016
  • Una lista de reproducción con un reference_id de news 2016

Como se implica arriba, varios términos proporcionados son OR'ed juntos, y se devolverán las cadenas que contengan uno o más de los términos proporcionados. Los valores proporcionados son derivado , por lo que se compararán las variaciones de las palabras. La coincidencia de prefijo es no actualmente soportado. Entonces, por ejemplo, una búsqueda de p* no devolverá resultados que comiencen con "p" ni tampoco una búsqueda de play* devuelve resultados que contienen "lista de reproducción".

Palabras ignoradas

Algunas palabras se ignoran en las cadenas de búsqueda porque son tan comunes que es probable que devuelvan muchos resultados que no están relacionados con lo que realmente está buscando. A continuación se muestra una lista de palabras que se ignoran en la búsqueda:

"a", "una", "y", "son", "como", "en", "ser", "pero", "por", "para", "si", "en", "en "," es "," eso "," no "," no "," de "," en "," o "," tal "," ese "," el "," su "," entonces ", "allí", "estos", "ellos", "esto", "a", "estaba", "será", "con"

Además, los caracteres no alfanuméricos como guiones, guiones bajos, saltos de línea, "$", "& ", "*", etc. se tratan como delimitadores de palabras. Por ejemplo, una cadena de búsqueda como small-town será tratado como small town.

Los campos

Los campos específicos se pueden consultar utilizando el {field:}{value} sintaxis como ?q=news+2016+type:EXPLICIT. Los campos proporcionados de esta manera deben coincidir exactamente. Como otros términos, estos serán OR'ed.

Actualmente se admiten los siguientes campos:

  • tipo
  • nombre
  • descripción
  • reference_id

Términos requeridos

Puede solicitar términos prefijándolos con un código URI + signo (% 2B) - ejemplo: q=name:%2Bnews+%2B2016 (que devolvería solo listas de reproducción con nombres que incluyan tanto "noticias" como "2016").

Términos excluidos

Prefijar términos con codificación URI - firmar para excluir las listas de reproducción con ese término. Por ejemplo: q=name:%2Bnews+%2D2016 devolverá videos que tengan nombres que contengan "noticias" pero no que contiene "2016".

Derivado

Derivado se refiere a almacenar y buscar las raíces de las palabras. Lo que esto significa es que los términos "reproducir", "reproducir", "reproducir", "reproducir"... se almacenarán como "reproducir" y cuando se realice una búsqueda de cualquiera de esos términos, la búsqueda se traducirá en consecuencia. para buscar "jugar". La raíz solo se aplica a la raíz de la palabra y no a una cadena que comienza o es parte de la palabra. Por lo tanto, una búsqueda en name:play devolverá videos con nombres que contengan "reproducir", "reproducido", "reproduciendo" y "reproducible", pero no devolverá videos con nombres que contengan "pantalla" o "lista de reproducción".

Y / O

Puede combinar las condiciones de búsqueda con AND y OR operadores logicos. Para evitar la ambigüedad (es AND ¿un operador o parte de la cadena de búsqueda?), debe poner los términos que preceden a los operadores lógicos entre paréntesis como este:

q=(Really Short Videos) AND type:EXPLICIT

Codificada, esta solicitud de búsqueda se vería así:

q=name:%28Really%20Short%20Videos%29%20type:EXPLICIT

Ejemplos completos

Buscar por tipo

    https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=type:ACTIVATED_NEWEST_TO_OLDEST

Buscar por nombre con exclusiones

    https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=%2Bname=morningnews+%2Ddecription=weekend