Video Indexer (förhandsversion)

Extrahera enkelt insikter från dina videor och berika dina program snabbt för att förbättra identifiering och engagemang. Använd Video Indexer-anslutningsappen för att omvandla dina videor till insikter.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service	Class	Regioner
Logiska appar	Standard	Alla Logic Apps-regioner utom följande:      - Azure kinaregioner      - US Department of Defense (DoD)

Metadata för anslutningsprogram
Publisher	Microsoft

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Standardinställning	Parametrar för att skapa anslutning.	Alla regioner	Shareable

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i översikten Connectors för appar för arbetsytor – Power Apps | Microsoft Docs

Namn	Type	Beskrivning	Obligatoriskt
API-nyckel	securestring	API-nyckeln för det här API:et	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	1200	60 sekunder

Åtgärder

Hämta bearbetningstillstånd	Den här åtgärden hämtar bearbetningstillståndet för det angivna uppdelnings-ID:t och om bearbetningen returnerar förloppet (t.ex. 30%).
Hämta konton	Returnerar information om användarens konton.
Hämta spelarens widget-URL	Den här åtgärden returnerar en URL till spelarwidgeten, inklusive en åtkomsttoken.
Hämta url:en för avskrift (VTT)	Den här åtgärden returnerar en URL till en VTT-fil med den angivna uppdelningens undertexter.
Hämta url:en för insights-widgeten	Den här åtgärden returnerar en URL till widgeten cognitive insights, inklusive en åtkomsttoken.
Hämta url:en för insiktswidgeten (med hjälp av det externa ID:t)	Den här åtgärden returnerar en URL till widgeten cognitive insights, inklusive en åtkomsttoken, baserat på ett visst externt ID.
Hämta videouppdelning	Den här åtgärden returnerar fullständig information om den angivna uppdelningen, inklusive alla insikter (avskrift, OCR, personer osv.).
Ladda upp video och index	Den här åtgärden laddar upp den angivna videon, börjar indexera den och returnerar ett nytt uppdelnings-ID.
Ladda upp video och index (med hjälp av en URL)	Den här åtgärden laddar upp den angivna videon, börjar indexera den och returnerar ett nytt uppdelnings-ID.
Omindexering av videouppdelning	Den här åtgärden indexerar om den angivna uppdelningen.
Omindexering av videouppdelning (med hjälp av det externa ID:t)	Den här åtgärden indexerar videon av det angivna externa ID:t igen.
Sök text eller ansikte	Den här åtgärden utför sökning och returnerar resultatet. Om det är tillgängligt returneras matchningarna för sökfiltren i resultatet.
Ta bort video och dess insikter	Den här åtgärden tar bort den uppladdade videon och om deleteInsights=true tas även de genererade insikterna bort.
Uppdatera ansiktsnamn	Den här åtgärden uppdaterar namnet på det angivna ansiktet och tränar ansiktsmodellen för att identifiera ansiktet i framtida videor.

Hämta bearbetningstillstånd

Åtgärds-ID:

GetProcessingState

Den här åtgärden hämtar bearbetningstillståndet för det angivna uppdelnings-ID:t och om bearbetningen returnerar förloppet (t.ex. 30%).

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	ID som är associerat med videon och dess uppdelning.

Returer

Name	Sökväg	Typ	Description
Tillstånd	state	string	Överfört, bearbetat, bearbetat eller misslyckat.
Progress	progress	string	Procentandel av videon om tillståndet bearbetas.

Hämta konton

Åtgärds-ID:

GetAccounts

Returnerar information om användarens konton.

Returer

Name	Sökväg	Typ	Description
		array of object
Konto-ID	id	string
Kontonamn	name	string

Hämta spelarens widget-URL

Åtgärds-ID:

GetPlayerWidgetUrl

Den här åtgärden returnerar en URL till spelarwidgeten, inklusive en åtkomsttoken.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	Videouppdelnings-ID:t.

Returer

Url för spelarwidget.

URL

string

Hämta url:en för avskrift (VTT)

Åtgärds-ID:

GetVttUrl

Den här åtgärden returnerar en URL till en VTT-fil med den angivna uppdelningens undertexter.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	ID:t som är associerat med videon och dess uppdelning.
Språk	language		string	Det begärda språket i texten.

Returer

Url för videons VTT-fil.

URL

string

Hämta url:en för insights-widgeten

Åtgärds-ID:

GetInsightsWidgetUrl

Den här åtgärden returnerar en URL till widgeten cognitive insights, inklusive en åtkomsttoken.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	ID:t som är associerat med videon och dess uppdelning.
Widgettyp	widgetType		string	Personer, känslor, nyckelord eller sökning.

Returer

Url till widgeten cognitive insights.

URL

string

Hämta url:en för insiktswidgeten (med hjälp av det externa ID:t)

Åtgärds-ID:

GetInsightsWidgetUrlByExternalId

Den här åtgärden returnerar en URL till widgeten cognitive insights, inklusive en åtkomsttoken, baserat på ett visst externt ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Externt ID	externalId	True	string	Ett externt ID att söka efter (associerat med en video av den här prenumerationen vid uppladdning).
Widgettyp	widgetType		string	En typ av en underwidget som ska inkluderas (Personer, Sentiment, Nyckelord, Sök).

Returer

Url till widgeten cognitive insights.

URL

string

Hämta videouppdelning

Åtgärds-ID:

GetBreakdown

Den här åtgärden returnerar fullständig information om den angivna uppdelningen, inklusive alla insikter (avskrift, OCR, personer osv.).

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	Uppdelnings-ID, som returneras av API:erna för uppladdning eller sökning.
Språk	language		string	Begärt språk för texten.

Returer

Name	Sökväg	Typ	Description
Konto-ID	accountId	string	Unikt ID som är associerat med kontot.
Video-ID	id	string	Unikt ID som är associerat med videon och dess uppdelning.
Partition	partition	string	Partitionering av videon.
Namn	name	date-time	Videons namn.
Beskrivning	description	string	Beskrivning av videon.
Användarnamn	userName	string	Användarnamn för videons konto.
Skapa tid	createTime	date-time	Tidpunkt då videon skapades.
Organisation	organization	string	Organisationskontot tillhör.
Sekretessläge	privacyMode	string	Sekretessläge för videon.
Tillstånd	state	string	Uppladdad, bearbetad, bearbetad eller misslyckad).
Ägs	isOwned	boolean	Sant om videon ägs av en användare.
Är bas	isBase	boolean	Sant om videon är en basvideo.
Sammanfattade insikter	summarizedInsights	string	Sammanfattning av insikter som hämtats från videons uppdelningar
Matris för uppdelningar	breakdowns	string	Matris med videons uppdelningar.
Gillad av användare	social.likedByUser	boolean	Sant om videon har gillats av en användare. Annars är det falskt.
Gillar	social.likes	integer	Antal likes i videon.
Views	social.views	integer	Antal visningar av videon.

Ladda upp video och index

Åtgärds-ID:

UploadVideoFileContent

Den här åtgärden laddar upp den angivna videon, börjar indexera den och returnerar ett nytt uppdelnings-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Filinnehåll	fileContent	True	binary	Videon i flerdelsformat.
Språk	language		string	Språket i videon som ska användas när avskriften genereras.
Externt ID	externalId		string	Ett externt ID som ska associeras med videon (kan sökas efter senare).
Metainformation	metadata		string	Metadata som ska associeras med videon (returneras i frågor).
Beskrivning	description		string	Videobeskrivningen.
Partition	partition		string	En partition som ska partitioneras av (används för att söka efter en specifik partition).
Videonamn	name	True	string	Videonamnet.
Privatliv	privacy	True	string	Privat, organisation eller offentligt.
Återanrops-URL	callbackUrl		string	En URL som ska meddelas när indexeringen har slutförts.

Returer

ID:t som är associerat med videon och dess uppdelning.

response

videoResponse

Ladda upp video och index (med hjälp av en URL)

Åtgärds-ID:

UploadVideo

Den här åtgärden laddar upp den angivna videon, börjar indexera den och returnerar ett nytt uppdelnings-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-URL	videoUrl	True	string	En offentlig URL för videon.
Språk	language		string	Språket i videon som ska användas när avskriften genereras.
Externt ID	externalId		string	Ett externt ID som ska associeras med videon (kan sökas efter senare).
Metainformation	metadata		string	Metadata som ska associeras med videon (returneras i frågor).
Beskrivning	description		string	Videobeskrivningen.
Partition	partition		string	En partition som ska partitioneras av (används för att söka efter en specifik partition).
Videonamn	name	True	string	Videonamnet.
Privatliv	privacy	True	string	Privat, organisation eller offentligt.
Återanrops-URL	callbackUrl		string	En URL som ska meddelas när indexeringen har slutförts.

Returer

ID:t som är associerat med videon och dess uppdelning.

response

videoResponse

Omindexering av videouppdelning

Åtgärds-ID:

Re-IndexBreakdown

Den här åtgärden indexerar om den angivna uppdelningen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	Videouppdelnings-ID:t.
Återanrops-URL	callbackUrl		string	En URL som ska meddelas när omindexeringen har slutförts.

Returer

response

object

Omindexering av videouppdelning (med hjälp av det externa ID:t)

Åtgärds-ID:

Re-IndexBreakdownByExternalId

Den här åtgärden indexerar videon av det angivna externa ID:t igen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Externt ID	externalId	True	string	Ett externt ID (som var associerat med en video av den här prenumerationen vid uppladdning).
Återanrops-URL	callbackUrl		string	En URL som ska meddelas när omindexeringen har slutförts.

Returer

response

object

Sök text eller ansikte

Åtgärds-ID:

Search

Den här åtgärden utför sökning och returnerar resultatet. Om det är tillgängligt returneras matchningarna för sökfiltren i resultatet.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Ansiktsfråga	face		string	Ett ansikte att söka efter.
Textfråga	query		string	Fritext att söka efter.
Sök efter offentligt konto	searchInPublicAccount		string	Sant att titta på ett offentligt konto.
Privatliv	privacy		string	Privat, organisation eller offentligt.
Textomfång	textScope		string	Omfång att söka i.
Språk	language		string	För att söka i.
Video-ID	id		string	Videouppdelnings-ID att söka efter.
Partition	partition		string	Partition att söka efter.
Ägare	owner		string	En ägare att söka efter.
Sidstorlek	pageSize		number	Antal resultat som ska returneras.
Hoppa över	skip		number	Antal resultat att hoppa över (används för växling).
Externt ID	externalId		string	Ett externt ID att söka efter (associerat med videon vid uppladdning).

Returer

Name	Sökväg	Typ	Description
Results	results	array of object
Konto-ID	results.accountId	string	Av det konto som laddade upp videon.
Video-ID	results.id	string	ID som är associerat med videon och dess uppdelning.
Partition	results.partition	string	Partitionering av videon.
Externt ID	results.externalId	string	Externt ID för videon (användaren som angavs vid uppladdningen).
Metainformation	results.metadata	string	Metadata för videon.
Namn	results.name	string	Videons namn.
Beskrivning	results.description	string	Beskrivning av videon.
Skapa tid	results.createTime	date-time	Tidpunkt då videon skapades.
Organisation	results.organization	string	Organisationskontot tillhör.
Sekretessläge	results.privacyMode	string	Organisationskontot tillhör.
Användarnamn	results.userName	string	Användarnamn för videons konto.
Ägs	results.isOwned	boolean	Sant om videon ägs av en användare.
Är bas	results.isBase	boolean	Sant om videon är en basvideo.
Tillstånd	results.state	string	Överfört, bearbetat, bearbetat eller misslyckat.
Bearbetningsstatus	results.processingProgress	string	Förloppsprocent för videon om tillståndet bearbetas.
Varaktighet i sekunder	results.durationInSeconds	integer	Videons varaktighet i sekunder.
Url för miniatyr	results.thumbnailUrl	string	Videons miniatyr-URL.
Gillad av användare	results.social.likedByUser	boolean	Sant om videon har gillats av användaren. Annars är det falskt.
Gillar	results.social.likes	integer	Antal gilla-markeringar för videon.
Views	results.social.views	integer	Antal visningar av videon.
Sökmatchningar	results.searchMatches	string	Matris med matchningar till sökningen och information om matchningarna.

Ta bort video och dess insikter

Åtgärds-ID:

DeleteBreakdown

Den här åtgärden tar bort den uppladdade videon och om deleteInsights=true tas även de genererade insikterna bort.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	ID som är associerat med videon och dess uppdelning.
Ta bort insikter	deleteInsights		boolean	Om du vill ta bort de genererade insikterna också (Sant eller Falskt).

Returer

response

object

Uppdatera ansiktsnamn

Åtgärds-ID:

UpdateFaceName

Den här åtgärden uppdaterar namnet på det angivna ansiktet och tränar ansiktsmodellen för att identifiera ansiktet i framtida videor.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Video-ID	id	True	string	Videouppdelnings-ID:t.
Ansikts-ID	faceId	True	number	Ansikts-ID :t (från videons json).
Nytt namn	newName	True	string	Det nya namnet på ansiktet (använd "Okänd #1/2/3..." för att bli anonym).

Returer

response

object

Definitioner

videoResponse

ID:t som är associerat med videon och dess uppdelning.

ID:t som är associerat med videon och dess uppdelning.

Video-ID

string

objekt

Det här är typen "objekt".

snöre

Det här är den grundläggande datatypen "string".