Video Indexer (プレビュー)
ビデオから簡単に分析情報を抽出し、アプリケーションをすばやく強化して、検出とエンゲージメントを強化します。 Video Indexer コネクタを使用して、ビデオを分析情報に変換します。
このコネクタは、次の製品とリージョンで使用できます。
| Service | クラス | リージョン |
|---|---|---|
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - 中国リージョンAzure - 米国国防総省 (DoD) |
| コネクタ メタデータ | |
|---|---|
| 発行者 | マイクロソフト |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、キャンバス アプリの Connectors の概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| (外部 ID を使用して) 分析情報ウィジェットの URL を取得する |
この操作は、特定の外部 ID に基づいて、アクセス トークンを含む Cognitive Insights ウィジェットの URL を返します。 |
| アカウントを取得する |
ユーザーのアカウントの詳細を返します。 |
| テキストまたは顔を検索する |
この操作は検索を実行し、結果を返します。 使用可能な場合は、結果内の検索フィルターの一致を返します。 |
| トランスクリプト (VTT) URL を取得する |
この操作は、指定された内訳のキャプションを含む VTT ファイルへの URL を返します。 |
| ビデオとその分析情報を削除する |
この操作により、アップロードされたビデオが削除され、deleteInsights=true の場合は、生成された分析情報も削除されます。 |
| ビデオとインデックスをアップロードする |
この操作により、指定されたビデオがアップロードされ、インデックス作成が開始され、新しいブレークダウン ID が返されます。 |
| ビデオとインデックスをアップロードする (URL を使用) |
この操作により、指定されたビデオがアップロードされ、インデックス作成が開始され、新しいブレークダウン ID が返されます。 |
| ビデオの内訳のインデックスを再作成する |
この操作では、指定された内訳のインデックスが再作成されます。 |
| ビデオの内訳のインデックスを再作成する (外部 ID を使用) |
この操作により、指定された外部 ID のビデオのインデックスが再作成されます。 |
| ビデオの内訳を取得する |
この操作は、すべての分析情報 (トランスクリプト、OCR、ユーザーなど) を含む、特定の内訳の完全な詳細を返します。 |
| プレイヤー ウィジェットの URL を取得する |
この操作は、アクセス トークンを含むプレーヤー ウィジェットへの URL を返します。 |
| 処理状態を取得する |
この操作は、指定されたブレークダウン ID の処理状態を取得し、処理が進行状況を返す場合 (例: 30%)。 |
| 分析情報ウィジェットの URL を取得する |
この操作は、アクセス トークンを含む Cognitive Insights ウィジェットの URL を返します。 |
| 顔名を更新する |
この操作では、指定された顔の名前を更新し、将来のビデオでその顔を認識するように顔モデルをトレーニングします。 |
(外部 ID を使用して) 分析情報ウィジェットの URL を取得する
この操作は、特定の外部 ID に基づいて、アクセス トークンを含む Cognitive Insights ウィジェットの URL を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
外部 ID
|
externalId | True | string |
検索する外部 ID (アップロード時にこのサブスクリプションのビデオに関連付けられています)。 |
|
ウィジェットの種類
|
widgetType | string |
含めるサブウィジェットの種類 (People、Sentiments、Keywords、Search)。 |
戻り値
Cognitive Insights ウィジェットの URL。
- ウェブアドレス
- string
アカウントを取得する
ユーザーのアカウントの詳細を返します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
アカウント ID
|
id | string | |
|
アカウント名
|
name | string |
テキストまたは顔を検索する
この操作は検索を実行し、結果を返します。 使用可能な場合は、結果内の検索フィルターの一致を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Face クエリ
|
face | string |
検索する顔。 |
|
|
テキスト クエリ
|
query | string |
検索するフリー テキスト。 |
|
|
パブリック アカウントの検索
|
searchInPublicAccount | string |
True パブリック アカウントを検索します。 |
|
|
プライバシー
|
privacy | string |
プライベート、組織、またはパブリック。 |
|
|
テキスト スコープ
|
textScope | string |
検索対象のスコープ。 |
|
|
Language
|
language | string |
検索対象。 |
|
|
ビデオ ID
|
id | string |
検索するビデオの内訳 ID。 |
|
|
パーティション
|
partition | string |
検索するパーティション。 |
|
|
Owner
|
owner | string |
検索する所有者。 |
|
|
ページサイズ
|
pageSize | number |
返される結果の数。 |
|
|
スキップ
|
skip | number |
スキップする結果の数 (ページングに使用)。 |
|
|
外部 ID
|
externalId | string |
検索する外部 ID (アップロード時のビデオに関連付けられています)。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
results | array of object | |
|
アカウント ID
|
results.accountId | string |
ビデオをアップロードしたアカウントの。 |
|
ビデオ ID
|
results.id | string |
ビデオとその内訳に関連付けられている ID。 |
|
パーティション
|
results.partition | string |
ビデオのパーティション。 |
|
外部 ID
|
results.externalId | string |
ビデオの外部 ID (アップロード時に指定されたユーザー)。 |
|
メタデータ
|
results.metadata | string |
ビデオのメタデータ。 |
|
名前
|
results.name | string |
ビデオの名前。 |
|
説明
|
results.description | string |
ビデオの説明。 |
|
時間の作成
|
results.createTime | date-time |
ビデオの作成時刻。 |
|
組織
|
results.organization | string |
組織アカウントが属しています。 |
|
プライバシー モード
|
results.privacyMode | string |
組織アカウントが属しています。 |
|
ユーザー名
|
results.userName | string |
ビデオのアカウントのユーザー名。 |
|
所有されている
|
results.isOwned | boolean |
True の 場合は、ビデオがユーザーによって所有されています。 |
|
Is Base
|
results.isBase | boolean |
True の 場合は、ビデオがベース ビデオです。 |
|
状態
|
results.state | string |
アップロード、処理、処理、または失敗。 |
|
処理の進行状況
|
results.processingProgress | string |
状態が処理されている場合のビデオの進行状況の割合。 |
|
期間 (秒)
|
results.durationInSeconds | integer |
ビデオの再生時間 (秒)。 |
|
サムネイル URL
|
results.thumbnailUrl | string |
ビデオのサムネイル URL。 |
|
ユーザーがいいね!
|
results.social.likedByUser | boolean |
True の 場合、ビデオは、ユーザーによって好きになっています。 それ以外の場合は False です。 |
|
いいね!
|
results.social.likes | integer |
ビデオのいいね! |
|
見解
|
results.social.views | integer |
ビデオの再生回数。 |
|
検索の一致
|
results.searchMatches | string |
検索に対する一致の配列と一致の詳細。 |
トランスクリプト (VTT) URL を取得する
この操作は、指定された内訳のキャプションを含む VTT ファイルへの URL を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオとその内訳に関連付けられている ID。 |
|
Language
|
language | string |
テキストの要求された言語。 |
戻り値
ビデオの VTT ファイルの URL。
- ウェブアドレス
- string
ビデオとその分析情報を削除する
この操作により、アップロードされたビデオが削除され、deleteInsights=true の場合は、生成された分析情報も削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオとその内訳に関連付けられている ID。 |
|
Insights を削除する
|
deleteInsights | boolean |
生成された分析情報も削除するかどうか (True または False)。 |
戻り値
- response
- object
ビデオとインデックスをアップロードする
この操作により、指定されたビデオがアップロードされ、インデックス作成が開始され、新しいブレークダウン ID が返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル コンテンツ
|
fileContent | True | binary |
マルチパート形式のビデオ。 |
|
Language
|
language | string |
トランスクリプトを生成するときに使用するビデオの言語。 |
|
|
外部 ID
|
externalId | string |
ビデオに関連付ける外部 ID (後で検索できます)。 |
|
|
メタデータ
|
metadata | string |
ビデオに関連付けるメタデータ (クエリで返されます)。 |
|
|
説明
|
description | string |
ビデオの説明。 |
|
|
パーティション
|
partition | string |
ビデオをパーティション分割するパーティション (特定のパーティションの検索に使用)。 |
|
|
ビデオ名
|
name | True | string |
ビデオ名。 |
|
プライバシー
|
privacy | True | string |
プライベート、組織、またはパブリック。 |
|
コールバック URL
|
callbackUrl | string |
インデックス作成が完了したときに通知する URL。 |
戻り値
ビデオとその内訳に関連付けられている ID。
- response
- videoResponse
ビデオとインデックスをアップロードする (URL を使用)
この操作により、指定されたビデオがアップロードされ、インデックス作成が開始され、新しいブレークダウン ID が返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ URL
|
videoUrl | True | string |
ビデオのパブリック URL。 |
|
Language
|
language | string |
トランスクリプトを生成するときに使用するビデオの言語。 |
|
|
外部 ID
|
externalId | string |
ビデオに関連付ける外部 ID (後で検索できます)。 |
|
|
メタデータ
|
metadata | string |
ビデオに関連付けるメタデータ (クエリで返されます)。 |
|
|
説明
|
description | string |
ビデオの説明。 |
|
|
パーティション
|
partition | string |
ビデオをパーティション分割するパーティション (特定のパーティションの検索に使用)。 |
|
|
ビデオ名
|
name | True | string |
ビデオ名。 |
|
プライバシー
|
privacy | True | string |
プライベート、組織、またはパブリック。 |
|
コールバック URL
|
callbackUrl | string |
インデックス作成が完了したときに通知する URL。 |
戻り値
ビデオとその内訳に関連付けられている ID。
- response
- videoResponse
ビデオの内訳のインデックスを再作成する
この操作では、指定された内訳のインデックスが再作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオの内訳 ID。 |
|
コールバック URL
|
callbackUrl | string |
インデックスの再作成が完了したときに通知する URL。 |
戻り値
- response
- object
ビデオの内訳のインデックスを再作成する (外部 ID を使用)
この操作により、指定された外部 ID のビデオのインデックスが再作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
外部 ID
|
externalId | True | string |
外部 ID (アップロード時にこのサブスクリプションのビデオに関連付けられていた)。 |
|
コールバック URL
|
callbackUrl | string |
インデックスの再作成が完了したときに通知する URL。 |
戻り値
- response
- object
ビデオの内訳を取得する
この操作は、すべての分析情報 (トランスクリプト、OCR、ユーザーなど) を含む、特定の内訳の完全な詳細を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
アップロード API または検索 API によって返される内訳 ID。 |
|
Language
|
language | string |
テキストの言語を要求しました。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アカウント ID
|
accountId | string |
アカウントに関連付けられている一意の ID。 |
|
ビデオ ID
|
id | string |
ビデオとその内訳に関連付けられている一意の ID。 |
|
パーティション
|
partition | string |
ビデオのパーティション。 |
|
名前
|
name | date-time |
ビデオの名前。 |
|
説明
|
description | string |
ビデオの説明。 |
|
ユーザー名
|
userName | string |
ビデオのアカウントのユーザー名。 |
|
時間の作成
|
createTime | date-time |
ビデオの作成時刻。 |
|
組織
|
organization | string |
組織アカウントが属しています。 |
|
プライバシー モード
|
privacyMode | string |
ビデオのプライバシー モード。 |
|
状態
|
state | string |
アップロード、処理、処理、または失敗)。 |
|
所有されている
|
isOwned | boolean |
True の 場合は、ビデオがユーザーによって所有されています。 |
|
Is Base
|
isBase | boolean |
True の 場合は、ビデオがベース ビデオです。 |
|
概要分析情報
|
summarizedInsights | string |
ビデオの内訳から得られた分析情報の概要 |
|
Breakdowns 配列
|
breakdowns | string |
ビデオの内訳の配列。 |
|
ユーザーがいいね!
|
social.likedByUser | boolean |
True の 場合は、ビデオがユーザーによって好きになっています。 それ以外の場合は False です。 |
|
いいね!
|
social.likes | integer |
ビデオのいいね! |
|
見解
|
social.views | integer |
ビデオの再生回数。 |
プレイヤー ウィジェットの URL を取得する
この操作は、アクセス トークンを含むプレーヤー ウィジェットへの URL を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオの内訳 ID。 |
戻り値
プレーヤー ウィジェットの URL。
- ウェブアドレス
- string
処理状態を取得する
この操作は、指定されたブレークダウン ID の処理状態を取得し、処理が進行状況を返す場合 (例: 30%)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオとその内訳に関連付けられている ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
state | string |
アップロード、処理、処理、または失敗。 |
|
進捗
|
progress | string |
状態が処理されている場合のビデオの割合。 |
分析情報ウィジェットの URL を取得する
この操作は、アクセス トークンを含む Cognitive Insights ウィジェットの URL を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオとその内訳に関連付けられている ID。 |
|
ウィジェットの種類
|
widgetType | string |
ユーザー、センチメント、キーワード、または検索。 |
戻り値
Cognitive Insights ウィジェットの URL。
- ウェブアドレス
- string
顔名を更新する
この操作では、指定された顔の名前を更新し、将来のビデオでその顔を認識するように顔モデルをトレーニングします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ビデオ ID
|
id | True | string |
ビデオの内訳 ID。 |
|
Face Id
|
faceId | True | number |
顔 ID (ビデオの json)。 |
|
新しい名前
|
newName | True | string |
顔の新しい名前 ("Unknown #1/2/3..." を使用して匿名にします)。 |
戻り値
- response
- object
定義
videoResponse
オブジェクト
これは型 'object' です。
文字列
これは基本的なデータ型 'string' です。