Freigeben über


Videoindexer (V2)

Extrahieren Sie ganz einfach Einblicke aus Ihren Videos, und bereichern Sie Ihre Anwendungen schnell, um Die Entdeckung und das Engagement zu verbessern. Verwenden Sie den Videoindexer-Connector, um Ihre Videos in Einblicke umzuwandeln.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft
Webseite https://vi.microsoft.com

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Face Name aktualisieren

Dieser Vorgang aktualisiert den Namen des gegebenen Gesichts und trainiert das Gesichtsmodell, um dieses Gesicht in zukünftigen Videos zu erkennen.

Hochladen von Videos und Index

Dieser Vorgang lädt das angegebene Video hoch, startet die Indizierung und gibt eine neue Videoindex-ID zurück. Die unterstützten Formate sind hier aufgeführt: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).

Konten abrufen

Dieser Vorgang gibt die Details der Konten des Benutzers zurück.

Konto abrufen

Dieser Vorgang gibt die Details des Benutzerkontos zurück.

Kontozugriffstoken abrufen

Ruft ein Kontozugriffstoken ab (läuft nach einer Stunde ab).

Video erneut indizieren

Dieser Vorgang indiziert das angegebene Video erneut.

Video-ID nach externer ID abrufen

Dieser Vorgang ruft die Video-ID ab, die der externen ID entspricht.

Video löschen

Dieser Vorgang löscht das angegebene Video und alle zugehörigen Erkenntnisse, die beim Indizierung des Videos gefunden wurden.

Videoindex abrufen

Dieser Vorgang erhält ein Video und seine Erkenntnisse.

Videominiaturansicht abrufen

Miniaturansicht eines Videos abrufen.

Videoquelldatei löschen

Dieser Vorgang löscht die Videoquelldatei, löscht jedoch nicht die Erkenntnisse, die beim Indizierung des Videos gefunden wurden.

Videos auflisten

Dieser Vorgang ruft eine Liste aller Videos im Konto ab.

Videos durchsuchen

Dieser Vorgang führt eine Suche nach Text, Schlüsselwörtern und visuellen Inhalten durch.

Videotranskript aktualisieren

Aktualisiert das Transkript des Videos.

Videountertitel abrufen

Dieser Vorgang gibt die beim Indizierung des Videos extrahierten Untertitel zurück.

Face Name aktualisieren

Dieser Vorgang aktualisiert den Namen des gegebenen Gesichts und trainiert das Gesichtsmodell, um dieses Gesicht in zukünftigen Videos zu erkennen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Gesichts-ID
faceId True integer

Die Gesichts-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Schreibberechtigungen.

Neuer Gesichtsname
newName True string

Ein neuer Name für das Gesicht.

Hochladen von Videos und Index

Dieser Vorgang lädt das angegebene Video hoch, startet die Indizierung und gibt eine neue Videoindex-ID zurück. Die unterstützten Formate sind hier aufgeführt: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Schreibberechtigungen.

Videoname
name True string

Der Titel des Videos.

Description
description string

Die Videobeschreibung.

Partition
partition string

Eine Partition zum Durchsuchen von Videos nach.

Externe ID
externalId string

Eine externe ID (die dem Video beim Upload zugeordnet ist).

Rückruf-URL
callbackUrl string

Eine URL, die benachrichtigt werden soll, wenn die Indizierung abgeschlossen ist. Dabei sollte es sich um eine POST-URL handeln, und der Videoindexer fügt 2 zusätzliche Abfragezeichenfolgenparameter hinzu: ID und Status.

Metadaten
metadata string

Metadaten, die dem Video zugeordnet werden sollen (werden in Abfragen zurückgegeben).

Videosprache
language string

Die Videosprache, die beim Generieren des Transkripts verwendet wird.

Video-URL
videoUrl string

Eine öffentliche URL der Video-/Audiodatei (URL-codiert). Wenn nicht angegeben, sollte die Datei als mehrteiliger/formularseitiger Textkörperinhalt übergeben werden.

Dateiname
fileName string

Der hochgeladene Dateiname.

Indizierungsvoreinstellung
indexingPreset string

Die zu verwendende Indizierungsvoreinstellung.

Streamingvoreinstellung
streamingPreset string

Die zu verwendende Streamingvoreinstellung.

Linguistische Modell-ID
linguisticModelId string

Linguistische Modell-ID, die vom Aufruf "Create linguistic model" empfangen wird.

Datenschutz
privacy string

Der Videodatenschutz.

Externe URL
externalUrl string

Eine externe URL, die dem Video zugeordnet werden soll (kann später durchsucht werden).

Body
body file

Wenn keine Video-URL angegeben ist, sollte die Datei als mehrteiliger/Formulartextinhalt übergeben werden.

Objekt-ID
assetId string

Ressourcen-ID für Azure Media Services. Wird verwendet, um aus vorhandenen Ressourcen in Ihrem verbundenen Azure Media Services-Konto indiziert zu werden. (Nur bezahlt).

Priority
priority string

Indexpriorität (Niedrig, Normal und Hoch). Kann nur in kostenpflichtigen Regionen verwendet werden.

Markenkategorien
brandsCategories string

Liste der Markenkategorien, die durch Kommas getrennt sind. Der Videoindexer berücksichtigt diese Kategorien nur bei der Indizierung. Wenn nicht angegeben, werden alle Marken verwendet.

Gibt zurück

Konten abrufen

Dieser Vorgang gibt die Details der Konten des Benutzers zurück.

Gibt zurück

Konto abrufen

Dieser Vorgang gibt die Details des Benutzerkontos zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Gibt zurück

Kontozugriffstoken abrufen

Ruft ein Kontozugriffstoken ab (läuft nach einer Stunde ab).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Bearbeiten zulassen
allowEdit True boolean

Bestimmt, ob das Token Schreibberechtigungen besitzt.

Gibt zurück

Das Zugriffstoken.

response
tokenResponse

Video erneut indizieren

Dieser Vorgang indiziert das angegebene Video erneut.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Schreibberechtigungen.

Indizierungsvoreinstellung
indexingPreset string

Die zu verwendende Indizierungsvoreinstellung.

Streamingvoreinstellung
streamingPreset string

Die zu verwendende Streamingvoreinstellung.

Rückruf-URL
callbackUrl string

Eine URL, die benachrichtigt werden soll, wenn die Indizierung abgeschlossen ist. Dabei sollte es sich um eine POST-URL handeln, und der Videoindexer fügt 2 zusätzliche Abfragezeichenfolgenparameter hinzu: ID und Status.

Priority
priority string

Indexpriorität (Niedrig, Normal und Hoch). Kann nur in kostenpflichtigen Regionen verwendet werden.

Markenkategorien
brandsCategories string

Liste der Markenkategorien, die durch Kommas getrennt sind. Der Videoindexer berücksichtigt diese Kategorien nur bei der Indizierung. Wenn nicht angegeben, werden alle Marken verwendet.

Ausgangssprache
sourceLanguage string

Die Sprache, die als Quellsprache des Videos festgelegt werden soll, die beim Generieren des Transkripts verwendet werden soll.

Video-ID nach externer ID abrufen

Dieser Vorgang ruft die Video-ID ab, die der externen ID entspricht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Externe ID
externalId True string

Die externe ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Gibt zurück

Die Video-ID.

Video-ID
string

Video löschen

Dieser Vorgang löscht das angegebene Video und alle zugehörigen Erkenntnisse, die beim Indizierung des Videos gefunden wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Schreibberechtigungen.

Videoindex abrufen

Dieser Vorgang erhält ein Video und seine Erkenntnisse.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Beschriftungssprache
language string

Die Sprache der Beschriftungen.

Gibt zurück

Videominiaturansicht abrufen

Miniaturansicht eines Videos abrufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Miniaturansichts-ID
thumbnailId True uuid

Die Miniaturansichts-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Gibt zurück

Videoquelldatei löschen

Dieser Vorgang löscht die Videoquelldatei, löscht jedoch nicht die Erkenntnisse, die beim Indizierung des Videos gefunden wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Schreibberechtigungen.

Videos auflisten

Dieser Vorgang ruft eine Liste aller Videos im Konto ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Seitenformat
pageSize integer

Die Anzahl der zurückzugebenden Ergebnisse.

Überspringen
skip integer

Die Anzahl der zu überspringenden Seiten.

Gibt zurück

Videos durchsuchen

Dieser Vorgang führt eine Suche nach Text, Schlüsselwörtern und visuellen Inhalten durch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Abfragetext
query string

Freitext, nach dem gesucht werden soll.

Textbereich
textScope string

Der Textbereich, in den gesucht werden soll.

Datenschutz
privacy string

Der Videodatenschutz.

Video-ID
id string

Eine Video-ID, nach der gesucht werden soll.

Partition
partition string

Eine Partition zum Durchsuchen von Videos nach.

Besitzer
owner string

Ein Videobesitzer, nach dem gesucht werden soll.

Gesichtsname
face string

Suchen Sie nach Personen oder Prominenten.

Externe ID
externalId string

Eine externe ID (die dem Video beim Upload zugeordnet ist).

Seitenformat
pageSize integer

Die Anzahl der zurückzugebenden Ergebnisse.

Überspringen
skip integer

Die Anzahl der zu überspringenden Ergebnisse (zum Paging verwendet).

Ausgangssprache
sourceLanguage string

Fügen Sie nur Videos mit der angegebenen Quellsprache ein. Sie können mehrere Sprachparameter (z. B. $language=Englisch& Französisch) angeben, um mehrere Sprachen zu durchsuchen. Wenn Sie diesen Parameter leer lassen, werden alle Sprachen durchsucht.

Language
language string

Die Suchsprache. Sie können mehrere Sprachparameter (z. B. $language=Englisch& Französisch) angeben, um mehrere Sprachen zu durchsuchen. Wenn Sie diesen Parameter leer lassen, werden alle Sprachen durchsucht.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Gibt zurück

Videotranskript aktualisieren

Aktualisiert das Transkript des Videos.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Beschriftungssprache
language True string

Die Sprache der Beschriftungen.

Textaufzeichnung
content True string

Das zu aktualisierende Transkript.

Rückruf-URL
callbackUrl string

Eine URL, die benachrichtigt werden soll, wenn die Indizierung abgeschlossen ist. Dabei sollte es sich um eine POST-URL handeln, und der Videoindexer fügt 2 zusätzliche Abfragezeichenfolgenparameter hinzu: ID und Status.

Als Quellsprache festlegen
setAsSourceLanguage boolean

Bestimmt, ob der Sprachparameter als Quellsprache festgelegt werden soll.

Erfolgs-E-Mail senden
sendSuccessEmail boolean

Bestimmt, ob eine Erfolgs-E-Mail nach Abschluss gesendet werden soll.

Videountertitel abrufen

Dieser Vorgang gibt die beim Indizierung des Videos extrahierten Untertitel zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
location True string

Gibt die Azure-Region an, an die der Anruf weitergeleitet werden soll.

Konto-ID
accountId True uuid

Die Konto-ID ist eine GUID (Globally Unique Identifier) für das Konto.

Video-ID
videoId True string

Die Video-ID.

Zugriffstoken
accessToken True string

Ein Kontozugriffstoken mit Leseberechtigungen.

Format
format True string

Das Beschriftungsformat (z. B. vtt).

Beschriftungssprache
language string

Die Sprache der Beschriftungen.

Gibt zurück

Liste der extrahierten Beschriftungen.

Liste der extrahierten Beschriftungen
string

Definitionen

tokenResponse

Das Zugriffstoken.

Das Zugriffstoken.

Zugriffstoken
string

Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2

Name Pfad Typ Beschreibung
Ergebnisse
results array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

Die Suchergebnisse.

nextPage
nextPage Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

UploadResponse

Name Pfad Typ Beschreibung
Video-ID
id string

Die Video-ID.

Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

Name Pfad Typ Beschreibung
Konto-ID
accountId uuid

Die Konto-ID.

Video-ID
id string

Die Video-ID.

Partition
partition string

Die Partition des Videos.

Externe ID
externalId string

Die externe ID, die dem Video zugeordnet ist.

Metadaten
metadata string

Metadaten.

Name
name string

Der Name des Videos.

Description
description string

Die Beschreibung des Videos.

Erstellt
created date-time

Wann das Video erstellt wurde.

Zuletzt geändert
lastModified date-time

Wann das Video zuletzt geändert wurde.

Zuletzt indiziert
lastIndexed date-time

Als das Video zuletzt indiziert wurde.

Datenschutz
privacyMode string

Der Datenschutzmodus des Videos (öffentlich oder privat).

Benutzername
userName string

Der Benutzername des Videobesitzers.

Ist Im Besitz
isOwned boolean

Gibt an, ob das Video dem Benutzer gehört, der den Anruf getätigt hat.

Ist Basis
isBase boolean

Gibt an, ob es sich bei dem Video um ein Basisvideo handelt.

Staat
state string

Der Verarbeitungszustand des Videos. (Hochgeladen / Verarbeitung / verarbeitet / fehlgeschlagen / isoliert).

Verarbeitungsfortschritt
processingProgress string

Fortschrittsprozentsatz des Videos, wenn es verarbeitet wird.

Dauer in Sekunden
durationInSeconds integer

Die Dauer des Videos in Sekunden.

Miniaturansicht Video-ID
thumbnailVideoId string

Die ID des Videos, das die ursprüngliche Miniaturansicht enthält.

Miniaturansichts-ID
thumbnailId uuid

Die Miniaturansichts-ID.

Suchabfragen
searchMatches

Suchabfragen und deren Details (JSON-Zeichenfolge).

Indizierungsvoreinstellung
indexingPreset string

Die Indizierungsvoreinstellung des Videoindexes.

Streamingvoreinstellung
streamingPreset string

Die Streamingvoreinstellung des Videoindexes.

Ausgangssprache
sourceLanguage string

Die Quellsprache des Videos.

Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

Name Pfad Typ Beschreibung
Seitenformat
pageSize integer

Seitengröße der Suchergebnisse.

Überspringen
skip integer

Anzahl der zu überspringenden Ergebnisse (wird für paging verwendet).

Done
done boolean

Gibt an, ob die Suche abgeschlossen ist.

GetIndexResponse

Name Pfad Typ Beschreibung
Konto-ID
accountId uuid

Die Konto-ID.

Video-ID
id string

Die Video-ID.

Videopartition
partition string

Die Partition des Videos.

Name
name string

Der Name des Videos.

Description
description string

Die Beschreibung des Videos.

Benutzername
userName string

Der Benutzername des Videobesitzers.

Erstellt
created date-time

Die Erstellungszeit des Videos.

Datenschutz
privacyMode string

Der Datenschutzmodus des Videos.

Staat
state string

Der Verarbeitungszustand des Videos. (Hochgeladen / Verarbeitung / verarbeitet / fehlgeschlagen / isoliert).

Ist Im Besitz
isOwned boolean

Gibt an, ob das Video einem Benutzer gehört.

Ist bearbeitbar
isEditable boolean

Gibt an, ob die Anforderung zum Abrufen des Videos über ein Token mit Schreibberechtigung verfügte.

Ist Basis
isBase boolean

Gibt an, ob es sich bei dem Video um ein Basisvideo handelt.

Dauer in Sekunden
durationInSeconds integer

Die Dauer des Videos in Sekunden.

Videos Insights
videos array of object

Videosinblicke aus dem Videoindex (JSON-Zeichenfolge).

Videobereiche
videosRanges

Die Bereiche der Videos in diesem Index (JSON-Zeichenfolge).

Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim

Name Pfad Typ Beschreibung
Konto-ID
id uuid

Konto-ID.

Kontoname
name string

Der Kontoname.

Kontospeicherort
location string

Kontospeicherort.

Kontoart
accountType string

Kontoart.

Konto-URL
url string

API-Aufrufe sollten an konto-URL + Kontospeicherort erfolgen.

Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail

Name Pfad Typ Beschreibung
Der Inhaltstyp.
$content-type string

Der Inhaltstyp.

Der Inhalt.
$content string

Der Inhalt.

Schnur

Dies ist der grundlegende Datentyp "string".