Compartir a través de


Video Indexer (V2)

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
Copilot Studio Estándar Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
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)
Power Apps Estándar Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Estándar Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Microsoft
URL Compatibilidad con Microsoft LogicApps
Soporte técnico de Microsoft Power Automate
Soporte técnico de Microsoft Power Apps
Metadatos del conector
Publicador Microsoft
Sitio web https://vi.microsoft.com

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 No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description 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 100 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.

Actualizar transcripción de vídeo

Actualiza la transcripción del vídeo.

Buscar vídeos

Esta operación realiza una búsqueda de texto, palabras clave y contenido visual.

Carga de vídeo e índice

Esta operación carga el vídeo dado, inicia la indexación y devuelve un nuevo identificador de índice de vídeo. Los formatos admitidos se enumeran aquí: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).

Eliminar archivo de origen de vídeo

Esta operación elimina el archivo de origen de vídeo, pero no elimina la información encontrada cuando se indizó el vídeo.

Eliminar vídeo

Esta operación elimina el vídeo especificado y todas las conclusiones relacionadas encontradas cuando se indizó el vídeo.

Enumerar vídeos

Esta operación obtiene una lista de todos los vídeos de la cuenta.

Obtención del identificador de vídeo por id. externo

Esta operación recupera el identificador de vídeo correspondiente al identificador externo.

Obtención del token de acceso de la cuenta

Obtiene un token de acceso de cuenta (expira después de una hora).

Obtener cuenta

Esta operación devuelve los detalles de la cuenta del usuario.

Obtener cuentas

Esta operación devuelve los detalles de las cuentas del usuario.

Obtener miniatura de vídeo

Obtener una imagen en miniatura de un vídeo.

Obtener subtítulos de vídeo

Esta operación devuelve los subtítulos extraídos cuando se indizó el vídeo.

Obtener índice de vídeo

Esta operación obtiene un vídeo y sus conclusiones.

Volver a indexar vídeo

Esta operación vuelve a indexar el vídeo especificado.

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
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Face ID
faceId True integer

Identificador de la cara.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de escritura.

Nuevo nombre de cara
newName True string

Nuevo nombre para la cara.

Actualizar transcripción de vídeo

Actualiza la transcripción del vídeo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Idioma de subtítulos
language True string

Idioma de los subtítulos.

Transcripción
content True string

Transcripción que se va a actualizar.

Dirección URL de devolución de llamadas
callbackUrl string

Dirección URL que se va a notificar cuando se completa la indexación. Debe ser una dirección URL POST y Video Indexer agregará 2 parámetros de cadena de consulta adicionales: id. y estado.

Establecer como idioma de origen
setAsSourceLanguage boolean

Determina si el parámetro de idioma debe establecerse como idioma de origen.

Enviar correo electrónico correcto
sendSuccessEmail boolean

Determina si se debe enviar un correo electrónico correcto tras la finalización.

Buscar vídeos

Esta operación realiza una búsqueda de texto, palabras clave y contenido visual.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Texto de consulta
query string

Texto libre para buscar.

Ámbito de texto
textScope string

Ámbito de texto en el que se va a buscar.

Privacidad
privacy string

Privacidad del vídeo.

Id. de vídeo
id string

Identificador de vídeo que se va a buscar.

Partición
partition string

Partición por la que buscar vídeos.

Propietario
owner string

Propietario de vídeo que se va a buscar.

Nombre de la cara
face string

Busque personas o celebridades.

External ID
externalId string

Un identificador externo (asociado al vídeo en la carga).

Tamaño de página
pageSize integer

Número de resultados que se van a devolver.

Omitir
skip integer

Número de resultados que se omitirán (se usan para la paginación).

Lengua origen
sourceLanguage string

Incluya solo vídeos con el idioma de origen especificado. Puede especificar varios parámetros de idioma (por ejemplo, $language=inglés&idioma=francés) para buscar varios idiomas. Si deja este parámetro en blanco, se buscarán todos los idiomas.

Language
language string

Idioma de búsqueda. Puede especificar varios parámetros de idioma (por ejemplo, $language=inglés&idioma=francés) para buscar varios idiomas. Si deja este parámetro en blanco, se buscarán todos los idiomas.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Devoluciones

Carga de vídeo e índice

Esta operación carga el vídeo dado, inicia la indexación y devuelve un nuevo identificador de índice de vídeo. Los formatos admitidos se enumeran aquí: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de escritura.

Nombre del vídeo
name True string

Título del vídeo.

Description
description string

Descripción del vídeo.

Partición
partition string

Partición por la que buscar vídeos.

External ID
externalId string

Un identificador externo (asociado al vídeo en la carga).

Dirección URL de devolución de llamadas
callbackUrl string

Dirección URL que se va a notificar cuando se completa la indexación. Debe ser una dirección URL POST y Video Indexer agregará 2 parámetros de cadena de consulta adicionales: id. y estado.

Metadatos
metadata string

Metadatos que se van a asociar al vídeo (se devolverán en consultas).

Idioma de vídeo
language string

El lenguaje de vídeo, que se usa al generar la transcripción.

Dirección URL del vídeo
videoUrl string

Dirección URL pública del archivo de vídeo/audio (dirección URL codificada). Si no se especifica, el archivo debe pasarse como contenido de cuerpo de varias partes o formularios.

Nombre de archivo
fileName string

Nombre de archivo cargado.

Valor preestablecido de indexación
indexingPreset string

Valor preestablecido de indexación que se va a usar.

Valor preestablecido de streaming
streamingPreset string

Valor preestablecido de streaming que se va a usar.

Id. de modelo lingüístico
linguisticModelId string

Identificador de modelo lingüístico tal y como recibe la llamada a "crear modelo lingüístico".

Privacidad
privacy string

Privacidad del vídeo.

Dirección URL externa
externalUrl string

Dirección URL externa que se va a asociar al vídeo (se puede buscar más adelante).

Body
body file

Si no se especifica una dirección URL de vídeo, el archivo debe pasarse como contenido del cuerpo de varias partes o formularios.

Identificador de activo
assetId string

Identificador de recurso de Azure Media Services. Se usa para indexar los recursos existentes en la cuenta de Azure Media Services conectada. (Solo pagado).

Priority
priority string

Prioridad de índice (baja, normal y alta). Solo se puede usar en regiones de pago.

Categorías de marcas
brandsCategories string

Lista de categorías de marcas delimitadas por coma. Video indexer solo tomará estas categorías en para tener en cuenta al indexar. Si no se especifican todas las marcas se usarán.

Devoluciones

Eliminar archivo de origen de vídeo

Esta operación elimina el archivo de origen de vídeo, pero no elimina la información encontrada cuando se indizó el vídeo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de escritura.

Eliminar vídeo

Esta operación elimina el vídeo especificado y todas las conclusiones relacionadas encontradas cuando se indizó el vídeo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de escritura.

Enumerar vídeos

Esta operación obtiene una lista de todos los vídeos de la cuenta.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Tamaño de página
pageSize integer

Número de resultados que se van a devolver.

Omitir
skip integer

Número de páginas que se van a omitir.

Devoluciones

Obtención del identificador de vídeo por id. externo

Esta operación recupera el identificador de vídeo correspondiente al identificador externo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

External ID
externalId True string

Identificador externo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Devoluciones

Id. de vídeo.

Id. de vídeo
string

Obtención del token de acceso de la cuenta

Obtiene un token de acceso de cuenta (expira después de una hora).

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Permitir edición
allowEdit True boolean

Determina si el token tiene permisos de escritura.

Devoluciones

Token de acceso.

response
tokenResponse

Obtener cuenta

Esta operación devuelve los detalles de la cuenta del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Devoluciones

Obtener cuentas

Esta operación devuelve los detalles de las cuentas del usuario.

Devoluciones

Obtener miniatura de vídeo

Obtener una imagen en miniatura de un vídeo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Id. de miniatura
thumbnailId True uuid

Id. de miniatura.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Devoluciones

Obtener subtítulos de vídeo

Esta operación devuelve los subtítulos extraídos cuando se indizó el vídeo.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Formato
format True string

Formato de subtítulos (por ejemplo, vtt).

Idioma de subtítulos
language string

Idioma de los subtítulos.

Devoluciones

Lista de subtítulos extraídos.

Lista de subtítulos extraídos
string

Obtener índice de vídeo

Esta operación obtiene un vídeo y sus conclusiones.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de lectura.

Idioma de subtítulos
language string

Idioma de los subtítulos.

Devoluciones

Volver a indexar vídeo

Esta operación vuelve a indexar el vídeo especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Ubicación
location True string

Indica la región de Azure a la que se debe enrutar la llamada.

Id. de cuenta
accountId True uuid

El identificador de cuenta es un identificador único global (GUID) de la cuenta.

Id. de vídeo
videoId True string

Id. de vídeo.

Token de acceso
accessToken True string

Un token de acceso de cuenta con permisos de escritura.

Valor preestablecido de indexación
indexingPreset string

Valor preestablecido de indexación que se va a usar.

Valor preestablecido de streaming
streamingPreset string

Valor preestablecido de streaming que se va a usar.

Dirección URL de devolución de llamadas
callbackUrl string

Dirección URL que se va a notificar cuando se completa la indexación. Debe ser una dirección URL POST y Video Indexer agregará 2 parámetros de cadena de consulta adicionales: id. y estado.

Priority
priority string

Prioridad de índice (baja, normal y alta). Solo se puede usar en regiones de pago.

Categorías de marcas
brandsCategories string

Lista de categorías de marcas delimitadas por coma. Video indexer solo tomará estas categorías en para tener en cuenta al indexar. Si no se especifican todas las marcas se usarán.

Lengua origen
sourceLanguage string

Idioma que se va a establecer como el idioma de origen del vídeo, que se usará al generar la transcripción.

Definiciones

tokenResponse

Token de acceso.

Token de acceso.

Token de acceso
string

Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2

Nombre Ruta de acceso Tipo Description
Results
results array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

Resultados de la búsqueda.

nextPage
nextPage Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

UploadResponse

Nombre Ruta de acceso Tipo Description
Id. de vídeo
id string

Id. de vídeo.

Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

Nombre Ruta de acceso Tipo Description
Id. de cuenta
accountId uuid

Identificador de cuenta.

Id. de vídeo
id string

Id. de vídeo.

Partición
partition string

Partición del vídeo.

External ID
externalId string

Identificador externo asociado al vídeo.

Metadatos
metadata string

Metadatos.

Nombre
name string

Nombre del vídeo.

Description
description string

Descripción del vídeo.

Creado
created date-time

Cuando se creó el vídeo.

Última modificación
lastModified date-time

Cuando se modificó por última vez el vídeo.

Última indexación
lastIndexed date-time

Cuando el vídeo se indizó por última vez.

Privacidad
privacyMode string

Modo de privacidad del vídeo (público o privado).

Nombre de usuario
userName string

Nombre de usuario del propietario del vídeo.

Es propiedad
isOwned boolean

Indica si el vídeo es propiedad del usuario que realizó la llamada.

Is Base
isBase boolean

Indica si el vídeo es un vídeo base.

Estado
state string

Estado de procesamiento del vídeo. (Cargado/ Procesamiento/ Procesado/ Erróneo/En cuarentena).

Progreso del procesamiento
processingProgress string

Porcentaje de progreso del vídeo, si se está procesando.

Duración en segundos
durationInSeconds integer

Duración del vídeo en segundos.

Id. de vídeo en miniatura
thumbnailVideoId string

Identificador del vídeo que contiene la miniatura original.

Id. de miniatura
thumbnailId uuid

Id. de miniatura.

Buscar coincidencias
searchMatches

Buscar coincidencias y sus detalles (cadena json).

Valor preestablecido de indexación
indexingPreset string

Valor preestablecido de indexación del índice de vídeo.

Valor preestablecido de streaming
streamingPreset string

Valor preestablecido de streaming del índice de vídeo.

Lengua origen
sourceLanguage string

Idioma de origen del vídeo.

Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

Nombre Ruta de acceso Tipo Description
Tamaño de página
pageSize integer

Tamaño de página de los resultados de la búsqueda.

Omitir
skip integer

Número de resultados que se omitirán (se usan para la paginación).

Done
done boolean

Indica si la búsqueda se realiza.

GetIndexResponse

Nombre Ruta de acceso Tipo Description
Id. de cuenta
accountId uuid

Identificador de cuenta.

Id. de vídeo
id string

Id. de vídeo.

Partición de vídeo
partition string

Partición del vídeo.

Nombre
name string

Nombre del vídeo.

Description
description string

Descripción del vídeo.

Nombre de usuario
userName string

Nombre de usuario del propietario del vídeo.

Creado
created date-time

Hora de creación del vídeo.

Privacidad
privacyMode string

Modo de privacidad del vídeo.

Estado
state string

Estado de procesamiento del vídeo. (Cargado/ Procesamiento/ Procesado/ Erróneo/En cuarentena).

Es propiedad
isOwned boolean

Indica si el vídeo es propiedad de un usuario.

Es editable
isEditable boolean

Si la solicitud para obtener el vídeo tenía un token con permiso de escritura.

Is Base
isBase boolean

Indica si el vídeo es un vídeo base.

Duración en segundos
durationInSeconds integer

Duración del vídeo en segundos.

Conclusiones de vídeos
videos array of object

Información de vídeos tomada del índice de vídeo (cadena json).

Intervalos de vídeo
videosRanges

Intervalos de los vídeos de este índice (cadena json).

Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim

Nombre Ruta de acceso Tipo Description
Id. de cuenta
id uuid

Id. de cuenta.

Nombre de cuenta
name string

Nombre de la cuenta.

Ubicación de la cuenta
location string

Ubicación de la cuenta.

Tipo de cuenta
accountType string

Tipo de cuenta.

Dirección URL de la cuenta
url string

Las llamadas API deben realizarse en la dirección URL de la cuenta y la ubicación de la cuenta.

Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail

Nombre Ruta de acceso Tipo Description
Tipo de contenido.
$content-type string

Tipo de contenido.

El contenido.
$content string

El contenido.

cuerda / cadena

Este es el tipo de datos básico "string".