Video Indexer (versão prévia)
Extraia facilmente insights de seus vídeos e enriqueça rapidamente seus aplicativos para aprimorar a descoberta e o engajamento. Use o conector do Video Indexer para transformar seus vídeos em insights.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral do Connectors para aplicativos de tela – Power Apps | Microsoft Docs
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 1200 | 60 segundos |
Ações
| Atualizar o nome da face |
Esta operação atualiza o nome do rosto especificado e treina o modelo de detecção facial para reconhecer esse rosto em vídeos futuros. |
| Carregar vídeo e índice |
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de divisão. |
| Carregar vídeo e índice (usando uma URL) |
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de divisão. |
| Excluir vídeo e seus insights |
Essa operação exclui o vídeo carregado e, se deleteInsights=true, também exclui os insights gerados. |
| Indexar novamente a divisão de vídeo |
Essa operação indexa novamente o detalhamento fornecido. |
| Indexar novamente a divisão de vídeo (usando a ID externa) |
Essa operação indexa novamente o vídeo da ID externa fornecida. |
| Obter a URL da transcrição (VTT) |
Essa operação retorna uma URL para um arquivo VTT com as legendas do detalhamento especificado. |
| Obter a URL do widget de insights |
Essa operação retorna uma URL para o widget de insights cognitivos, incluindo um token de acesso. |
| Obter a URL do widget de insights (usando a ID externa) |
Essa operação retorna uma URL para o widget de insights cognitivos, incluindo um token de acesso, com base em uma determinada ID externa. |
| Obter a URL do widget do player |
Essa operação retorna uma URL para o widget do player, incluindo um token de acesso. |
| Obter contas |
Retorna os detalhes das contas do usuário. |
| Obter detalhamento de vídeo |
Essa operação retorna todos os detalhes do detalhamento especificado, incluindo todos os insights (transcrição, OCR, pessoas etc. |
| Obter o estado de processamento |
Esta operação recupera o estado de processamento da ID de divisão especificada e, se o processamento retornar o progresso (por exemplo, 30%). |
| Pesquisar texto ou rosto |
Esta operação executa a pesquisa e retorna os resultados. Se disponível, retorna as correspondências dos filtros de pesquisa nos resultados. |
Atualizar o nome da face
Esta operação atualiza o nome do rosto especificado e treina o modelo de detecção facial para reconhecer esse rosto em vídeos futuros.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
A ID do detalhamento do vídeo. |
|
Identificação facial
|
faceId | True | number |
A ID do rosto (do json do vídeo). |
|
Novo Nome
|
newName | True | string |
O novo nome para o rosto (use 'Desconhecido nº 1/2/3...' para tornar anônimo). |
Retornos
- response
- object
Carregar vídeo e índice
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de divisão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo do arquivo
|
fileContent | True | binary |
O vídeo em formato de várias partes. |
|
Linguagem
|
language | string |
O idioma do vídeo, a ser usado ao gerar a transcrição. |
|
|
ID externa
|
externalId | string |
Uma ID externa a ser associada ao vídeo (pode ser pesquisada posteriormente). |
|
|
Metadados
|
metadata | string |
Metadados a serem associados ao vídeo (serão retornados em consultas). |
|
|
Descrição
|
description | string |
A descrição do vídeo. |
|
|
Partição
|
partition | string |
Uma partição para particionar vídeos (usada para pesquisar uma partição específica). |
|
|
Nome do vídeo
|
name | True | string |
O nome do vídeo. |
|
Privacidade
|
privacy | True | string |
Privado, organizacional ou público. |
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. |
Retornos
A ID associada ao vídeo e seu detalhamento.
- response
- videoResponse
Carregar vídeo e índice (usando uma URL)
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de divisão.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL de Vídeo
|
videoUrl | True | string |
Uma URL pública do vídeo. |
|
Linguagem
|
language | string |
O idioma do vídeo, a ser usado ao gerar a transcrição. |
|
|
ID externa
|
externalId | string |
Uma ID externa a ser associada ao vídeo (pode ser pesquisada posteriormente). |
|
|
Metadados
|
metadata | string |
Metadados a serem associados ao vídeo (serão retornados em consultas). |
|
|
Descrição
|
description | string |
A descrição do vídeo. |
|
|
Partição
|
partition | string |
Uma partição para particionar vídeos (usada para pesquisar uma partição específica). |
|
|
Nome do vídeo
|
name | True | string |
O nome do vídeo. |
|
Privacidade
|
privacy | True | string |
Privado, organizacional ou público. |
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. |
Retornos
A ID associada ao vídeo e seu detalhamento.
- response
- videoResponse
Excluir vídeo e seus insights
Essa operação exclui o vídeo carregado e, se deleteInsights=true, também exclui os insights gerados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
ID associada ao vídeo e seu detalhamento. |
|
Excluir Insights
|
deleteInsights | boolean |
Se deve excluir os insights gerados também (True ou False). |
Retornos
- response
- object
Indexar novamente a divisão de vídeo
Essa operação indexa novamente o detalhamento fornecido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
A ID do detalhamento do vídeo. |
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. |
Retornos
- response
- object
Indexar novamente a divisão de vídeo (usando a ID externa)
Essa operação indexa novamente o vídeo da ID externa fornecida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID externa
|
externalId | True | string |
Uma ID externa (que foi associada a um vídeo dessa assinatura no upload). |
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. |
Retornos
- response
- object
Obter a URL da transcrição (VTT)
Essa operação retorna uma URL para um arquivo VTT com as legendas do detalhamento especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
A ID associada ao vídeo e seu detalhamento. |
|
Linguagem
|
language | string |
O idioma solicitado do texto. |
Retornos
Url do arquivo VTT do vídeo.
- URL
- string
Obter a URL do widget de insights
Essa operação retorna uma URL para o widget de insights cognitivos, incluindo um token de acesso.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
A ID associada ao vídeo e seu detalhamento. |
|
Tipo de widget
|
widgetType | string |
Pessoas, sentimentos, palavras-chave ou pesquisa. |
Retornos
Url do widget de insights cognitivos.
- URL
- string
Obter a URL do widget de insights (usando a ID externa)
Essa operação retorna uma URL para o widget de insights cognitivos, incluindo um token de acesso, com base em uma determinada ID externa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID externa
|
externalId | True | string |
Uma ID externa a ser pesquisada (associada a um vídeo dessa assinatura no upload). |
|
Tipo de widget
|
widgetType | string |
Um tipo de subconjunto a ser incluído (Pessoas, Sentimentos, Palavras-chave, Pesquisa). |
Retornos
Url do widget de insights cognitivos.
- URL
- string
Obter a URL do widget do player
Essa operação retorna uma URL para o widget do player, incluindo um token de acesso.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
A ID do detalhamento do vídeo. |
Retornos
URL do widget do player.
- URL
- string
Obter contas
Retorna os detalhes das contas do usuário.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID da conta
|
id | string | |
|
Nome da Conta
|
name | string |
Obter detalhamento de vídeo
Essa operação retorna todos os detalhes do detalhamento especificado, incluindo todos os insights (transcrição, OCR, pessoas etc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
ID de detalhamento, retornada pelas APIs de upload ou pesquisa. |
|
Linguagem
|
language | string |
Idioma solicitado do texto. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conta
|
accountId | string |
ID exclusiva associada à conta. |
|
ID do vídeo
|
id | string |
ID exclusiva associada ao vídeo e seu detalhamento. |
|
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 do usuário
|
userName | string |
Nome de usuário da conta do vídeo. |
|
Tempo de Criação
|
createTime | date-time |
Hora da criação do vídeo. |
|
Organização
|
organization | string |
A conta da organização pertence. |
|
Modo de Privacidade
|
privacyMode | string |
Modo de privacidade do vídeo. |
|
State
|
state | string |
Carregado, processando, processado ou com falha). |
|
É propriedade
|
isOwned | boolean |
True se o vídeo pertence a um usuário. |
|
É Base
|
isBase | boolean |
True se o vídeo for um vídeo base. |
|
Insights resumidos
|
summarizedInsights | string |
Resumo dos insights obtidos dos detalhamentos do vídeo |
|
Matriz de detalhamentos
|
breakdowns | string |
Matriz dos detalhamentos do vídeo. |
|
Curtido pelo usuário
|
social.likedByUser | boolean |
True se o vídeo foi curtido por um usuário. Caso contrário, False. |
|
Curtidas
|
social.likes | integer |
Número de curtidas no vídeo. |
|
Visões
|
social.views | integer |
Número de exibições do vídeo. |
Obter o estado de processamento
Esta operação recupera o estado de processamento da ID de divisão especificada e, se o processamento retornar o progresso (por exemplo, 30%).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do vídeo
|
id | True | string |
ID associada ao vídeo e seu detalhamento. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
State
|
state | string |
Carregado, processando, processado ou com falha. |
|
Progress
|
progress | string |
Porcentagem do vídeo se o estado estiver sendo processado. |
Pesquisar texto ou rosto
Esta operação executa a pesquisa e retorna os resultados. Se disponível, retorna as correspondências dos filtros de pesquisa nos resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta facial
|
face | string |
Um rosto para procurar. |
|
|
Consulta de texto
|
query | string |
Texto gratuito a ser pesquisado. |
|
|
Pesquisar conta pública
|
searchInPublicAccount | string |
True para olhar em uma conta pública. |
|
|
Privacidade
|
privacy | string |
Privado, organizacional ou público. |
|
|
Escopo de Texto
|
textScope | string |
Escopo para pesquisar. |
|
|
Linguagem
|
language | string |
Para pesquisar. |
|
|
ID do vídeo
|
id | string |
ID de detalhamento de vídeo para procurar. |
|
|
Partição
|
partition | string |
Partição a ser pesquisada. |
|
|
Proprietário
|
owner | string |
Um proprietário para procurar. |
|
|
Tamanho da Página
|
pageSize | number |
Número de resultados a serem retornados. |
|
|
Ignorar
|
skip | number |
Número de resultados a serem ignoradas (usados para paginação). |
|
|
ID externa
|
externalId | string |
Uma ID externa a ser pesquisada (associada ao vídeo no upload). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resultados
|
results | array of object | |
|
ID da conta
|
results.accountId | string |
Da conta que carregou o vídeo. |
|
ID do vídeo
|
results.id | string |
ID associada ao vídeo e seu detalhamento. |
|
Partição
|
results.partition | string |
Partição do vídeo. |
|
ID externa
|
results.externalId | string |
ID externa do vídeo (usuário 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. |
|
Tempo de Criação
|
results.createTime | date-time |
Hora da criação do vídeo. |
|
Organização
|
results.organization | string |
A conta da organização pertence. |
|
Modo de Privacidade
|
results.privacyMode | string |
A conta da organização pertence. |
|
Nome de usuário
|
results.userName | string |
Nome de usuário da conta do vídeo. |
|
É propriedade
|
results.isOwned | boolean |
True se o vídeo pertence a um usuário. |
|
É Base
|
results.isBase | boolean |
True se o vídeo for um vídeo base. |
|
State
|
results.state | string |
Carregado, processando, processado ou com falha. |
|
Progresso do processamento
|
results.processingProgress | string |
Porcentagem de progresso do vídeo se o estado estiver sendo processado. |
|
Duração em segundos
|
results.durationInSeconds | integer |
Duração do vídeo em segundos. |
|
URL de Miniatura
|
results.thumbnailUrl | string |
URL em miniatura do vídeo. |
|
Curtido pelo usuário
|
results.social.likedByUser | boolean |
True se o vídeo foi curtido pelo usuário. Caso contrário, False. |
|
Curtidas
|
results.social.likes | integer |
Número de curtidas do vídeo. |
|
Visões
|
results.social.views | integer |
Número de exibições do vídeo. |
|
Correspondências de pesquisa
|
results.searchMatches | string |
Matriz de correspondências para a pesquisa e os detalhes das correspondências. |
Definições
videoResponse
A ID associada ao vídeo e seu detalhamento.
A ID associada ao vídeo e seu detalhamento.
- ID do vídeo
- string
objeto
Esse é o tipo 'object'.
cadeia
Esse é o tipo de dados básico 'string'.