CMS API: Búsqueda de video v2

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.

Búsqueda Avanzada

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`

Tenga en cuenta lo requerido Z en el indicador de zona horaria. Actualmente el valor debe estar en blanco (indicando UTC como la zona horaria).

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