API de CMS: Búsqueda de vídeos v2

Introducción

Versión 2 de la búsqueda de videos utilizada por el CMS API simplifica la sintaxis y facilita su uso.

Elegir qué sintaxis usar es una simple cuestión de elegir el parámetro de URL apropiado:

• Para utilizar la nueva búsqueda v2:

      .../videos?query={search_string}

• Para utilizar la búsqueda original:

      .../videos?q={search_string}

Conceptos básicos

El elemento básico de una cadena de búsqueda es un término de búsqueda , que puede ir precedido de un nombre de campo. Si se incluye el nombre del campo, solo se buscará en ese campo de metadatos. De lo contrario, se buscarán varios campos (enumerados a continuación).

Por ejemplo:

Cuando no proporciona un nombre de campo para buscar, la solicitud buscará ese valor en los siguientes campos:

• id
• name
• description
• long_description
• text(no es un campo de metadatos real, sino un pseudo-campo que puede usar para buscar el name , description , y long_description - p.ej text:bird)
• tags
• reference_id
• custom_fields(busca todos los campos personalizados)
• custom_field_name(busca un campo personalizado con nombre específico)

Los campos admitidos para buscar son:

En los dos ejemplos que se muestran arriba, los videos que no tienen la palabra "bird " en cualquier campo relevante aún podría devolverse. La siguiente sección explica cómo limitar los resultados de la búsqueda a solo videos que tienen los términos especificados.

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.

¿Qué es la derivación?

Los campos de vídeo que admiten la derivación devuelven palabras que tienen la raíz de la palabra de búsqueda en común. Además, el stemming solo permite introducir palabras enteras, no palabras parciales:

• Ejemplo 1: Al buscar en, running se devolverán resultados que contienen: running, run, runs
• Ejemplo 2: La búsqueda en vid no devolverá resultados que contengan: video

Busque con trabajos derivados en los siguientes campos:

• custom_fields
• description
• name
• long_description
• tags
• labels
• variants

Búsqueda Avanzada

Hay algunos modificadores que le ayudan a limitar los resultados de la búsqueda exactamente a los videos que desea.

Búsqueda de frases

Puede buscar una frase (en lugar de una sola palabra) colocándola entre comillas:

• "blue heron"
• name:"blue heron"

Fecha / Horas

Puede buscar en un intervalo de fecha y hora mediante:

[{start} TO {end}]

Para buscar en una sola fecha / hora, configure el start y end al mismo valor:

[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z]

Los valores de fecha y hora se especifican utilizando el formato ISO 8601:

A continuación se muestran algunos ejemplos de cadenas de búsqueda de fecha / hora.

Problemas conocidos

• Resultados duplicados: en ciertos casos, algunos elementos de los resultados de la búsqueda pueden aparecer más de una vez.

  Solución alterna: para evitar resultados de búsqueda duplicados, utilice siempre un sort parámetro en sus solicitudes de búsqueda.