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 |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | 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 |
トークンに書き込みアクセス許可があるかどうかを指定します。 |
戻り値
アクセス トークン。
取引先企業を取得する
この操作を実行すると、ユーザーの取引先企業の詳細が返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
場所
|
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
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 + アカウントの場所に対して行う必要があります。 |
文字列
これは基本的なデータ型 '文字列' です。