Indexador de Vídeo (Pré-visualização)

Extraia facilmente informações dos seus vídeos e enriqueça rapidamente as suas aplicações para melhorar a descoberta e o envolvimento. Use o conector do Video Indexer para transformar seus vídeos em insights.

Este conector está disponível nos seguintes produtos e regiões:

Service	Classe	Regiões
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões Azure China      - Departamento de Defesa dos EUA (DoD)

Metadados do conector
Editor	Microsoft

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para mais informações, consulte a visão geral Connectors para aplicações canvas - Power Apps | Microsoft Docs

Nome	Tipo	Descrição	Obrigatório
Chave de API	securestring	A chave de API para esta api	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	1200	60 segundos

Ações

Análise de vídeo de reindexação	Esta operação reindexa a divisão dada.
Atualizar nome da face	Esta operação atualiza o nome do rosto dado e treina o modelo de rosto para reconhecer esse rosto em vídeos futuros.
Carregar vídeo e indexar (usando um URL)	Esta operação carrega o vídeo indicado, começa a indexá-lo e devolve um novo id de avaria.
Carregar vídeo e índice	Esta operação carrega o vídeo indicado, começa a indexá-lo e devolve um novo id de avaria.
Eliminar vídeo e as suas análises	Esta operação apaga o vídeo carregado e, se deleteInsights=true, apaga também os insights gerados.
Obtenha a URL da transcrição (VTT)	Esta operação devolve um url para um ficheiro VTT com as legendas do desglossamento indicado.
Obtenha a URL do widget do jogador	Esta operação devolve um URL para o widget do jogador, incluindo um token de acesso.
Obtenha o URL do widget de insights	Esta operação devolve uma URL para o widget de insights cognitivos, incluindo um token de acesso.
Obtenha o URL do widget insights (usando o ID externo)	Esta operação devolve um URL para o widget de insights cognitivos, incluindo um token de acesso, baseado num ID externo dado.
Obter contas	Devolve os dados das contas do utilizador.
Obter estado de processamento	Esta operação recupera o estado de processamento do id de quebra dado e, se for processado, devolve o progresso (por exemplo, 30%).
Pesquise texto ou rosto	Esta operação realiza a pesquisa e devolve os resultados. Se disponível, devolve as correspondências dos filtros de pesquisa nos resultados.
Reindexar a análise do vídeo (usando o id externo)	Esta operação reindexa o vídeo do id externo indicado.
Veja a análise em vídeo	Esta operação devolve todos os detalhes da divisão dada, incluindo todos os insights (transcrição, OCR, pessoas, etc).

Análise de vídeo de reindexação

ID da Operação:

Re-IndexBreakdown

Esta operação reindexa a divisão dada.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	A análise do vídeo.
URL de retorno de chamada	callbackUrl		string	Um URL para notificar quando a reindexação for concluída.

Devoluções

response

object

Atualizar nome da face

ID da Operação:

UpdateFaceName

Esta operação atualiza o nome do rosto dado e treina o modelo de rosto para reconhecer esse rosto em vídeos futuros.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	A análise do vídeo.
Identificação do rosto	faceId	True	number	O ID da face (do json do vídeo).
Novo nome	newName	True	string	O novo nome para o rosto (use 'Desconhecido #1/2/3...' para tornar anónimo).

Devoluções

response

object

Carregar vídeo e indexar (usando um URL)

ID da Operação:

UploadVideo

Esta operação carrega o vídeo indicado, começa a indexá-lo e devolve um novo id de avaria.

Parâmetros

Name	Chave	Necessário	Tipo	Description
URL do vídeo	videoUrl	True	string	Uma URL pública do vídeo.
Linguagem	language		string	A linguagem do vídeo, a ser usada na geração da transcrição.
Identificação externa	externalId		string	Um ID externo para associar ao vídeo (pode ser pesquisado mais tarde).
Metadados	metadata		string	Metadados a associar ao vídeo (serão devolvidos em consultas).
Descrição	description		string	A descrição do vídeo.
Partição	partition		string	Uma partição para particionar vídeos por (usada para pesquisar uma partição específica).
Nome do Vídeo	name	True	string	O nome do vídeo.
Privacidade	privacy	True	string	Privada, organizacional ou pública.
URL de retorno de chamada	callbackUrl		string	Uma URL para notificar quando a indexação for concluída.

Devoluções

O id associado ao vídeo e à sua análise.

response

videoResponse

Carregar vídeo e índice

ID da Operação:

UploadVideoFileContent

Esta operação carrega o vídeo indicado, começa a indexá-lo e devolve um novo id de avaria.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Conteúdo do Ficheiro	fileContent	True	binary	O vídeo em várias partes.
Linguagem	language		string	A linguagem do vídeo, a ser usada na geração da transcrição.
Identificação externa	externalId		string	Um ID externo para associar ao vídeo (pode ser pesquisado mais tarde).
Metadados	metadata		string	Metadados a associar ao vídeo (serão devolvidos em consultas).
Descrição	description		string	A descrição do vídeo.
Partição	partition		string	Uma partição para particionar vídeos por (usada para pesquisar uma partição específica).
Nome do Vídeo	name	True	string	O nome do vídeo.
Privacidade	privacy	True	string	Privada, organizacional ou pública.
URL de retorno de chamada	callbackUrl		string	Uma URL para notificar quando a indexação for concluída.

Devoluções

O id associado ao vídeo e à sua análise.

response

videoResponse

Eliminar vídeo e as suas análises

ID da Operação:

DeleteBreakdown

Esta operação apaga o vídeo carregado e, se deleteInsights=true, apaga também os insights gerados.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	Associei-me ao vídeo e à sua explicação.
Eliminar Insights	deleteInsights		boolean	Se deve eliminar também os insights gerados (Verdadeiro ou Falso).

Devoluções

response

object

Obtenha a URL da transcrição (VTT)

ID da Operação:

GetVttUrl

Esta operação devolve um url para um ficheiro VTT com as legendas do desglossamento indicado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	O id associado ao vídeo e à sua análise.
Linguagem	language		string	A língua solicitada do texto.

Devoluções

URL do ficheiro VTT do vídeo.

Endereço URL

string

Obtenha a URL do widget do jogador

ID da Operação:

GetPlayerWidgetUrl

Esta operação devolve um URL para o widget do jogador, incluindo um token de acesso.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	A análise do vídeo.

Devoluções

URL do widget do jogador.

Endereço URL

string

Obtenha o URL do widget de insights

ID da Operação:

GetInsightsWidgetUrl

Esta operação devolve uma URL para o widget de insights cognitivos, incluindo um token de acesso.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	O id associado ao vídeo e à sua análise.
Tipo de widget	widgetType		string	Pessoas, sentimentos, palavras-chave ou pesquisa.

Devoluções

URL do widget de insights cognitivos.

Endereço URL

string

Obtenha o URL do widget insights (usando o ID externo)

ID da Operação:

GetInsightsWidgetUrlByExternalId

Esta operação devolve um URL para o widget de insights cognitivos, incluindo um token de acesso, baseado num ID externo dado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Identificação externa	externalId	True	string	Um ID externo para procurar (associado a um vídeo desta subscrição no momento do upload).
Tipo de widget	widgetType		string	Um tipo de sub-widget a incluir (Pessoas, Sentimentos, Palavras-chave, Pesquisa).

Devoluções

URL do widget de insights cognitivos.

Endereço URL

string

Obter contas

ID da Operação:

GetAccounts

Devolve os dados das contas do utilizador.

Devoluções

Name	Caminho	Tipo	Description
		array of object
ID da conta	id	string
Nome da Conta	name	string

Obter estado de processamento

ID da Operação:

GetProcessingState

Esta operação recupera o estado de processamento do id de quebra dado e, se for processado, devolve o progresso (por exemplo, 30%).

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	Associei-me ao vídeo e à sua explicação.

Devoluções

Name	Caminho	Tipo	Description
Estado	state	string	Carregado, processado, processado ou falhado.
Progress	progress	string	Percentagem do vídeo se o estado estiver a processar.

Pesquise texto ou rosto

ID da Operação:

Search

Esta operação realiza a pesquisa e devolve os resultados. Se disponível, devolve as correspondências dos filtros de pesquisa nos resultados.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Face Query	face		string	Um rosto a procurar.
Consulta de Texto	query		string	Texto livre para pesquisar.
Pesquise Conta Pública	searchInPublicAccount		string	É verdade para procurar numa conta pública.
Privacidade	privacy		string	Privada, organizacional ou pública.
Âmbito do texto	textScope		string	Alcance para pesquisar.
Linguagem	language		string	Para procurar.
ID do Vídeo	id		string	ID de análise de vídeo para procurar.
Partição	partition		string	Partição para procurar.
Proprietário	owner		string	Um dono a procurar.
Tamanho da Página	pageSize		number	Número de resultados a devolver.
Pular	skip		number	Número de resultados a ignorar (utilizado para paginação).
ID externo	externalId		string	Um ID externo para procurar (associado ao vídeo no momento do upload).

Devoluções

Name	Caminho	Tipo	Description
Results	results	array of object
ID da conta	results.accountId	string	Da conta que carregou o vídeo.
ID do Vídeo	results.id	string	Associei-me ao vídeo e à sua explicação.
Partição	results.partition	string	Partição do vídeo.
Identificação externa	results.externalId	string	ID externo do vídeo (utilizador fornecido no upload).
Metadados	results.metadata	string	Metadados do vídeo.
Nome	results.name	string	Nome do vídeo.
Descrição	results.description	string	Descrição do vídeo.
Criar Tempo	results.createTime	date-time	Momento da criação do vídeo.
Organização	results.organization	string	A conta da organização pertence a.
Modo de Privacidade	results.privacyMode	string	A conta da organização pertence a.
Nome de utilizador	results.userName	string	Nome de utilizador da conta do vídeo.
é propriedade	results.isOwned	boolean	É verdade se o vídeo for propriedade de um utilizador.
É Base	results.isBase	boolean	É verdade se o vídeo for um vídeo base.
Estado	results.state	string	Carregado, processado, processado ou falhado.
Progresso do processamento	results.processingProgress	string	Percentagem de progresso do vídeo se o estado estiver a ser processado.
Duração em segundos	results.durationInSeconds	integer	Duração do vídeo em segundos.
url da miniatura	results.thumbnailUrl	string	URL da miniatura do vídeo.
Curtido pelo usuário	results.social.likedByUser	boolean	É verdade se o vídeo tiver sido apreciado pelo utilizador. Caso contrário, é falso.
Gostos	results.social.likes	integer	Número de gostos do vídeo.
Views	results.social.views	integer	Número de visualizações do vídeo.
Pesquisar correspondências	results.searchMatches	string	Variedade de correspondências para a pesquisa e detalhes das correspondências.

Reindexar a análise do vídeo (usando o id externo)

ID da Operação:

Re-IndexBreakdownByExternalId

Esta operação reindexa o vídeo do id externo indicado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Identificação externa	externalId	True	string	Um ID externo (que estava associado a um vídeo desta subscrição no momento do upload).
URL de retorno de chamada	callbackUrl		string	Um URL para notificar quando a reindexação for concluída.

Devoluções

response

object

Veja a análise em vídeo

ID da Operação:

GetBreakdown

Esta operação devolve todos os detalhes da divisão dada, incluindo todos os insights (transcrição, OCR, pessoas, etc).

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Vídeo	id	True	string	Breakdown id, devolvido pelas APIs de upload ou pesquisa.
Linguagem	language		string	Solicitou a linguagem do texto.

Devoluções

Name	Caminho	Tipo	Description
ID da conta	accountId	string	ID único associado à conta.
ID do Vídeo	id	string	Identidade única associada ao vídeo e à sua explicação.
Partição	partition	string	Partição do vídeo.
Nome	name	date-time	Nome do vídeo.
Descrição	description	string	Descrição do vídeo.
Nome de Utilizador	userName	string	Nome de utilizador da conta do vídeo.
Criar Tempo	createTime	date-time	Momento da criação do vídeo.
Organização	organization	string	A conta da organização pertence a.
Modo de Privacidade	privacyMode	string	Modo de privacidade do vídeo.
Estado	state	string	Carregado, processado, processado ou falhado).
é propriedade	isOwned	boolean	É verdade se o vídeo for propriedade de um utilizador.
É Base	isBase	boolean	É verdade se o vídeo for um vídeo base.
Insights Resumidos	summarizedInsights	string	Resumo dos insights retirados das análises do vídeo
Array de Avarias	breakdowns	string	Conjunto das análises do vídeo.
Curtido pelo usuário	social.likedByUser	boolean	É verdade se o vídeo tiver sido apreciado por um utilizador. Caso contrário, é falso.
Gostos	social.likes	integer	Número de gostos no vídeo.
Views	social.views	integer	Número de visualizações do vídeo.

Definições

vídeoResposta

O id associado ao vídeo e à sua análise.

O id associado ao vídeo e à sua análise.

ID do Vídeo

string

objecto

Este é o tipo 'objeto'.

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.