soporte Contactar con asistencia técnica | estado del sistema Estado del Sistema

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 -sólo- videos con "bird"en los campos enumerados anteriormente)
  • +tags:bird (devoluciones -sólo- 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 24 jun 2020