Video Indexer (V2)
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 | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://vi.microsoft.com |
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 | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | 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 | 100 | 60 segundos |
Ações
| Atualizar o Nome do Rosto |
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. |
| Atualizar transcrição de vídeo |
Atualiza a transcrição do vídeo. |
| Carregar vídeo e índice |
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de índice de vídeo. Os formatos com suporte estão listados aqui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats). |
| Excluir arquivo de origem de vídeo |
Essa operação exclui o arquivo de origem do vídeo, mas não exclui os insights encontrados quando o vídeo foi indexado. |
| Excluir Vídeo |
Essa operação exclui o vídeo especificado e todos os insights relacionados encontrados quando o vídeo foi indexado. |
| Indexar novamente o vídeo |
Esta operação indexa novamente o vídeo fornecido. |
| Listar vídeos |
Esta operação obtém uma lista de todos os vídeos na conta. |
| Obter conta |
Esta operação retorna os detalhes da conta do usuário. |
| Obter contas |
Esta operação retorna os detalhes das contas do usuário. |
| Obter id de vídeo por ID externa |
Esta operação recupera a ID de vídeo correspondente à ID externa. |
| Obter legendas de vídeo |
Essa operação retorna as legendas extraídas quando o vídeo foi indexado. |
| Obter miniatura de vídeo |
Obtenha a imagem em miniatura de um vídeo. |
| Obter token de acesso à conta |
Obtém um token de acesso de conta (expira após uma hora). |
| Obter Índice de Vídeo |
Essa operação obtém um vídeo e seus insights. |
| Pesquisar vídeos |
Esta operação executa uma pesquisa por texto, palavras-chave e conteúdo visual. |
Atualizar o Nome do Rosto
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 |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
ID do rosto
|
faceId | True | integer |
A ID do rosto. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de gravação. |
|
Novo Nome de Rosto
|
newName | True | string |
Um novo nome para o rosto. |
Atualizar transcrição de vídeo
Atualiza a transcrição do vídeo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
|
Linguagem Captions
|
language | True | string |
O idioma das legendas. |
|
Transcrição
|
content | True | string |
A transcrição a ser atualizada. |
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. Deve ser uma URL POST e o Video Indexer adicionará 2 parâmetros de cadeia de caracteres de consulta adicionais a ele: ID e estado. |
|
|
Definir como idioma de origem
|
setAsSourceLanguage | boolean |
Determina se o parâmetro de idioma deve ser definido como linguagem de origem. |
|
|
Enviar email de êxito
|
sendSuccessEmail | boolean |
Determina se um email de êxito será enviado após a conclusão. |
Carregar vídeo e índice
Essa operação carrega o vídeo fornecido, começa a indexá-lo e retorna uma nova ID de índice de vídeo. Os formatos com suporte estão listados aqui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de gravação. |
|
Nome do vídeo
|
name | True | string |
O título do vídeo. |
|
Description
|
description | string |
A descrição do vídeo. |
|
|
Partição
|
partition | string |
Uma partição para pesquisar vídeos. |
|
|
ID externa
|
externalId | string |
Uma ID externa (associada ao vídeo no upload). |
|
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. Deve ser uma URL POST e o Video Indexer adicionará 2 parâmetros de cadeia de caracteres de consulta adicionais a ele: ID e estado. |
|
|
Metadados
|
metadata | string |
Metadados a serem associados ao vídeo (serão retornados em consultas). |
|
|
Linguagem de Vídeo
|
language | string |
A linguagem de vídeo, usada ao gerar a transcrição. |
|
|
URL do Vídeo
|
videoUrl | string |
Uma URL pública do arquivo de áudio/vídeo (codificado em URL). Se não for especificado, o arquivo deverá ser passado como um conteúdo do corpo de várias partes/formulários. |
|
|
Nome do Arquivo
|
fileName | string |
O nome do arquivo carregado. |
|
|
Predefinição de indexação
|
indexingPreset | string |
A predefinição de indexação a ser usada. |
|
|
Predefinição de streaming
|
streamingPreset | string |
A predefinição de streaming a ser usada. |
|
|
ID do modelo linguístico
|
linguisticModelId | string |
ID do modelo linguístico, conforme recebido pela chamada "criar modelo linguístico". |
|
|
Privacidade
|
privacy | string |
A privacidade do vídeo. |
|
|
URL Externa
|
externalUrl | string |
Uma URL externa a ser associada ao vídeo (pode ser pesquisada posteriormente). |
|
|
Corpo
|
body | file |
Se uma URL de vídeo não for especificada, o arquivo deverá ser passado como um conteúdo do corpo de várias partes/formulários. |
|
|
ID do Ativo
|
assetId | string |
ID do ativo dos serviços de mídia do Azure. Usado para indexar de ativos existentes em sua conta conectada dos serviços de mídia do Azure. (Somente pago). |
|
|
Priority
|
priority | string |
Prioridade de índice (Baixa, Normal e Alta). Pode ser usado somente em regiões pagas. |
|
|
Categorias de marcas
|
brandsCategories | string |
Lista de categorias de marcas delimitadas por vírgula. O indexador de vídeo só levará essas categorias em conta ao indexar. Se não for especificado, todas as marcas serão usadas. |
Retornos
- Corpo
- UploadResponse
Excluir arquivo de origem de vídeo
Essa operação exclui o arquivo de origem do vídeo, mas não exclui os insights encontrados quando o vídeo foi indexado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de gravação. |
Excluir Vídeo
Essa operação exclui o vídeo especificado e todos os insights relacionados encontrados quando o vídeo foi indexado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de gravação. |
Indexar novamente o vídeo
Esta operação indexa novamente o vídeo fornecido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de gravação. |
|
Predefinição de indexação
|
indexingPreset | string |
A predefinição de indexação a ser usada. |
|
|
Predefinição de streaming
|
streamingPreset | string |
A predefinição de streaming a ser usada. |
|
|
URL de retorno de chamada
|
callbackUrl | string |
Uma URL a ser notificada quando a indexação for concluída. Deve ser uma URL POST e o Video Indexer adicionará 2 parâmetros de cadeia de caracteres de consulta adicionais a ele: ID e estado. |
|
|
Priority
|
priority | string |
Prioridade de índice (Baixa, Normal e Alta). Pode ser usado somente em regiões pagas. |
|
|
Categorias de marcas
|
brandsCategories | string |
Lista de categorias de marcas delimitadas por vírgula. O indexador de vídeo só levará essas categorias em conta ao indexar. Se não for especificado, todas as marcas serão usadas. |
|
|
Idioma de origem
|
sourceLanguage | string |
O idioma a ser definido como o idioma de origem do vídeo, a ser usado ao gerar a transcrição. |
Listar vídeos
Esta operação obtém uma lista de todos os vídeos na conta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
|
Tamanho da Página
|
pageSize | integer |
O número de resultados a serem retornados. |
|
|
Ignorar
|
skip | integer |
O número de páginas a serem ignoradas. |
Retornos
Obter conta
Esta operação retorna os detalhes da conta do usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
Retornos
Obter contas
Esta operação retorna os detalhes das contas do usuário.
Retornos
Obter id de vídeo por ID externa
Esta operação recupera a ID de vídeo correspondente à ID externa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID externa
|
externalId | True | string |
A ID externa. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
Retornos
A ID do vídeo.
- ID do vídeo
- string
Obter legendas de vídeo
Essa operação retorna as legendas extraídas quando o vídeo foi indexado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
|
Formato
|
format | True | string |
O formato de legendas (por exemplo, vtt). |
|
Linguagem Captions
|
language | string |
O idioma das legendas. |
Retornos
Lista de legendas extraídas.
- Lista de legendas extraídas
- string
Obter miniatura de vídeo
Obtenha a imagem em miniatura de um vídeo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
ID da miniatura
|
thumbnailId | True | uuid |
A ID da miniatura. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
Retornos
Obter token de acesso à conta
Obtém um token de acesso de conta (expira após uma hora).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
Permitir Edição
|
allowEdit | True | boolean |
Determina se o token tem permissões de gravação. |
Retornos
O token de acesso.
- response
- tokenResponse
Obter Índice de Vídeo
Essa operação obtém um vídeo e seus insights.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
ID do vídeo
|
videoId | True | string |
A ID do vídeo. |
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
|
Linguagem Captions
|
language | string |
O idioma das legendas. |
Retornos
- Corpo
- GetIndexResponse
Pesquisar vídeos
Esta operação executa uma pesquisa por texto, palavras-chave e conteúdo visual.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
AccountID
|
accountId | True | uuid |
A ID da conta é um GUID (identificador global exclusivo) para a conta. |
|
Texto da consulta
|
query | string |
Texto gratuito a ser pesquisado. |
|
|
Escopo de Texto
|
textScope | string |
O escopo de texto no qual pesquisar. |
|
|
Privacidade
|
privacy | string |
A privacidade do vídeo. |
|
|
ID do vídeo
|
id | string |
Uma ID de vídeo a ser pesquisada. |
|
|
Partição
|
partition | string |
Uma partição para pesquisar vídeos. |
|
|
Proprietário
|
owner | string |
Um proprietário de vídeo para procurar. |
|
|
Nome da Face
|
face | string |
Procure pessoas ou celebridades. |
|
|
ID externa
|
externalId | string |
Uma ID externa (associada ao vídeo no upload). |
|
|
Tamanho da Página
|
pageSize | integer |
O número de resultados a serem retornados. |
|
|
Ignorar
|
skip | integer |
O número de resultados a serem ignoradas (usado para paginação). |
|
|
Idioma de origem
|
sourceLanguage | string |
Inclua apenas vídeos com o idioma de origem especificado. Você pode especificar vários parâmetros de idioma (por exemplo, $language=inglês&idioma=francês) para pesquisar vários idiomas. Deixar esse parâmetro em branco pesquisará todos os idiomas. |
|
|
Linguagem
|
language | string |
O idioma de pesquisa. Você pode especificar vários parâmetros de idioma (por exemplo, $language=inglês&idioma=francês) para pesquisar vários idiomas. Deixar esse parâmetro em branco pesquisará todos os idiomas. |
|
|
Token de acesso
|
accessToken | True | string |
Um token de acesso de conta com permissões de leitura. |
Retornos
Definições
tokenResponse
Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2 |
Os resultados da pesquisa. |
|
nextPage
|
nextPage | Microsoft.VideoIndexer.Common.ContractsV2.SearchPage |
UploadResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do vídeo
|
id | string |
A ID do vídeo. |
Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
AccountID
|
accountId | uuid |
A ID da conta. |
|
ID do vídeo
|
id | string |
A ID do vídeo. |
|
Partição
|
partition | string |
A partição do vídeo. |
|
ID externa
|
externalId | string |
A ID externa associada ao vídeo. |
|
Metadados
|
metadata | string |
Metadados. |
|
Nome
|
name | string |
O nome do vídeo. |
|
Description
|
description | string |
A descrição do vídeo. |
|
Criado
|
created | date-time |
Quando o vídeo foi criado. |
|
Última modificação
|
lastModified | date-time |
Quando o vídeo foi modificado pela última vez. |
|
Último Indexado
|
lastIndexed | date-time |
Quando o vídeo foi indexado pela última vez. |
|
Privacidade
|
privacyMode | string |
O modo de privacidade do vídeo (público ou privado). |
|
Nome do usuário
|
userName | string |
O nome de usuário do proprietário do vídeo. |
|
É propriedade
|
isOwned | boolean |
Indica se o vídeo pertence ao usuário que fez a chamada. |
|
É Base
|
isBase | boolean |
Indica se o vídeo é um vídeo base. |
|
Estado
|
state | string |
O estado de processamento do vídeo. (Carregado/processamento/processado/com falha/quarentena). |
|
Progresso do processamento
|
processingProgress | string |
Porcentagem de progresso do vídeo, se ele estiver sendo processado. |
|
Duração em segundos
|
durationInSeconds | integer |
A duração do vídeo em segundos. |
|
ID de vídeo em miniatura
|
thumbnailVideoId | string |
A ID do vídeo que contém a miniatura original. |
|
ID da miniatura
|
thumbnailId | uuid |
A ID da miniatura. |
|
Correspondências de pesquisa
|
searchMatches |
Pesquisar correspondências e seus detalhes (cadeia de caracteres json). |
|
|
Predefinição de indexação
|
indexingPreset | string |
A predefinição de indexação do índice de vídeo. |
|
Predefinição de streaming
|
streamingPreset | string |
A predefinição de streaming do índice de vídeo. |
|
Idioma de origem
|
sourceLanguage | string |
O idioma de origem do vídeo. |
Microsoft.VideoIndexer.Common.ContractsV2.SearchPage
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tamanho da Página
|
pageSize | integer |
Tamanho da página dos resultados da pesquisa. |
|
Ignorar
|
skip | integer |
Número de resultados a serem ignoradas (usados para paginação). |
|
Concluído
|
done | boolean |
Indica se a pesquisa foi feita. |
GetIndexResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
AccountID
|
accountId | uuid |
A ID da conta. |
|
ID do vídeo
|
id | string |
A ID do vídeo. |
|
Partição de vídeo
|
partition | string |
A partição do vídeo. |
|
Nome
|
name | string |
O nome do vídeo. |
|
Description
|
description | string |
A descrição do vídeo. |
|
Nome do usuário
|
userName | string |
O nome de usuário do proprietário do vídeo. |
|
Criado
|
created | date-time |
A hora de criação do vídeo. |
|
Privacidade
|
privacyMode | string |
O modo de privacidade do vídeo. |
|
Estado
|
state | string |
O estado de processamento do vídeo. (Carregado/processamento/processado/com falha/quarentena). |
|
É propriedade
|
isOwned | boolean |
Indica se o vídeo pertence a um usuário. |
|
É editável
|
isEditable | boolean |
Se a solicitação para obter o vídeo tinha um token com permissão de gravação. |
|
É Base
|
isBase | boolean |
Indica se o vídeo é um vídeo base. |
|
Duração em segundos
|
durationInSeconds | integer |
A duração do vídeo em segundos. |
|
Insights de Vídeos
|
videos | array of object |
Insights de vídeos extraídos do índice de vídeo (cadeia de caracteres json). |
|
Intervalos de vídeo
|
videosRanges |
Os intervalos dos vídeos neste índice (cadeia de caracteres json). |
Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
AccountID
|
id | uuid |
ID da conta. |
|
Nome da Conta
|
name | string |
O nome da conta. |
|
Local da conta
|
location | string |
Local da conta. |
|
Tipo de conta
|
accountType | string |
Tipo de conta. |
|
URL da conta
|
url | string |
As chamadas à API devem ser feitas para a URL da conta + o local da conta. |
Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
O tipo de conteúdo.
|
$content-type | string |
O tipo de conteúdo. |
|
O conteúdo.
|
$content | string |
O conteúdo. |
cadeia
Esse é o tipo de dados básico 'string'.