Indexador de vídeo (V2)
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:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | 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) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , 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 Microsoft Power Automate Suporte Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://vi.microsoft.com |
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 | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar o nome do rosto |
Esta operação atualiza o nome do rosto dado e treina o modelo de rosto para reconhecer esse rosto em vídeos futuros. |
| Atualizar transcrição do vídeo |
Atualiza a transcrição do vídeo. |
| Carregar vídeo e índice |
Esta operação carrega o vídeo fornecido, começa a indexá-lo e retorna um novo ID de índice de vídeo. Os formatos suportados estão listados aqui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats). |
| Excluir arquivo de origem de vídeo |
Esta operação exclui o arquivo de origem do vídeo, mas não exclui as informações encontradas quando o vídeo foi indexado. |
| Excluir vídeo |
Esta operação exclui o vídeo especificado e todas as informações relacionadas encontradas quando o vídeo foi indexado. |
| 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 externo |
Esta operação recupera o ID de vídeo correspondente ao ID externo. |
| Obter legendas de vídeo |
Esta operação retorna as legendas extraídas quando o vídeo foi indexado. |
| Obter miniatura de vídeo |
Obter imagem em miniatura de um vídeo. |
| Obter token de acesso à conta |
Obtém um token de acesso à conta (expira após uma hora). |
| Obter índice de vídeo |
Esta operação recebe um vídeo e seus insights. |
| Pesquisar Vídeos |
Esta operação executa uma pesquisa de texto, palavras-chave e conteúdo visual. |
| Reindexar vídeo |
Esta operação reindexa o vídeo fornecido. |
Atualizar o nome do rosto
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 |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Identificação facial
|
faceId | True | integer |
O ID do rosto. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de gravação. |
|
Novo nome de rosto
|
newName | True | string |
Um novo nome para o rosto. |
Atualizar transcrição do vídeo
Atualiza a transcrição do vídeo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
|
Idioma das legendas
|
language | True | string |
A linguagem das legendas. |
|
Transcrever
|
content | True | string |
A transcrição a atualizar. |
|
URL de retorno de chamada
|
callbackUrl | string |
Um URL para notificar quando a indexação estiver concluída. Deve ser um URL POST e o Video Indexer adicionará 2 parâmetros adicionais de cadeia de caracteres de consulta a ele: ID e estado. |
|
|
Definir como idioma de origem
|
setAsSourceLanguage | boolean |
Determina se o parâmetro language deve ser definido como idioma de origem. |
|
|
Enviar e-mail de sucesso
|
sendSuccessEmail | boolean |
Determina se um e-mail de sucesso deve ser enviado após a conclusão. |
Carregar vídeo e índice
Esta operação carrega o vídeo fornecido, começa a indexá-lo e retorna um novo ID de índice de vídeo. Os formatos suportados estão listados aqui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à 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. |
|
|
Partition
|
partition | string |
Uma partição para pesquisar vídeos. |
|
|
ID externo
|
externalId | string |
Um ID externo (associado ao vídeo no upload). |
|
|
URL de retorno de chamada
|
callbackUrl | string |
Um URL para notificar quando a indexação estiver concluída. Deve ser um URL POST e o Video Indexer adicionará 2 parâmetros adicionais de cadeia de caracteres de consulta a ele: ID e estado. |
|
|
Metadados
|
metadata | string |
Metadados a associar ao vídeo (serão devolvidos em consultas). |
|
|
Linguagem do vídeo
|
language | string |
A linguagem do vídeo, usada ao gerar a transcrição. |
|
|
URL do Vídeo
|
videoUrl | string |
Um URL público do ficheiro de vídeo/áudio (URL codificado). Se não for especificado, o arquivo deve ser passado como um conteúdo de corpo de várias partes/formulário. |
|
|
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 recebido pelo convite à apresentação de propostas «criar modelo linguístico». |
|
|
Privacidade
|
privacy | string |
A privacidade do vídeo. |
|
|
URL externa
|
externalUrl | string |
Um URL externo para associar ao vídeo (pode ser pesquisado mais tarde). |
|
|
Body
|
body | file |
Se um URL de vídeo não for especificado, o arquivo deve ser passado como um conteúdo de corpo de várias partes/formulário. |
|
|
ID do ativo
|
assetId | string |
ID do ativo dos serviços de mídia do Azure. Usado para indexar ativos existentes em sua conta de serviços de mídia do Azure conectada. (Apenas pago). |
|
|
Priority
|
priority | string |
Prioridade do índice (Baixo, Normal e Alto). Pode ser usado apenas 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 consideração ao indexar. Se não for especificado, todas as marcas serão usadas. |
Devoluções
- Body
- UploadResponse
Excluir arquivo de origem de vídeo
Esta operação exclui o arquivo de origem do vídeo, mas não exclui as informações encontradas quando o vídeo foi indexado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de gravação. |
Excluir vídeo
Esta operação exclui o vídeo especificado e todas as informações relacionadas encontradas quando o vídeo foi indexado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de gravação. |
Listar Vídeos
Esta operação obtém uma lista de todos os vídeos na conta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
|
Tamanho da página
|
pageSize | integer |
O número de resultados a retornar. |
|
|
Pular
|
skip | integer |
O número de páginas a ignorar. |
Devoluções
Obter Conta
Esta operação retorna os detalhes da conta do usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
Devoluções
Obter contas
Esta operação retorna os detalhes das contas do usuário.
Devoluções
Obter ID de vídeo por ID externo
Esta operação recupera o ID de vídeo correspondente ao ID externo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID externo
|
externalId | True | string |
O ID externo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
Devoluções
O ID do vídeo.
- ID do vídeo
- string
Obter legendas de vídeo
Esta operação retorna as legendas extraídas quando o vídeo foi indexado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
|
Formato
|
format | True | string |
O formato das legendas (por exemplo, vtt). |
|
Idioma das legendas
|
language | string |
A linguagem das legendas. |
Devoluções
Lista de legendas extraídas.
- Lista de legendas extraídas
- string
Obter miniatura de vídeo
Obter imagem em miniatura de um vídeo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
ID da miniatura
|
thumbnailId | True | uuid |
O ID da miniatura. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
Devoluções
Obter token de acesso à conta
Obtém um token de acesso à conta (expira após uma hora).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
Permitir edição
|
allowEdit | True | boolean |
Determina se o token tem permissões de gravação. |
Devoluções
O token de acesso.
- response
- tokenResponse
Obter índice de vídeo
Esta operação recebe um vídeo e seus insights.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
|
Idioma das legendas
|
language | string |
A linguagem das legendas. |
Devoluções
- Body
- GetIndexResponse
Pesquisar Vídeos
Esta operação executa uma pesquisa de texto, palavras-chave e conteúdo visual.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
Texto da consulta
|
query | string |
Texto livre para pesquisar. |
|
|
Âmbito do texto
|
textScope | string |
O escopo do texto para pesquisar. |
|
|
Privacidade
|
privacy | string |
A privacidade do vídeo. |
|
|
ID do vídeo
|
id | string |
Um ID de vídeo para pesquisar. |
|
|
Partition
|
partition | string |
Uma partição para pesquisar vídeos. |
|
|
Proprietário
|
owner | string |
Um proprietário de vídeo para pesquisar. |
|
|
Nome do rosto
|
face | string |
Pesquise pessoas ou celebridades. |
|
|
ID externo
|
externalId | string |
Um ID externo (associado ao vídeo no upload). |
|
|
Tamanho da página
|
pageSize | integer |
O número de resultados a retornar. |
|
|
Pular
|
skip | integer |
O número de resultados a serem ignorados (usado para paginação). |
|
|
Língua de partida
|
sourceLanguage | string |
Inclua apenas vídeos com o idioma de origem especificado. Você pode especificar vários parâmetros de idioma (por exemplo, $language=English&language=French) para pesquisar vários idiomas. Deixar este parâmetro em branco pesquisará todos os idiomas. |
|
|
Linguagem
|
language | string |
A língua de pesquisa. Você pode especificar vários parâmetros de idioma (por exemplo, $language=English&language=French) para pesquisar vários idiomas. Deixar este parâmetro em branco pesquisará todos os idiomas. |
|
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à conta com permissões de leitura. |
Devoluções
Reindexar vídeo
Esta operação reindexa o vídeo fornecido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Localização
|
location | True | string |
Indica a região do Azure para a qual a chamada deve ser roteada. |
|
ID da conta
|
accountId | True | uuid |
ID da conta é um identificador global exclusivo (GUID) para a conta. |
|
ID do vídeo
|
videoId | True | string |
O ID do vídeo. |
|
Token de Acesso
|
accessToken | True | string |
Um token de acesso à 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 |
Um URL para notificar quando a indexação estiver concluída. Deve ser um URL POST e o Video Indexer adicionará 2 parâmetros adicionais de cadeia de caracteres de consulta a ele: ID e estado. |
|
|
Priority
|
priority | string |
Prioridade do índice (Baixo, Normal e Alto). Pode ser usado apenas 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 consideração ao indexar. Se não for especificado, todas as marcas serão usadas. |
|
|
Língua de partida
|
sourceLanguage | string |
O idioma a definir como o idioma de origem do vídeo, a ser usado ao gerar a transcrição. |
Definições
tokenResponse
Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2 |
Os resultados da pesquisa. |
|
próxima página
|
nextPage | Microsoft.VideoIndexer.Common.ContractsV2.SearchPage |
UploadResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do vídeo
|
id | string |
O ID do vídeo. |
Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conta
|
accountId | uuid |
O ID da conta. |
|
ID do vídeo
|
id | string |
O ID do vídeo. |
|
Partition
|
partition | string |
A partição do vídeo. |
|
ID externo
|
externalId | string |
O ID externo associado 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. |
|
Última indexação
|
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 de Utilizador
|
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 / Falhado / Em quarentena). |
|
Progresso do processamento
|
processingProgress | string |
Percentagem de progresso do vídeo, se estiver a ser processado. |
|
Duração em segundos
|
durationInSeconds | integer |
A duração do vídeo em segundos. |
|
ID do vídeo em miniatura
|
thumbnailVideoId | string |
O ID do vídeo que contém a miniatura original. |
|
ID da miniatura
|
thumbnailId | uuid |
O ID da miniatura. |
|
Pesquisar correspondências
|
searchMatches |
Pesquisar correspondências e seus detalhes (json string). |
|
|
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. |
|
Língua de partida
|
sourceLanguage | string |
A língua de partida do vídeo. |
Microsoft.VideoIndexer.Common.ContractsV2.SearchPage
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tamanho da página
|
pageSize | integer |
Tamanho da página dos resultados da pesquisa. |
|
Pular
|
skip | integer |
Número de resultados a ignorar (utilizado para paginação). |
|
Concluído
|
done | boolean |
Indica se a pesquisa foi feita. |
GetIndexResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conta
|
accountId | uuid |
O ID da conta. |
|
ID do vídeo
|
id | string |
O 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 de Utilizador
|
userName | string |
O nome de usuário do proprietário do vídeo. |
|
Criado
|
created | date-time |
O tempo 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 / Falhado / Em 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. |
|
Vídeos Insights
|
videos | array of object |
Vídeos insights retirados do índice de vídeo (json string). |
|
Intervalos de vídeo
|
videosRanges |
Os intervalos dos vídeos neste índice (json string). |
Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conta
|
id | uuid |
ID da conta. |
|
Nome da Conta
|
name | string |
O nome da conta. |
|
Localização da conta
|
location | string |
Localização da conta. |
|
Tipo de Conta
|
accountType | string |
Tipo de conta. |
|
URL da conta
|
url | string |
As chamadas de API devem ser feitas para URL da conta + localização da conta. |
Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail
| Name | 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 (de caracteres)
Este é o tipo de dados básico 'string'.