Video Indexer (preview)
Pak eenvoudig inzichten uit uw video's en verrijk uw toepassingen snel om de detectie en betrokkenheid te verbeteren. Gebruik de Video Indexer-connector om uw video's om te zetten in inzichten.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | klasse | Regio's |
|---|---|---|
| Logic-apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure China-regio's - Us Department of Defense (DoD) |
| Connectormetagegevens | |
|---|---|
| Publisher | Microsoft |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typ | Beschrijving | Verplicht |
|---|---|---|---|
| API-sleutel | beveiligde string | De API-sleutel voor deze API | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 1200 | 60 seconden |
Acties
| Accounts ophalen |
Retourneert de details van de accounts van de gebruiker. |
| De transcriptie-URL (VTT) ophalen |
Deze bewerking retourneert een URL naar een VTT-bestand met de bijschriften van de opgegeven uitsplitsing. |
| De URL van de inzichtenwidget ophalen |
Deze bewerking retourneert een URL naar de widget cognitieve inzichten, inclusief een toegangstoken. |
| De URL van de inzichtenwidget ophalen (met behulp van de externe id) |
Deze bewerking retourneert een URL naar de widget cognitive insights, inclusief een toegangstoken, op basis van een bepaalde externe id. |
| De url van de spelerwidget ophalen |
Deze bewerking retourneert een URL naar de spelerwidget, inclusief een toegangstoken. |
| Naam van gezicht bijwerken |
Met deze bewerking wordt de naam van het opgegeven gezicht bijgewerkt en wordt het gezichtsmodel getraind om dat gezicht in toekomstige video's te herkennen. |
| Tekst of gezicht zoeken |
Met deze bewerking wordt een zoekopdracht uitgevoerd en worden de resultaten geretourneerd. Indien beschikbaar, worden de overeenkomsten van de zoekfilters in de resultaten geretourneerd. |
| Verwerkingsstatus ophalen |
Met deze bewerking wordt de verwerkingsstatus van de opgegeven uitsplitsings-id opgehaald en als de verwerking de voortgang retourneert (bijvoorbeeld 30%). |
| Video en de bijbehorende inzichten verwijderen |
Met deze bewerking wordt de geüploade video verwijderd en als deleteInsights=true, worden ook de gegenereerde inzichten verwijderd. |
| Video en index uploaden |
Met deze bewerking wordt de opgegeven video geüpload, geïndexeer deze en wordt een nieuwe uitsplitsings-id geretourneerd. |
| Video en index uploaden (met behulp van een URL) |
Met deze bewerking wordt de opgegeven video geüpload, geïndexeer deze en wordt een nieuwe uitsplitsings-id geretourneerd. |
| Video-uitsplitsing ophalen |
Deze bewerking retourneert de volledige details van de opgegeven uitsplitsing, inclusief alle inzichten (transcript, OCR, personen, enzovoort). |
| Video-uitsplitsing opnieuw indexeren |
Met deze bewerking wordt de opgegeven uitsplitsing opnieuw geïndexeert. |
| Video-uitsplitsing opnieuw indexeren (met behulp van de externe id) |
Met deze bewerking wordt de video van de opgegeven externe id opnieuw geïndexeert. |
Accounts ophalen
Retourneert de details van de accounts van de gebruiker.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Account-ID
|
id | string | |
|
Accountnaam
|
name | string |
De transcriptie-URL (VTT) ophalen
Deze bewerking retourneert een URL naar een VTT-bestand met de bijschriften van de opgegeven uitsplitsing.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
De id die is gekoppeld aan de video en de uitsplitsing ervan. |
|
Language
|
language | string |
De aangevraagde taal van de tekst. |
Retouren
Url van het VTT-bestand van de video.
- URL
- string
De URL van de inzichtenwidget ophalen
Deze bewerking retourneert een URL naar de widget cognitieve inzichten, inclusief een toegangstoken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
De id die is gekoppeld aan de video en de uitsplitsing ervan. |
|
Widgettype
|
widgetType | string |
Personen, sentimenten, trefwoorden of zoekopdrachten. |
Retouren
URL van de widget Cognitieve inzichten.
- URL
- string
De URL van de inzichtenwidget ophalen (met behulp van de externe id)
Deze bewerking retourneert een URL naar de widget cognitive insights, inclusief een toegangstoken, op basis van een bepaalde externe id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Externe id
|
externalId | True | string |
Een externe id waarnaar moet worden gezocht (gekoppeld aan een video van dit abonnement bij uploaden). |
|
Widgettype
|
widgetType | string |
Een type subwidget dat moet worden opgenomen (Personen, Sentimenten, Trefwoorden, Zoeken). |
Retouren
URL van de widget Cognitieve inzichten.
- URL
- string
De url van de spelerwidget ophalen
Deze bewerking retourneert een URL naar de spelerwidget, inclusief een toegangstoken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
De video-uitsplitsings-id. |
Retouren
Url van spelerwidget.
- URL
- string
Naam van gezicht bijwerken
Met deze bewerking wordt de naam van het opgegeven gezicht bijgewerkt en wordt het gezichtsmodel getraind om dat gezicht in toekomstige video's te herkennen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
De video-uitsplitsings-id. |
|
Face Id
|
faceId | True | number |
De face-id (uit de json van de video). |
|
Nieuwe naam
|
newName | True | string |
De nieuwe naam voor het gezicht (gebruik 'Onbekend #1-2-3...' om anoniem te maken). |
Retouren
- response
- object
Tekst of gezicht zoeken
Met deze bewerking wordt een zoekopdracht uitgevoerd en worden de resultaten geretourneerd. Indien beschikbaar, worden de overeenkomsten van de zoekfilters in de resultaten geretourneerd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Face-query
|
face | string |
Een gezicht om naar te zoeken. |
|
|
Tekstquery
|
query | string |
Vrije tekst om naar te zoeken. |
|
|
Openbaar account zoeken
|
searchInPublicAccount | string |
Waar om in een openbaar account te kijken. |
|
|
Geheimhouding
|
privacy | string |
Privé, organisatie of openbaar. |
|
|
Tekstbereik
|
textScope | string |
Bereik waarin moet worden gezocht. |
|
|
Language
|
language | string |
Zoeken in. |
|
|
Video-id
|
id | string |
Uitsplitsings-id van video om naar te zoeken. |
|
|
Partitie
|
partition | string |
Partitie om naar te zoeken. |
|
|
Owner
|
owner | string |
Een eigenaar die moet zoeken. |
|
|
Paginagrootte
|
pageSize | number |
Aantal resultaten dat geretourneerd moet worden. |
|
|
Overslaan
|
skip | number |
Aantal resultaten dat moet worden overgeslagen (gebruikt voor paging). |
|
|
Externe ID
|
externalId | string |
Een externe id om naar te zoeken (gekoppeld aan de video bij uploaden). |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Account-ID
|
results.accountId | string |
Van het account dat video heeft geüpload. |
|
Video-id
|
results.id | string |
Id die is gekoppeld aan de video en de uitsplitsing ervan. |
|
Partitie
|
results.partition | string |
Partitie van de video. |
|
Externe id
|
results.externalId | string |
Externe id van de video (gebruiker die tijdens het uploaden is opgegeven). |
|
Metagegevens
|
results.metadata | string |
Metagegevens van de video. |
|
Naam
|
results.name | string |
Naam van de video. |
|
Beschrijving
|
results.description | string |
Beschrijving van de video. |
|
Tijd maken
|
results.createTime | date-time |
Tijd voor het maken van de video. |
|
Organisatie
|
results.organization | string |
Het organisatieaccount behoort tot. |
|
Privacymodus
|
results.privacyMode | string |
Het organisatieaccount behoort tot. |
|
Gebruikersnaam
|
results.userName | string |
Gebruikersnaam van het account van de video. |
|
Is eigendom van
|
results.isOwned | boolean |
Is waar als de video eigendom is van een gebruiker. |
|
Is basis
|
results.isBase | boolean |
Is waar als de video een basisvideo is. |
|
State
|
results.state | string |
Geüpload, verwerkt, verwerkt of mislukt. |
|
Voortgang van verwerking
|
results.processingProgress | string |
Voortgangspercentage van de video als de status wordt verwerkt. |
|
Duur in seconden
|
results.durationInSeconds | integer |
Duur van de video in seconden. |
|
Miniatuur-URL
|
results.thumbnailUrl | string |
Miniatuur-URL van de video. |
|
Leuk gevonden door gebruiker
|
results.social.likedByUser | boolean |
Is waar als de video door de gebruiker is leuk gevonden. Anders is het onwaar. |
|
Houdt
|
results.social.likes | integer |
Aantal vind-ik-leuks van de video. |
|
Weergaven
|
results.social.views | integer |
Aantal weergaven van de video. |
|
Zoekovereenkomsten
|
results.searchMatches | string |
Matrix van overeenkomsten voor de zoekopdracht en details van de overeenkomsten. |
Verwerkingsstatus ophalen
Met deze bewerking wordt de verwerkingsstatus van de opgegeven uitsplitsings-id opgehaald en als de verwerking de voortgang retourneert (bijvoorbeeld 30%).
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
Id die is gekoppeld aan de video en de uitsplitsing ervan. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
State
|
state | string |
Geüpload, verwerkt, verwerkt of mislukt. |
|
Progress
|
progress | string |
Percentage van de video als de status wordt verwerkt. |
Video en de bijbehorende inzichten verwijderen
Met deze bewerking wordt de geüploade video verwijderd en als deleteInsights=true, worden ook de gegenereerde inzichten verwijderd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
Id die is gekoppeld aan de video en de uitsplitsing ervan. |
|
Inzichten verwijderen
|
deleteInsights | boolean |
Of u de gegenereerde inzichten ook wilt verwijderen (waar of onwaar). |
Retouren
- response
- object
Video en index uploaden
Met deze bewerking wordt de opgegeven video geüpload, geïndexeer deze en wordt een nieuwe uitsplitsings-id geretourneerd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bestandsinhoud
|
fileContent | True | binary |
De video in meerdere delen. |
|
Language
|
language | string |
De taal van de video die moet worden gebruikt bij het genereren van het transcript. |
|
|
Externe id
|
externalId | string |
Een externe id die aan de video moet worden gekoppeld (kan later worden gezocht). |
|
|
Metagegevens
|
metadata | string |
Metagegevens die moeten worden gekoppeld aan de video (worden geretourneerd in query's). |
|
|
Beschrijving
|
description | string |
De beschrijving van de video. |
|
|
Partitie
|
partition | string |
Een partitie voor het partitioneren van video's door (gebruikt voor het zoeken naar een specifieke partitie). |
|
|
Naam van video
|
name | True | string |
De naam van de video. |
|
Geheimhouding
|
privacy | True | string |
Privé, organisatie of openbaar. |
|
Callback-URL
|
callbackUrl | string |
Een URL om te melden wanneer indexering is voltooid. |
Retouren
De id die is gekoppeld aan de video en de uitsplitsing ervan.
- response
- videoResponse
Video en index uploaden (met behulp van een URL)
Met deze bewerking wordt de opgegeven video geüpload, geïndexeer deze en wordt een nieuwe uitsplitsings-id geretourneerd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-URL
|
videoUrl | True | string |
Een openbare URL van de video. |
|
Language
|
language | string |
De taal van de video die moet worden gebruikt bij het genereren van het transcript. |
|
|
Externe id
|
externalId | string |
Een externe id die aan de video moet worden gekoppeld (kan later worden gezocht). |
|
|
Metagegevens
|
metadata | string |
Metagegevens die moeten worden gekoppeld aan de video (worden geretourneerd in query's). |
|
|
Beschrijving
|
description | string |
De beschrijving van de video. |
|
|
Partitie
|
partition | string |
Een partitie voor het partitioneren van video's door (gebruikt voor het zoeken naar een specifieke partitie). |
|
|
Naam van video
|
name | True | string |
De naam van de video. |
|
Geheimhouding
|
privacy | True | string |
Privé, organisatie of openbaar. |
|
Callback-URL
|
callbackUrl | string |
Een URL om te melden wanneer indexering is voltooid. |
Retouren
De id die is gekoppeld aan de video en de uitsplitsing ervan.
- response
- videoResponse
Video-uitsplitsing ophalen
Deze bewerking retourneert de volledige details van de opgegeven uitsplitsing, inclusief alle inzichten (transcript, OCR, personen, enzovoort).
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
Uitsplitsings-id, geretourneerd door de upload- of zoek-API's. |
|
Language
|
language | string |
Aangevraagde taal van de tekst. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Account-ID
|
accountId | string |
Unieke id die is gekoppeld aan het account. |
|
Video-id
|
id | string |
Unieke id die is gekoppeld aan de video en de uitsplitsing ervan. |
|
Partitie
|
partition | string |
Partitie van de video. |
|
Naam
|
name | date-time |
Naam van de video. |
|
Beschrijving
|
description | string |
Beschrijving van de video. |
|
Gebruikersnaam
|
userName | string |
Gebruikersnaam van het account van de video. |
|
Tijd maken
|
createTime | date-time |
Tijd voor het maken van de video. |
|
Organisatie
|
organization | string |
Het organisatieaccount behoort tot. |
|
Privacymodus
|
privacyMode | string |
Privacymodus van de video. |
|
State
|
state | string |
Geüpload, verwerkt, verwerkt of mislukt). |
|
Is eigendom van
|
isOwned | boolean |
Is waar als de video eigendom is van een gebruiker. |
|
Is basis
|
isBase | boolean |
Is waar als de video een basisvideo is. |
|
Samengevatte inzichten
|
summarizedInsights | string |
Samenvatting van inzichten uit de uitsplitsingen van de video |
|
Uitsplitsing van matrix
|
breakdowns | string |
Matrix van de uitsplitsingen van de video. |
|
Leuk gevonden door gebruiker
|
social.likedByUser | boolean |
Is waar als de video door een gebruiker is leuk gevonden. Anders is het onwaar. |
|
Houdt
|
social.likes | integer |
Aantal vind-ik-leuks in de video. |
|
Weergaven
|
social.views | integer |
Aantal weergaven van de video. |
Video-uitsplitsing opnieuw indexeren
Met deze bewerking wordt de opgegeven uitsplitsing opnieuw geïndexeert.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Video-id
|
id | True | string |
De video-uitsplitsings-id. |
|
Callback-URL
|
callbackUrl | string |
Een URL om te melden wanneer opnieuw indexeren is voltooid. |
Retouren
- response
- object
Video-uitsplitsing opnieuw indexeren (met behulp van de externe id)
Met deze bewerking wordt de video van de opgegeven externe id opnieuw geïndexeert.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Externe id
|
externalId | True | string |
Een externe id (die is gekoppeld aan een video van dit abonnement bij uploaden). |
|
Callback-URL
|
callbackUrl | string |
Een URL om te melden wanneer opnieuw indexeren is voltooid. |
Retouren
- response
- object
Definities
videoResponse
De id die is gekoppeld aan de video en de uitsplitsing ervan.
De id die is gekoppeld aan de video en de uitsplitsing ervan.
- Video-id
- string
object
Dit is het type 'object'.
string
Dit is het basisgegevenstype 'tekenreeks'.