Video Indexer (V2)

ビデオからインサイトを簡単に抽出し、アプリケーションをすばやくエンリッチさせて、検出とエンゲージメントを強化します。 Video Indexer コネクタを使用して、ビデオをインサイトに変えます。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
コネクタ メタデータ
公開元 Microsoft
Web サイト https://vi.microsoft.com

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
API キー securestring この API の API キー True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

ビデオ インデックスを取得する

この操作により、ビデオとそのインサイトが取得されます。

ビデオ キャプションを取得する

この操作を実行すると、ビデオのインデックス作成時に抽出されたキャプションが返されます。

ビデオ サムネイルを取得する

ビデオのサムネイル画像を取得します。

ビデオ ソース ファイルを削除する

この操作により、ビデオ ソース ファイルは削除されますが、ビデオのインデックス作成時に見つかったインサイトは削除されません。

ビデオとインデックスをアップロードする

この操作により、指定されたビデオがアップロードされ、そのインデックス作成が開始され、新しいビデオ インデックス ID が返されます。 サポートされている形式はここに一覧表示されています: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats)。

ビデオのトランスクリプトを更新する

ビデオのトランスクリプトを更新します。

ビデオの再インデックス

この操作により、指定されたビデオの再インデックスが実行されます。

ビデオを一覧表示する

この操作より、取引先企業のすべてのビデオの一覧が取得されます。

ビデオを削除する

この操作により、指定されたビデオと、ビデオのインデックス作成時に見つかったすべての関連するインサイトが削除されます。

ビデオを検索する

この操作により、テキスト、キーワード、およびビジュアル コンテンツの検索が実行されます。

取引先企業のアクセス トークンを取得する

取引先企業のアクセス トークンを取得します (有効期限は 1 時間)。

取引先企業を取得する

この操作を実行すると、ユーザーの取引先企業の詳細が返されます。

取引先企業を取得する

この操作を実行すると、ユーザーの取引先企業の詳細が返されます。

外部 ID でビデオ ID を取得する

この操作により、外部 ID に対応するビデオ ID が取得されます。

顔の名前を更新する

この操作により、指定された顔の名前を更新し、将来のビデオでその顔を認識するように顔モデルをトレーニングできます。

ビデオ インデックスを取得する

この操作により、ビデオとそのインサイトが取得されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

キャプションの言語
language string

キャプションの言語。

戻り値

本文​​
GetIndexResponse

ビデオ キャプションを取得する

この操作を実行すると、ビデオのインデックス作成時に抽出されたキャプションが返されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

書式
format True string

キャプションの形式 (例: VTT)。

キャプションの言語
language string

キャプションの言語。

戻り値

展開されたキャプションのリストです。

展開されたキャプションのリスト
string

ビデオ サムネイルを取得する

ビデオのサムネイル画像を取得します。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

サムネイル ID
thumbnailId True uuid

サムネイル ID。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

戻り値

応答
string

ビデオ ソース ファイルを削除する

この操作により、ビデオ ソース ファイルは削除されますが、ビデオのインデックス作成時に見つかったインサイトは削除されません。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

書き込みアクセス許可を持つ取引先企業のアクセス トークン。

ビデオとインデックスをアップロードする

この操作により、指定されたビデオがアップロードされ、そのインデックス作成が開始され、新しいビデオ インデックス ID が返されます。 サポートされている形式はここに一覧表示されています: https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats)。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

アクセス トークン
accessToken True string

書き込みアクセス許可を持つ取引先企業のアクセス トークン。

ビデオ名
name True string

ビデオのタイトル。

内容
description string

ビデオの説明。

パーティション
partition string

ビデオを検索するためのパーティション。

外部 ID
externalId string

外部 ID (アップロード時にビデオに関連付けられています)。

コールバック URL
callbackUrl string

インデックスが完了したときに通知する URL。 投稿先 URLを指定する必要があり、Video Indexer は、次の 2 つの追加クエリ文字列パラメーターを追加します: ID と状態です。

メタデータ
metadata string

ビデオに関連付けるメタデータ (クエリで返されます)。

ビデオの言語
language string

トランスクリプトを生成するときに使用されるビデオの言語。

ビデオの URL
videoUrl string

ビデオ/オーディオ ファイルの公開 URL (URL エンコード済み)。 指定しない場合、ファイルはマルチパート/形式の本文コンテンツとして渡す必要があります。

ファイル名
fileName string

アップロードされたファイル名。

インデックス作成プリセット
indexingPreset string

使用するインデックス作成プリセット。

ストリーミング プリセット
streamingPreset string

使用するストリーミング プリセット。

言語モデル ID
linguisticModelId string

'言語モデルの作成' の呼び出しによって受信済みとして指定される言語モデル ID。

プライバシー​
privacy string

ビデオのプライバシー。

外部 URL
externalUrl string

ビデオに関連付ける外部 URL (後で検索できます)。

本文​​
body file

ビデオ URL を指定しない場合、ファイルはマルチパート/形式の本文コンテンツとして渡す必要があります。

資産 ID
assetId string

Azure Media Services の資産 ID。接続した Azure Media Services アカウントの既存の資産からインデックスを作成するために使用されます。 (有料のみ)。

優先順位
priority string

インデックスの優先順位 (低、標準、高)。 有料地域のみで使用できます。

ブランド カテゴリ
brandsCategories string

カンマによって区切られたブランド カテゴリの一覧。 Video Indexer は、インデックス作成時にこれらのカテゴリのみを考慮に入れます。 指定がない場合はすべてのブランドが使用されます。

戻り値

本文​​
UploadResponse

ビデオのトランスクリプトを更新する

ビデオのトランスクリプトを更新します。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

キャプションの言語
language True string

キャプションの言語。

トランスクリプト
content True string

更新するトランスクリプト。

コールバック URL
callbackUrl string

インデックスが完了したときに通知する URL。 投稿先 URLを指定する必要があり、Video Indexer は、次の 2 つの追加クエリ文字列パラメーターを追加します: ID と状態です。

ソース言語として設定する
setAsSourceLanguage boolean

言語パラメーターをソース言語として設定するかどうかを指定します。

成功メールを送信する
sendSuccessEmail boolean

完了時に成功メールを送信するかどうかを指定します。

ビデオの再インデックス

この操作により、指定されたビデオの再インデックスが実行されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

書き込みアクセス許可を持つ取引先企業のアクセス トークン。

インデックス作成プリセット
indexingPreset string

使用するインデックス作成プリセット。

ストリーミング プリセット
streamingPreset string

使用するストリーミング プリセット。

コールバック URL
callbackUrl string

インデックスが完了したときに通知する URL。 投稿先 URLを指定する必要があり、Video Indexer は、次の 2 つの追加クエリ文字列パラメーターを追加します: ID と状態です。

優先順位
priority string

インデックスの優先順位 (低、標準、高)。 有料地域のみで使用できます。

ブランド カテゴリ
brandsCategories string

カンマによって区切られたブランド カテゴリの一覧。 Video Indexer は、インデックス作成時にこれらのカテゴリのみを考慮に入れます。 指定がない場合はすべてのブランドが使用されます。

ソース言語
sourceLanguage string

トランスクリプトを生成するときに使用される、ビデオのソース言語として設定される言語。

ビデオを一覧表示する

この操作より、取引先企業のすべてのビデオの一覧が取得されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

ページ サイズ
pageSize integer

返される結果の数。

スキップする
skip integer

スキップするページ数。

戻り値

ビデオを削除する

この操作により、指定されたビデオと、ビデオのインデックス作成時に見つかったすべての関連するインサイトが削除されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

アクセス トークン
accessToken True string

書き込みアクセス許可を持つ取引先企業のアクセス トークン。

ビデオを検索する

この操作により、テキスト、キーワード、およびビジュアル コンテンツの検索が実行されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

クエリ テキスト
query string

検索する自由書式。

テキスト スコープ
textScope string

検索するテキスト スコープ。

プライバシー​
privacy string

ビデオのプライバシー。

ビデオ ID
id string

検索するビデオ ID。

パーティション
partition string

ビデオを検索するためのパーティション。

担当者
owner string

検索するビデオ担当者。

顔の名前
face string

ユーザーまたは著名人を検索します。

外部 ID
externalId string

外部 ID (アップロード時にビデオに関連付けられています)。

ページ サイズ
pageSize integer

返される結果の数。

スキップする
skip integer

スキップする結果の数 (ページングで使用されます)。

ソース言語
sourceLanguage string

指定されたソース言語のビデオのみが含まれます。 複数の言語パラメーター (例: $language=English&language=French) を指定して複数の言語を検索できます。 このパラメーターを空白のままにすると、すべての言語が検索されます。

言語
language string

検索言語。 複数の言語パラメーター (例: $language=English&language=French) を指定して複数の言語を検索できます。 このパラメーターを空白のままにすると、すべての言語が検索されます。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

戻り値

取引先企業のアクセス トークンを取得する

取引先企業のアクセス トークンを取得します (有効期限は 1 時間)。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

編集を許可する
allowEdit True boolean

トークンに書き込みアクセス許可があるかどうかを指定します。

戻り値

アクセス トークン。

応答
tokenResponse

取引先企業を取得する

この操作を実行すると、ユーザーの取引先企業の詳細が返されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

戻り値

取引先企業を取得する

この操作を実行すると、ユーザーの取引先企業の詳細が返されます。

戻り値

外部 ID でビデオ ID を取得する

この操作により、外部 ID に対応するビデオ ID が取得されます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

外部 ID
externalId True string

外部 ID。

アクセス トークン
accessToken True string

読み取りアクセス許可を持つ取引先企業のアクセス トークン。

戻り値

ビデオの ID。

ビデオ ID
string

顔の名前を更新する

この操作により、指定された顔の名前を更新し、将来のビデオでその顔を認識するように顔モデルをトレーニングできます。

パラメーター

名前 キー 必須 説明
場所
location True string

呼び出しのルーティング先となる Azure リージョンを示します。

取引先企業 ID
accountId True uuid

取引先企業 ID は、取引先企業のグローバル一意識別子 (GUID) です。

ビデオ ID
videoId True string

ビデオの ID。

顔 ID
faceId True integer

顔 ID。

アクセス トークン
accessToken True string

書き込みアクセス許可を持つ取引先企業のアクセス トークン。

新しい顔の名前
newName True string

新しい顔の名前。

定義

tokenResponse

アクセス トークン。

アクセス トークン。

アクセス トークン
string

Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2

名前 パス 説明
結果​​
results array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

検索結果。

nextPage
nextPage Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

UploadResponse

名前 パス 説明
ビデオ ID
id string

ビデオの ID。

Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

名前 パス 説明
取引先企業 ID
accountId uuid

取引先企業 ID。

ビデオ ID
id string

ビデオの ID。

パーティション
partition string

ビデオのパーティション。

外部 ID
externalId string

ビデオに関連付けられた外部 ID。

メタデータ
metadata string

メタデータ。

件名
name string

ビデオの名前。

内容
description string

ビデオの説明。

作成日
created date-time

ビデオが作成されたとき。

最終修正日
lastModified date-time

ビデオが最後に修正されたとき。

最後のインデックス作成
lastIndexed date-time

ビデオが最後にインデックス作成されたとき。

プライバシー​
privacyMode string

ビデオのプライバシー モード (公開または非公開)。

ユーザー名
userName string

ビデオ担当者のユーザー名。

所有済み
isOwned boolean

ビデオが呼び出したユーザーによって所有されているかどうかを示します。

基本
isBase boolean

ビデオが基本ビデオであるかどうかを示します。

完了状態
state string

ビデオの処理中の状態。 (アップロード済み / 処理中 / 処理済み / 失敗 / 検査済み)。

処理の進捗状況
processingProgress string

処理中の場合のビデオの進捗率。

期間 (秒単位)
durationInSeconds integer

ビデオの期間 (秒単位)。

サムネイル動画 ID
thumbnailVideoId string

元のサムネイルを含む動画の ID。

サムネイル ID
thumbnailId uuid

サムネイル ID。

一致を検索する
searchMatches

一致および詳細を検索します (JSON 文字列)。

インデックス作成プリセット
indexingPreset string

ビデオ インデックスのインデックス作成プリセット。

ストリーミング プリセット
streamingPreset string

ビデオ インデックスのストリーミング プリセット。

ソース言語
sourceLanguage string

ビデオのソース言語。

Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

名前 パス 説明
ページ サイズ
pageSize integer

検索結果のページ サイズ。

スキップする
skip integer

スキップする結果の数 (ページングで使用されます)。

完了
done boolean

検索が完了したかどうかを示します。

GetIndexResponse

名前 パス 説明
取引先企業 ID
accountId uuid

取引先企業 ID。

ビデオ ID
id string

ビデオの ID。

ビデオ パーティション
partition string

ビデオのパーティション。

件名
name string

ビデオの名前。

内容
description string

ビデオの説明。

ユーザー名
userName string

ビデオ担当者のユーザー名。

作成日
created date-time

ビデオの作成日。

プライバシー​
privacyMode string

ビデオのプライバシー モード。

完了状態
state string

ビデオの処理中の状態。 (アップロード済み / 処理中 / 処理済み / 失敗 / 検査済み)。

所有済みである
isOwned boolean

ビデオがユーザーによって所有されているかどうかを示します。

編集可能である
isEditable boolean

ビデオを取得する要求に書き込みアクセス許可のあるトークンがあるかどうか。

基本である
isBase boolean

ビデオが基本ビデオであるかどうかを示します。

期間 (秒単位)
durationInSeconds integer

ビデオの期間 (秒単位)。

ビデオ インサイト
videos array of object

ビデオ インデックスから取得されたビデオ インサイト (JSON 文字列)。

ビデオ範囲
videosRanges

このインデックスのビデオの範囲 (JSON 文字列)。

Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim

名前 パス 説明
取引先企業 ID
id uuid

取引先企業 ID。

アカウント名
name string

アカウント名。

アカウントの場所
location string

アカウントの場所。

アカウントの種類
accountType string

アカウントの種類。

アカウント URL
url string

API 呼び出しは、アカウント URL + アカウントの場所に対して行う必要があります。

文字列

これは基本的なデータ型 '文字列' です。