Video Indexer (versión preliminar)
Extraiga fácilmente información de sus vídeos y enriquezca rápidamente sus aplicaciones para mejorar la detección y la interacción. Use el conector de Video Indexer para convertir los vídeos en información detallada.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | Compartible |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 1200 | 60 segundos |
Acciones
| Actualizar el nombre de la cara |
Esta operación actualiza el nombre de la cara dada y entrena el modelo facial para reconocer esa cara en vídeos futuros. |
| Buscar texto o cara |
Esta operación realiza la búsqueda y devuelve los resultados. Si está disponible, devuelve las coincidencias de los filtros de búsqueda en los resultados. |
| Carga de vídeo e índice |
Esta operación carga el vídeo dado, comienza a indexarlo y devuelve un nuevo identificador de desglose. |
| Carga de vídeo e índice (mediante una dirección URL) |
Esta operación carga el vídeo dado, comienza a indexarlo y devuelve un nuevo identificador de desglose. |
| Desglose del vídeo de volver a indexar |
Esta operación vuelve a indexar el desglose especificado. |
| Desglose del vídeo para volver a indexar (mediante el identificador externo) |
Esta operación vuelve a indexar el vídeo del identificador externo especificado. |
| Eliminar vídeo y sus conclusiones |
Esta operación elimina el vídeo cargado y, si deleteInsights=true, también elimina la información generada. |
| Obtención de la dirección URL de transcripción (VTT) |
Esta operación devuelve una dirección URL a un archivo VTT con los subtítulos del desglose especificado. |
| Obtención de la dirección URL del widget de conclusiones |
Esta operación devuelve una dirección URL al widget de Cognitive Insights, incluido un token de acceso. |
| Obtención de la dirección URL del widget de información (mediante el identificador externo) |
Esta operación devuelve una dirección URL al widget de Cognitive Insights, incluido un token de acceso, en función de un identificador externo determinado. |
| Obtención de la dirección URL del widget del reproductor |
Esta operación devuelve una dirección URL al widget del reproductor, incluido un token de acceso. |
| Obtención del desglose de vídeo |
Esta operación devuelve los detalles completos del desglose especificado, incluida toda la información (transcripción, OCR, personas, etc.). |
| Obtención del estado de procesamiento |
Esta operación recupera el estado de procesamiento del identificador de desglose especificado y si el procesamiento devuelve el progreso (por ejemplo, 30%). |
| Obtener cuentas |
Devuelve los detalles de las cuentas del usuario. |
Actualizar el nombre de la cara
Esta operación actualiza el nombre de la cara dada y entrena el modelo facial para reconocer esa cara en vídeos futuros.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador de desglose de vídeo. |
|
Id. de cara
|
faceId | True | number |
Identificador de cara (del json del vídeo). |
|
Nuevo nombre
|
newName | True | string |
Nuevo nombre para la cara (use "Unknown #1/2/3..." para hacer anónimo). |
Devoluciones
- response
- object
Buscar texto o cara
Esta operación realiza la búsqueda y devuelve los resultados. Si está disponible, devuelve las coincidencias de los filtros de búsqueda en los resultados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Face Query
|
face | string |
Cara a buscar. |
|
|
Consulta de texto
|
query | string |
Texto libre para buscar. |
|
|
Buscar cuenta pública
|
searchInPublicAccount | string |
True para buscar en una cuenta pública. |
|
|
Privacidad
|
privacy | string |
Privado, organización o público. |
|
|
Ámbito de texto
|
textScope | string |
Ámbito en el que se va a buscar. |
|
|
Language
|
language | string |
Para buscar. |
|
|
Id. del vídeo
|
id | string |
Identificador de desglose de vídeo que se va a buscar. |
|
|
Partición
|
partition | string |
Partición que se va a buscar. |
|
|
Propietario
|
owner | string |
Propietario que se va a buscar. |
|
|
Tamaño de página
|
pageSize | number |
Número de resultados que se van a devolver. |
|
|
Omitir
|
skip | number |
Número de resultados que se omitirán (se usan para la paginación). |
|
|
Id. externo
|
externalId | string |
Identificador externo que se va a buscar (asociado al vídeo en la carga). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID de cuenta
|
results.accountId | string |
De la cuenta que cargó el vídeo. |
|
Id. del vídeo
|
results.id | string |
Identificador asociado al vídeo y su desglose. |
|
Partición
|
results.partition | string |
Partición del vídeo. |
|
Id. externo
|
results.externalId | string |
Identificador externo del vídeo (usuario proporcionado en la carga). |
|
Metadatos
|
results.metadata | string |
Metadatos del vídeo. |
|
Nombre
|
results.name | string |
Nombre del vídeo. |
|
Descripción
|
results.description | string |
Descripción del vídeo. |
|
Hora de creación
|
results.createTime | date-time |
Hora de creación del vídeo. |
|
Organización
|
results.organization | string |
La cuenta de la organización pertenece. |
|
Modo de privacidad
|
results.privacyMode | string |
La cuenta de la organización pertenece. |
|
Nombre de usuario
|
results.userName | string |
Nombre de usuario de la cuenta del vídeo. |
|
Es propiedad
|
results.isOwned | boolean |
True si el vídeo es propiedad de un usuario. |
|
Is Base
|
results.isBase | boolean |
True si el vídeo es un vídeo base. |
|
Estado
|
results.state | string |
Cargado, procesamiento, procesado o con errores. |
|
Progreso del procesamiento
|
results.processingProgress | string |
Porcentaje de progreso del vídeo si el estado está procesando. |
|
Duración en segundos
|
results.durationInSeconds | integer |
Duración del vídeo en segundos. |
|
Url de miniatura
|
results.thumbnailUrl | string |
Dirección URL en miniatura del vídeo. |
|
Le ha gustado por usuario
|
results.social.likedByUser | boolean |
True si el usuario ha gustado el vídeo. En caso contrario, False . |
|
Me gusta
|
results.social.likes | integer |
Número de likes del vídeo. |
|
Vistas
|
results.social.views | integer |
Número de vistas del vídeo. |
|
Buscar coincidencias
|
results.searchMatches | string |
Matriz de coincidencias con la búsqueda y los detalles de las coincidencias. |
Carga de vídeo e índice
Esta operación carga el vídeo dado, comienza a indexarlo y devuelve un nuevo identificador de desglose.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Contenido del archivo
|
fileContent | True | binary |
Vídeo en formato de varias partes. |
|
Language
|
language | string |
Idioma del vídeo que se va a usar al generar la transcripción. |
|
|
Id. externo
|
externalId | string |
Identificador externo que se va a asociar al vídeo (se puede buscar más adelante). |
|
|
Metadatos
|
metadata | string |
Metadatos que se van a asociar al vídeo (se devolverán en consultas). |
|
|
Descripción
|
description | string |
Descripción del vídeo. |
|
|
Partición
|
partition | string |
Partición para particionar vídeos por (se usa para buscar una partición específica). |
|
|
Nombre del vídeo
|
name | True | string |
Nombre del vídeo. |
|
Privacidad
|
privacy | True | string |
Privado, organización o público. |
|
Dirección URL de devolución de llamada
|
callbackUrl | string |
Dirección URL que se va a notificar cuando se completa la indexación. |
Devoluciones
Identificador asociado al vídeo y su desglose.
- response
- videoResponse
Carga de vídeo e índice (mediante una dirección URL)
Esta operación carga el vídeo dado, comienza a indexarlo y devuelve un nuevo identificador de desglose.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL del vídeo
|
videoUrl | True | string |
Dirección URL pública del vídeo. |
|
Language
|
language | string |
Idioma del vídeo que se va a usar al generar la transcripción. |
|
|
Id. externo
|
externalId | string |
Identificador externo que se va a asociar al vídeo (se puede buscar más adelante). |
|
|
Metadatos
|
metadata | string |
Metadatos que se van a asociar al vídeo (se devolverán en consultas). |
|
|
Descripción
|
description | string |
Descripción del vídeo. |
|
|
Partición
|
partition | string |
Partición para particionar vídeos por (se usa para buscar una partición específica). |
|
|
Nombre del vídeo
|
name | True | string |
Nombre del vídeo. |
|
Privacidad
|
privacy | True | string |
Privado, organización o público. |
|
Dirección URL de devolución de llamada
|
callbackUrl | string |
Dirección URL que se va a notificar cuando se completa la indexación. |
Devoluciones
Identificador asociado al vídeo y su desglose.
- response
- videoResponse
Desglose del vídeo de volver a indexar
Esta operación vuelve a indexar el desglose especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador de desglose de vídeo. |
|
Dirección URL de devolución de llamada
|
callbackUrl | string |
Dirección URL que se va a notificar cuando se completa la reindización. |
Devoluciones
- response
- object
Desglose del vídeo para volver a indexar (mediante el identificador externo)
Esta operación vuelve a indexar el vídeo del identificador externo especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. externo
|
externalId | True | string |
Identificador externo (que estaba asociado a un vídeo de esta suscripción al cargar). |
|
Dirección URL de devolución de llamada
|
callbackUrl | string |
Dirección URL que se va a notificar cuando se completa la reindización. |
Devoluciones
- response
- object
Eliminar vídeo y sus conclusiones
Esta operación elimina el vídeo cargado y, si deleteInsights=true, también elimina la información generada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador asociado al vídeo y su desglose. |
|
Eliminar conclusiones
|
deleteInsights | boolean |
Si desea eliminar también la información generada (True o False). |
Devoluciones
- response
- object
Obtención de la dirección URL de transcripción (VTT)
Esta operación devuelve una dirección URL a un archivo VTT con los subtítulos del desglose especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador asociado al vídeo y su desglose. |
|
Language
|
language | string |
Idioma solicitado del texto. |
Devoluciones
Dirección URL del archivo VTT del vídeo.
- URL
- string
Obtención de la dirección URL del widget de conclusiones
Esta operación devuelve una dirección URL al widget de Cognitive Insights, incluido un token de acceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador asociado al vídeo y su desglose. |
|
Tipo de widget
|
widgetType | string |
Personas, opiniones, palabras clave o búsqueda. |
Devoluciones
Dirección URL del widget de Cognitive Insights.
- URL
- string
Obtención de la dirección URL del widget de información (mediante el identificador externo)
Esta operación devuelve una dirección URL al widget de Cognitive Insights, incluido un token de acceso, en función de un identificador externo determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. externo
|
externalId | True | string |
Identificador externo que se va a buscar (asociado a un vídeo de esta suscripción al cargar). |
|
Tipo de widget
|
widgetType | string |
Tipo de sub widget que se va a incluir (People, Sentiments, Keywords, Search). |
Devoluciones
Dirección URL del widget de Cognitive Insights.
- URL
- string
Obtención de la dirección URL del widget del reproductor
Esta operación devuelve una dirección URL al widget del reproductor, incluido un token de acceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador de desglose de vídeo. |
Devoluciones
Dirección URL del widget del reproductor.
- URL
- string
Obtención del desglose de vídeo
Esta operación devuelve los detalles completos del desglose especificado, incluida toda la información (transcripción, OCR, personas, etc.).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador de desglose, devuelto por las API de carga o búsqueda. |
|
Language
|
language | string |
Idioma solicitado del texto. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID de cuenta
|
accountId | string |
Identificador único asociado a la cuenta. |
|
Id. del vídeo
|
id | string |
Identificador único asociado al vídeo y su desglose. |
|
Partición
|
partition | string |
Partición del vídeo. |
|
Nombre
|
name | date-time |
Nombre del vídeo. |
|
Descripción
|
description | string |
Descripción del vídeo. |
|
Nombre de usuario
|
userName | string |
Nombre de usuario de la cuenta del vídeo. |
|
Hora de creación
|
createTime | date-time |
Hora de creación del vídeo. |
|
Organización
|
organization | string |
La cuenta de la organización pertenece. |
|
Modo de privacidad
|
privacyMode | string |
Modo de privacidad del vídeo. |
|
Estado
|
state | string |
Cargado, procesamiento, procesado o con errores). |
|
Es propiedad
|
isOwned | boolean |
True si el vídeo es propiedad de un usuario. |
|
Is Base
|
isBase | boolean |
True si el vídeo es un vídeo base. |
|
Conclusiones resumidas
|
summarizedInsights | string |
Resumen de las conclusiones tomadas de los desgloses del vídeo |
|
Matriz de desgloses
|
breakdowns | string |
Matriz de los desgloses del vídeo. |
|
Le ha gustado por usuario
|
social.likedByUser | boolean |
True si un usuario ha gustado el vídeo. En caso contrario, False . |
|
Me gusta
|
social.likes | integer |
Número de likes en el vídeo. |
|
Vistas
|
social.views | integer |
Número de vistas del vídeo. |
Obtención del estado de procesamiento
Esta operación recupera el estado de procesamiento del identificador de desglose especificado y si el procesamiento devuelve el progreso (por ejemplo, 30%).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del vídeo
|
id | True | string |
Identificador asociado al vídeo y su desglose. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Estado
|
state | string |
Cargado, procesamiento, procesado o con errores. |
|
Progress
|
progress | string |
Porcentaje del vídeo si el estado está procesando. |
Obtener cuentas
Devuelve los detalles de las cuentas del usuario.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID de cuenta
|
id | string | |
|
Nombre de cuenta
|
name | string |
Definiciones
videoResponse
Identificador asociado al vídeo y su desglose.
Identificador asociado al vídeo y su desglose.
- Id. del vídeo
- string
objeto
Este es el tipo 'object'.
cuerda / cadena
Este es el tipo de datos básico "string".