soporte Contactar con asistencia técnica | estado del sistema Estado del Sistema
Contenido de la página

    CMS API: Búsqueda de video v2

    Este tema explica la sintaxis para usar la versión 2 de la búsqueda de video, compatible con CMS API.

    Introducción

    La versión 2 de la búsqueda de video utilizada por el CMS API simplifica la sintaxis y hace que sea más fácil de usar.

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

    • Para usar la nueva búsqueda v2: 
          .../videos?query={search_string}
    • Para usar 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 tener como prefijo un nombre de campo. Si se incluye el nombre del campo, solo se buscará ese campo de metadatos. De lo contrario, se buscarán varios campos (enumerados a continuación).

    Por ejemplo:

    Búsqueda básica
    Cadena de búsqueda Lo que será devuelto
    bird Videos que esa la palabra "bird"en los campos enumerados a continuación
    name:bird Videos que tienen la palabra "bird"En el name (título) será devuelto.

    Cuando no proporciona ningún 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 nombrado específico)

    Los campos admitidos para buscar son:

    Campos de búsqueda admitidos
    Campo Valores legales
    name cadenas o cadenas entre comillas
    texto cadenas o cadenas entre comillas (busca el name, description y long_description)
    tags cadenas o cadenas entre comillas (las etiquetas múltiples deben estar delimitadas por comas)
    custom_fields cadenas o cadenas entre comillas (busca en todos los campos personalizados; también puede usar un campo personalizado específico) interno nombre)
    reference_id cadena o cadena citada
    state ACTIVE, INACTIVE, PENDING, DELETED (solo se devolverán los videos eliminados en los últimos 10 días)
    updated_at fecha hora o rango (detalles abajo)
    created_at fecha hora o rango (detalles abajo)
    schedule.starts_at fecha hora o rango (detalles abajo)
    schedule.ends_at fecha hora o rango (detalles abajo)
    published_at fecha hora o rango (detalles abajo)
    complete true or false

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

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

    Modificadores de búsqueda
    cambio Descripción Ejemplos
    + Prefijar un término de búsqueda con el signo más (+) significa que los videos devueltos debe tener el término especificado
    • +bird (devoluciones -unicamente- videos con "bird"en los campos enumerados anteriormente)
    • +tags:bird (devoluciones -unicamente- videos con "bird"En el tags)
    - or NOT Prefijar un término de búsqueda con el signo menos (-) o NOT significa que los videos devueltos no debe tener el término especificado
    • -birds or NOT birds (solo devuelve videos que lo hacen no tener "bird"en los campos enumerados anteriormente)
    • -name:birds or NOT name:birds (solo devuelve videos que lo hacen no tener "bird"En el name)
    (term) AND (term)
    or
    (term) OR (term)    		 El lógico AND y OR los operadores le permiten combinar múltiples términos de búsqueda para consultas complejas
    • (+name:heron) AND (+tags:bird) (devolvería videos que tienen en "heron"En el name y "bird"En el tags)
    • (+name:heron) OR (+tags:bird) (devolvería videos que tienen ya sea "heron"En el name y "bird"En el tags)
    • ((+name:heron) AND (+tags:bird)) AND (NOT tags:internal) (devolvería videos que tienen en "heron"En el name y "bird"En el tags, pero no la etiqueta "internal")

    Búsqueda de frases

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

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

    Fecha / Horas

    Puede buscar en un intervalo de fecha y hora utilizando:

    [{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:

    Formatos de fecha / hora
    Fecha y hora Formato Ejemplo
    Fecha y hora yyyy-MM-ddThh:mm:ss.sssZ 2019-09-30T14:24:33.512Z
    Comodín (se puede usar para la fecha / hora de inicio o finalización) *
    • 2019-09-30T14:24:33.512Z TO *
    • * TO 2019-09-30T14:24:33.512-4:00Z

    A continuación se muestran algunas cadenas de búsqueda de fecha / hora de muestra.

    Datos de muestra / búsquedas de tiempo
    Cadena de búsqueda Descripción
    +updated_at:[2019-09-30T00:00:00.000Z TO 2019-10-07T00:00:00.000Z] Videos actualizados entre el 30 de septiembre de 2019 y el 7 de octubre de 2019
    +created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] Videos agregados el 30 sep 2019
    +created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] Videos agregados entre las 2:00 p.m. y las 4:30 p.m. (UTC) del 30 de septiembre de 2019
    +created_at:[* TO 2019-09-30T00:00:00.000Z] Videos agregados antes del 30 de septiembre de 2019
    Página actualizada por última vez el 15 Sep 2020