Video Indexer (préversion)
Extrayez facilement des insights à partir de vos vidéos et enrichissez rapidement vos applications pour améliorer la découverte et l’engagement. Utilisez le connecteur Video Indexer pour transformer vos vidéos en insights.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Régions |
|---|---|---|
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - régions de chine Azure - Us Department of Defense (DoD) |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble Connectors pour les applications de canevas - Power Apps | Microsoft Docs
| Nom | Type | Description | Obligatoire |
|---|---|---|---|
| Clé API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 1200 | 60 secondes |
Actions
| Charger la vidéo et l’index |
Cette opération charge la vidéo donnée, commence à l’indexer et retourne un nouvel ID de répartition. |
| Charger la vidéo et l’index (à l’aide d’une URL) |
Cette opération charge la vidéo donnée, commence à l’indexer et retourne un nouvel ID de répartition. |
| Mettre à jour le nom du visage |
Cette opération met à jour le nom du visage donné et entraîne le modèle visage pour reconnaître ce visage dans les vidéos futures. |
| Obtenir des comptes |
Retourne les détails des comptes de l’utilisateur. |
| Obtenir la répartition vidéo |
Cette opération retourne les détails complets de la répartition donnée, y compris toutes les informations (transcription, OCR, personnes, etc.). |
| Obtenir l’URL de transcription (VTT) |
Cette opération retourne une URL vers un fichier VTT avec les légendes de la répartition donnée. |
| Obtenir l’URL du widget de lecteur |
Cette opération retourne une URL vers le widget de lecteur, y compris un jeton d’accès. |
| Obtenir l’URL du widget Insights |
Cette opération retourne une URL vers le widget Cognitive Insights, y compris un jeton d’accès. |
| Obtenir l’URL du widget Insights (à l’aide de l’ID externe) |
Cette opération retourne une URL vers le widget Cognitive Insights, y compris un jeton d’accès, en fonction d’un ID externe donné. |
| Obtenir l’état de traitement |
Cette opération récupère l’état de traitement de l’ID de répartition donné et si elle retourne la progression (par exemple, 30%). |
| Rechercher du texte ou du visage |
Cette opération effectue une recherche et retourne les résultats. Si disponible, retourne les correspondances des filtres de recherche dans les résultats. |
| Réindexer la répartition vidéo |
Cette opération réindexe la répartition donnée. |
| Réindexer la répartition vidéo (à l’aide de l’ID externe) |
Cette opération réindexe la vidéo de l’ID externe donné. |
| Supprimer la vidéo et ses insights |
Cette opération supprime la vidéo chargée et, si deleteInsights=true, supprime également les insights générés. |
Charger la vidéo et l’index
Cette opération charge la vidéo donnée, commence à l’indexer et retourne un nouvel ID de répartition.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Contenu du fichier
|
fileContent | True | binary |
Vidéo en plusieurs parties. |
|
Language
|
language | string |
Langue de la vidéo à utiliser lors de la génération de la transcription. |
|
|
ID externe
|
externalId | string |
ID externe à associer à la vidéo (peut être recherché ultérieurement). |
|
|
Metadata
|
metadata | string |
Métadonnées à associer à la vidéo (seront retournées dans les requêtes). |
|
|
Description
|
description | string |
Description de la vidéo. |
|
|
Partition
|
partition | string |
Partition pour partitionner des vidéos par (utilisée pour rechercher une partition spécifique). |
|
|
Nom de la vidéo
|
name | True | string |
Nom de la vidéo. |
|
Confidentialité
|
privacy | True | string |
Privé, organisation ou public. |
|
URL de rappel
|
callbackUrl | string |
URL à notifier lorsque l’indexation est terminée. |
Retours
ID associé à la vidéo et à sa répartition.
- response
- videoResponse
Charger la vidéo et l’index (à l’aide d’une URL)
Cette opération charge la vidéo donnée, commence à l’indexer et retourne un nouvel ID de répartition.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL de la vidéo
|
videoUrl | True | string |
URL publique de la vidéo. |
|
Language
|
language | string |
Langue de la vidéo à utiliser lors de la génération de la transcription. |
|
|
ID externe
|
externalId | string |
ID externe à associer à la vidéo (peut être recherché ultérieurement). |
|
|
Metadata
|
metadata | string |
Métadonnées à associer à la vidéo (seront retournées dans les requêtes). |
|
|
Description
|
description | string |
Description de la vidéo. |
|
|
Partition
|
partition | string |
Partition pour partitionner des vidéos par (utilisée pour rechercher une partition spécifique). |
|
|
Nom de la vidéo
|
name | True | string |
Nom de la vidéo. |
|
Confidentialité
|
privacy | True | string |
Privé, organisation ou public. |
|
URL de rappel
|
callbackUrl | string |
URL à notifier lorsque l’indexation est terminée. |
Retours
ID associé à la vidéo et à sa répartition.
- response
- videoResponse
Mettre à jour le nom du visage
Cette opération met à jour le nom du visage donné et entraîne le modèle visage pour reconnaître ce visage dans les vidéos futures.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID de répartition vidéo. |
|
Id de visage
|
faceId | True | number |
ID de visage (à partir du json de la vidéo). |
|
Nouveau Nom
|
newName | True | string |
Nouveau nom du visage (utilisez « Inconnu #1/2/3... » pour rendre anonyme). |
Retours
- response
- object
Obtenir des comptes
Retourne les détails des comptes de l’utilisateur.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID de compte
|
id | string | |
|
Nom du compte
|
name | string |
Obtenir la répartition vidéo
Cette opération retourne les détails complets de la répartition donnée, y compris toutes les informations (transcription, OCR, personnes, etc.).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID de répartition, retourné par les API de chargement ou de recherche. |
|
Language
|
language | string |
Langue demandée du texte. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de compte
|
accountId | string |
ID unique associé au compte. |
|
ID de la vidéo
|
id | string |
ID unique associé à la vidéo et à sa répartition. |
|
Partition
|
partition | string |
Partition de la vidéo. |
|
Nom
|
name | date-time |
Nom de la vidéo. |
|
Description
|
description | string |
Description de la vidéo. |
|
Nom d'utilisateur
|
userName | string |
Nom d’utilisateur du compte de la vidéo. |
|
Créer une heure
|
createTime | date-time |
Heure de création de la vidéo. |
|
Organisation
|
organization | string |
Le compte d’organisation appartient. |
|
Mode de confidentialité
|
privacyMode | string |
Mode de confidentialité de la vidéo. |
|
State
|
state | string |
Chargement, traitement, traitement ou échec). |
|
Appartient
|
isOwned | boolean |
True si la vidéo appartient à un utilisateur. |
|
Is Base
|
isBase | boolean |
True si la vidéo est une vidéo de base. |
|
Insights résumés
|
summarizedInsights | string |
Résumé des insights tirés des répartitions de la vidéo |
|
Tableau de répartitions
|
breakdowns | string |
Tableau des répartitions de la vidéo. |
|
Aimé par l’utilisateur
|
social.likedByUser | boolean |
True si la vidéo a été aimée par un utilisateur. False dans le cas contraire. |
|
J'aime
|
social.likes | integer |
Nombre de likes sur la vidéo. |
|
Points de vue
|
social.views | integer |
Nombre de vues de la vidéo. |
Obtenir l’URL de transcription (VTT)
Cette opération retourne une URL vers un fichier VTT avec les légendes de la répartition donnée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID associé à la vidéo et à sa répartition. |
|
Language
|
language | string |
Langue demandée du texte. |
Retours
URL du fichier VTT de la vidéo.
- URL
- string
Obtenir l’URL du widget de lecteur
Cette opération retourne une URL vers le widget de lecteur, y compris un jeton d’accès.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID de répartition vidéo. |
Retours
URL du widget de lecteur.
- URL
- string
Obtenir l’URL du widget Insights
Cette opération retourne une URL vers le widget Cognitive Insights, y compris un jeton d’accès.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID associé à la vidéo et à sa répartition. |
|
Widget Type
|
widgetType | string |
Personnes, sentiments, mots clés ou recherche. |
Retours
URL du widget Insights cognitifs.
- URL
- string
Obtenir l’URL du widget Insights (à l’aide de l’ID externe)
Cette opération retourne une URL vers le widget Cognitive Insights, y compris un jeton d’accès, en fonction d’un ID externe donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID externe
|
externalId | True | string |
ID externe à rechercher (associé à une vidéo de cet abonnement lors du chargement). |
|
Widget Type
|
widgetType | string |
Type de sous-widget à inclure (Contacts, Sentiments, Mots clés, Recherche). |
Retours
URL du widget Insights cognitifs.
- URL
- string
Obtenir l’état de traitement
Cette opération récupère l’état de traitement de l’ID de répartition donné et si elle retourne la progression (par exemple, 30%).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID associé à la vidéo et à sa répartition. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
State
|
state | string |
Chargement, traitement, traitement ou échec. |
|
Progrès
|
progress | string |
Pourcentage de la vidéo si l’état est traité. |
Rechercher du texte ou du visage
Cette opération effectue une recherche et retourne les résultats. Si disponible, retourne les correspondances des filtres de recherche dans les résultats.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Requête visage
|
face | string |
Visage à rechercher. |
|
|
Requête de texte
|
query | string |
Texte libre à rechercher. |
|
|
Rechercher un compte public
|
searchInPublicAccount | string |
True pour rechercher dans un compte public. |
|
|
Confidentialité
|
privacy | string |
Privé, organisation ou public. |
|
|
Étendue du texte
|
textScope | string |
Étendue dans laquelle effectuer une recherche. |
|
|
Language
|
language | string |
Pour effectuer une recherche. |
|
|
ID de la vidéo
|
id | string |
ID de répartition vidéo à rechercher. |
|
|
Partition
|
partition | string |
Partition à rechercher. |
|
|
Owner
|
owner | string |
Propriétaire à rechercher. |
|
|
Taille de la page
|
pageSize | number |
Nombre de résultats à renvoyer. |
|
|
Ignorer
|
skip | number |
Nombre de résultats à ignorer (utilisé pour la pagination). |
|
|
N° externe
|
externalId | string |
ID externe à rechercher (associé à la vidéo au chargement). |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID de compte
|
results.accountId | string |
Du compte qui a chargé la vidéo. |
|
ID de la vidéo
|
results.id | string |
ID associé à la vidéo et à sa répartition. |
|
Partition
|
results.partition | string |
Partition de la vidéo. |
|
ID externe
|
results.externalId | string |
ID externe de la vidéo (utilisateur fourni au chargement). |
|
Metadata
|
results.metadata | string |
Métadonnées de la vidéo. |
|
Nom
|
results.name | string |
Nom de la vidéo. |
|
Description
|
results.description | string |
Description de la vidéo. |
|
Créer une heure
|
results.createTime | date-time |
Heure de création de la vidéo. |
|
Organisation
|
results.organization | string |
Le compte d’organisation appartient. |
|
Mode de confidentialité
|
results.privacyMode | string |
Le compte d’organisation appartient. |
|
Nom d’utilisateur
|
results.userName | string |
Nom d’utilisateur du compte de la vidéo. |
|
Appartient
|
results.isOwned | boolean |
True si la vidéo appartient à un utilisateur. |
|
Is Base
|
results.isBase | boolean |
True si la vidéo est une vidéo de base. |
|
State
|
results.state | string |
Chargement, traitement, traitement ou échec. |
|
Progression du traitement
|
results.processingProgress | string |
Pourcentage de progression de la vidéo si l’état est traité. |
|
Durée en secondes
|
results.durationInSeconds | integer |
Durée de la vidéo en secondes. |
|
URL de miniature
|
results.thumbnailUrl | string |
URL miniature de la vidéo. |
|
Aimé par l’utilisateur
|
results.social.likedByUser | boolean |
True si la vidéo a été aimée par l’utilisateur. False dans le cas contraire. |
|
J'aime
|
results.social.likes | integer |
Nombre de likes de la vidéo. |
|
Points de vue
|
results.social.views | integer |
Nombre de vues de la vidéo. |
|
Correspondances de recherche
|
results.searchMatches | string |
Tableau de correspondances à la recherche et aux détails des correspondances. |
Réindexer la répartition vidéo
Cette opération réindexe la répartition donnée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID de répartition vidéo. |
|
URL de rappel
|
callbackUrl | string |
URL à notifier lorsque la réindexation est terminée. |
Retours
- response
- object
Réindexer la répartition vidéo (à l’aide de l’ID externe)
Cette opération réindexe la vidéo de l’ID externe donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID externe
|
externalId | True | string |
ID externe (associé à une vidéo de cet abonnement lors du chargement). |
|
URL de rappel
|
callbackUrl | string |
URL à notifier lorsque la réindexation est terminée. |
Retours
- response
- object
Supprimer la vidéo et ses insights
Cette opération supprime la vidéo chargée et, si deleteInsights=true, supprime également les insights générés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de la vidéo
|
id | True | string |
ID associé à la vidéo et à sa répartition. |
|
Supprimer des insights
|
deleteInsights | boolean |
Indique s’il faut également supprimer les insights générés (True ou False). |
Retours
- response
- object
Définitions
videoResponse
ID associé à la vidéo et à sa répartition.
ID associé à la vidéo et à sa répartition.
- ID de la vidéo
- string
objet
Il s’agit du type 'object'.
ficelle
Il s’agit du type de données de base « string ».