Video Indexer (V2)
Estrarre facilmente informazioni dettagliate dai video e arricchire rapidamente le applicazioni per migliorare l'individuazione e l'engagement. Usare il connettore Video Indexer per trasformare i video in informazioni dettagliate.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://vi.microsoft.com |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Chiave API | securestring | Chiave API per questa API | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Aggiornare il nome del viso |
Questa operazione aggiorna il nome del viso specificato ed esegue il training del modello viso per riconoscere il viso nei video futuri. |
| Aggiornare la trascrizione video |
Aggiorna la trascrizione del video. |
| Caricare video e indici |
Questa operazione carica il video specificato, avvia l'indicizzazione e restituisce un nuovo ID indice video. I formati supportati sono elencati qui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats. |
| Cerca video |
Questa operazione esegue una ricerca di testo, parole chiave e contenuto visivo. |
| Elencare video |
Questa operazione ottiene un elenco di tutti i video nell'account. |
| Elimina file di origine video |
Questa operazione elimina il file di origine video, ma non elimina le informazioni dettagliate rilevate quando il video è stato indicizzato. |
| Elimina video |
Questa operazione elimina il video specificato e tutte le informazioni dettagliate correlate trovate quando il video è stato indicizzato. |
| Ottenere account |
Questa operazione restituisce i dettagli degli account dell'utente. |
| Ottenere il token di accesso all'account |
Ottiene un token di accesso all'account (scade dopo un'ora). |
| Ottenere l'account |
Questa operazione restituisce i dettagli dell'account dell'utente. |
| Ottenere l'anteprima video |
Ottenere un'immagine di anteprima di un video. |
| Ottenere l'ID video per ID esterno |
Questa operazione recupera l'ID video corrispondente all'ID esterno. |
| Ottenere l'indice video |
Questa operazione ottiene un video e le relative informazioni dettagliate. |
| Ottenere sottotitoli video |
Questa operazione restituisce le didascalie estratte quando il video è stato indicizzato. |
| Re-index Video |
Questa operazione reindicisce il video specificato. |
Aggiornare il nome del viso
Questa operazione aggiorna il nome del viso specificato ed esegue il training del modello viso per riconoscere il viso nei video futuri.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Face ID
|
faceId | True | integer |
ID viso. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di scrittura. |
|
Nuovo nome viso
|
newName | True | string |
Nuovo nome per il viso. |
Aggiornare la trascrizione video
Aggiorna la trascrizione del video.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
|
Lingua delle didascalie
|
language | True | string |
Lingua delle didascalie. |
|
Trascrizione
|
content | True | string |
Trascrizione da aggiornare. |
|
Callback URL (URL callback)
|
callbackUrl | string |
URL da notificare al completamento dell'indicizzazione. Deve essere un URL POST e Video Indexer aggiungerà 2 parametri di stringa di query aggiuntivi: ID e stato. |
|
|
Imposta come lingua di origine
|
setAsSourceLanguage | boolean |
Determina se il parametro language deve essere impostato come lingua di origine. |
|
|
Invia messaggio di posta elettronica di operazione riuscita
|
sendSuccessEmail | boolean |
Determina se inviare un messaggio di posta elettronica di operazione riuscita al completamento. |
Caricare video e indici
Questa operazione carica il video specificato, avvia l'indicizzazione e restituisce un nuovo ID indice video. I formati supportati sono elencati qui: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di scrittura. |
|
Nome del video
|
name | True | string |
Titolo del video. |
|
Description
|
description | string |
Descrizione del video. |
|
|
Partition
|
partition | string |
Una partizione per cui eseguire ricerche nei video. |
|
|
ID esterno
|
externalId | string |
ID esterno (associato al video al caricamento). |
|
|
Callback URL (URL callback)
|
callbackUrl | string |
URL da notificare al completamento dell'indicizzazione. Deve essere un URL POST e Video Indexer aggiungerà 2 parametri di stringa di query aggiuntivi: ID e stato. |
|
|
Metadati
|
metadata | string |
I metadati da associare al video (verranno restituiti nelle query). |
|
|
Linguaggio video
|
language | string |
Linguaggio video, usato durante la generazione della trascrizione. |
|
|
URL del video
|
videoUrl | string |
URL pubblico del file video/audio (con codifica URL). Se non specificato, il file deve essere passato come contenuto del corpo multipart/modulo. |
|
|
Nome del file
|
fileName | string |
Nome file caricato. |
|
|
Set di impostazioni di indicizzazione
|
indexingPreset | string |
Set di impostazioni di indicizzazione da utilizzare. |
|
|
Set di impostazioni di streaming
|
streamingPreset | string |
Set di impostazioni di streaming da usare. |
|
|
ID modello linguistico
|
linguisticModelId | string |
ID modello linguistico ricevuto dalla chiamata 'create linguistic model'. |
|
|
Riservatezza
|
privacy | string |
La privacy del video. |
|
|
URL esterno
|
externalUrl | string |
URL esterno da associare al video (può essere cercato in un secondo momento). |
|
|
Corpo
|
body | file |
Se non viene specificato un URL video, il file deve essere passato come contenuto del corpo multipart/form. |
|
|
ID risorsa
|
assetId | string |
ID asset di Servizi multimediali di Azure. Usato per indicizzare gli asset esistenti nell'account di Servizi multimediali di Azure connesso. (solo a pagamento). |
|
|
Priority
|
priority | string |
Priorità dell'indice (bassa, normale e alta). Può essere utilizzato solo nelle aree a pagamento. |
|
|
Categorie marchi
|
brandsCategories | string |
Elenco di categorie di marchi delimitate da virgola. L'indicizzatore video tiene conto di queste categorie solo durante l'indicizzazione. Se non specificato, verranno utilizzati tutti i marchi. |
Restituisce
- Corpo
- UploadResponse
Cerca video
Questa operazione esegue una ricerca di testo, parole chiave e contenuto visivo.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Testo query
|
query | string |
Testo libero da cercare. |
|
|
Ambito testo
|
textScope | string |
Ambito del testo in cui eseguire la ricerca. |
|
|
Riservatezza
|
privacy | string |
La privacy del video. |
|
|
Video ID
|
id | string |
ID video da cercare. |
|
|
Partition
|
partition | string |
Una partizione per cui eseguire ricerche nei video. |
|
|
Proprietario
|
owner | string |
Proprietario del video da cercare. |
|
|
Nome viso
|
face | string |
Cerca persone o celebrità. |
|
|
ID esterno
|
externalId | string |
ID esterno (associato al video al caricamento). |
|
|
Dimensioni pagina
|
pageSize | integer |
Numero di risultati da restituire. |
|
|
Salta
|
skip | integer |
Numero di risultati da ignorare (utilizzato per il paging). |
|
|
Lingua di origine
|
sourceLanguage | string |
Includere solo video con la lingua di origine specificata. È possibile specificare più parametri linguistici (ad esempio $language=inglese&language=francese) per eseguire ricerche in più lingue. Se si lascia vuoto questo parametro, verrà eseguita la ricerca in tutte le lingue. |
|
|
Language
|
language | string |
Lingua di ricerca. È possibile specificare più parametri linguistici (ad esempio $language=inglese&language=francese) per eseguire ricerche in più lingue. Se si lascia vuoto questo parametro, verrà eseguita la ricerca in tutte le lingue. |
|
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
Restituisce
Elencare video
Questa operazione ottiene un elenco di tutti i video nell'account.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
|
Dimensioni pagina
|
pageSize | integer |
Numero di risultati da restituire. |
|
|
Salta
|
skip | integer |
Numero di pagine da ignorare. |
Restituisce
Elimina file di origine video
Questa operazione elimina il file di origine video, ma non elimina le informazioni dettagliate rilevate quando il video è stato indicizzato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di scrittura. |
Elimina video
Questa operazione elimina il video specificato e tutte le informazioni dettagliate correlate trovate quando il video è stato indicizzato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di scrittura. |
Ottenere account
Questa operazione restituisce i dettagli degli account dell'utente.
Restituisce
Ottenere il token di accesso all'account
Ottiene un token di accesso all'account (scade dopo un'ora).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Consenti modifica
|
allowEdit | True | boolean |
Determina se il token dispone di autorizzazioni di scrittura. |
Restituisce
Token di accesso.
- response
- tokenResponse
Ottenere l'account
Questa operazione restituisce i dettagli dell'account dell'utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
Restituisce
Ottenere l'anteprima video
Ottenere un'immagine di anteprima di un video.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
ID anteprima
|
thumbnailId | True | uuid |
ID anteprima. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
Restituisce
Ottenere l'ID video per ID esterno
Questa operazione recupera l'ID video corrispondente all'ID esterno.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
ID esterno
|
externalId | True | string |
ID esterno. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
Restituisce
ID video.
- Video ID
- string
Ottenere l'indice video
Questa operazione ottiene un video e le relative informazioni dettagliate.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
|
Lingua delle didascalie
|
language | string |
Lingua delle didascalie. |
Restituisce
- Corpo
- GetIndexResponse
Ottenere sottotitoli video
Questa operazione restituisce le didascalie estratte quando il video è stato indicizzato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di lettura. |
|
Formato
|
format | True | string |
Formato delle didascalie ,ad esempio vtt. |
|
Lingua delle didascalie
|
language | string |
Lingua delle didascalie. |
Restituisce
Elenco di didascalie estratte.
- Elenco di didascalie estratte
- string
Re-index Video
Questa operazione reindicisce il video specificato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Posizione
|
location | True | string |
Indica l'area di Azure a cui deve essere instradata la chiamata. |
|
Account ID
|
accountId | True | uuid |
L'ID account è un identificatore univoco globale (GUID) per l'account. |
|
Video ID
|
videoId | True | string |
ID video. |
|
Token di accesso
|
accessToken | True | string |
Token di accesso dell'account con autorizzazioni di scrittura. |
|
Set di impostazioni di indicizzazione
|
indexingPreset | string |
Set di impostazioni di indicizzazione da utilizzare. |
|
|
Set di impostazioni di streaming
|
streamingPreset | string |
Set di impostazioni di streaming da usare. |
|
|
Callback URL (URL callback)
|
callbackUrl | string |
URL da notificare al completamento dell'indicizzazione. Deve essere un URL POST e Video Indexer aggiungerà 2 parametri di stringa di query aggiuntivi: ID e stato. |
|
|
Priority
|
priority | string |
Priorità dell'indice (bassa, normale e alta). Può essere utilizzato solo nelle aree a pagamento. |
|
|
Categorie marchi
|
brandsCategories | string |
Elenco di categorie di marchi delimitate da virgola. L'indicizzatore video tiene conto di queste categorie solo durante l'indicizzazione. Se non specificato, verranno utilizzati tutti i marchi. |
|
|
Lingua di origine
|
sourceLanguage | string |
Lingua da impostare come lingua di origine del video da usare durante la generazione della trascrizione. |
Definizioni
tokenResponse
Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Results
|
results | array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2 |
Risultati della ricerca. |
|
nextPage
|
nextPage | Microsoft.VideoIndexer.Common.ContractsV2.SearchPage |
UploadResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Video ID
|
id | string |
ID video. |
Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Account ID
|
accountId | uuid |
ID account. |
|
Video ID
|
id | string |
ID video. |
|
Partition
|
partition | string |
Partizione del video. |
|
ID esterno
|
externalId | string |
ID esterno associato al video. |
|
Metadati
|
metadata | string |
Metadati. |
|
Nome
|
name | string |
Nome del video. |
|
Description
|
description | string |
Descrizione del video. |
|
Created
|
created | date-time |
Al momento della creazione del video. |
|
Ultima modifica
|
lastModified | date-time |
Data dell'ultima modifica del video. |
|
Ultimo indice
|
lastIndexed | date-time |
Quando il video è stato indicizzato per l'ultima volta. |
|
Riservatezza
|
privacyMode | string |
Modalità di privacy del video (pubblico o privato). |
|
Nome utente
|
userName | string |
Nome utente del proprietario del video. |
|
Proprietà
|
isOwned | boolean |
Indica se il video è di proprietà dell'utente che ha effettuato la chiamata. |
|
Is Base
|
isBase | boolean |
Indica se il video è un video di base. |
|
stato
|
state | string |
Stato di elaborazione del video. (Caricata/Elaborazione/Elaborato/Non riuscito/Messo in quarantena). |
|
Stato di elaborazione
|
processingProgress | string |
Percentuale di avanzamento del video, se in corso di elaborazione. |
|
Durata in secondi
|
durationInSeconds | integer |
Durata del video in secondi. |
|
ID video di anteprima
|
thumbnailVideoId | string |
ID del video contenente l'anteprima originale. |
|
ID anteprima
|
thumbnailId | uuid |
ID anteprima. |
|
Cerca corrispondenze
|
searchMatches |
Le corrispondenze di ricerca e i relativi dettagli (stringa json). |
|
|
Set di impostazioni di indicizzazione
|
indexingPreset | string |
Set di impostazioni di indicizzazione dell'indice video. |
|
Set di impostazioni di streaming
|
streamingPreset | string |
Set di impostazioni di streaming dell'indice video. |
|
Lingua di origine
|
sourceLanguage | string |
Lingua di origine del video. |
Microsoft.VideoIndexer.Common.ContractsV2.SearchPage
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Dimensioni pagina
|
pageSize | integer |
Dimensioni della pagina dei risultati della ricerca. |
|
Salta
|
skip | integer |
Numero di risultati da ignorare (usato per il paging). |
|
Done
|
done | boolean |
Indica se la ricerca viene eseguita. |
GetIndexResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Account ID
|
accountId | uuid |
ID account. |
|
Video ID
|
id | string |
ID video. |
|
Partizione video
|
partition | string |
Partizione del video. |
|
Nome
|
name | string |
Nome del video. |
|
Description
|
description | string |
Descrizione del video. |
|
Nome utente
|
userName | string |
Nome utente del proprietario del video. |
|
Created
|
created | date-time |
Ora di creazione del video. |
|
Riservatezza
|
privacyMode | string |
Modalità di privacy del video. |
|
stato
|
state | string |
Stato di elaborazione del video. (Caricata/Elaborazione/Elaborato/Non riuscito/Messo in quarantena). |
|
Proprietà
|
isOwned | boolean |
Indica se il video è di proprietà di un utente. |
|
Modificabile
|
isEditable | boolean |
Indica se la richiesta di ottenere il video ha un token con autorizzazione di scrittura. |
|
Is Base
|
isBase | boolean |
Indica se il video è un video di base. |
|
Durata in secondi
|
durationInSeconds | integer |
Durata del video in secondi. |
|
Informazioni dettagliate sui video
|
videos | array of object |
Informazioni dettagliate sui video ricavate dall'indice video (stringa json). |
|
Intervalli video
|
videosRanges |
Intervalli dei video in questo indice (stringa json). |
Microsoft.VideoIndexer.Common.ContractsV2.AccountContractslim
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Account ID
|
id | uuid |
ID account. |
|
Nome dell'account
|
name | string |
Nome dell'account. |
|
Posizione dell'account
|
location | string |
Posizione dell'account. |
|
Tipo di conto
|
accountType | string |
Tipo di account. |
|
URL dell'account
|
url | string |
Le chiamate API devono essere effettuate all'URL dell'account e alla posizione dell'account. |
Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Tipo di contenuto.
|
$content-type | string |
Tipo di contenuto. |
|
Contenuto.
|
$content | string |
Contenuto. |
corda
Si tratta del tipo di dati di base 'string'.