影片索引器（預覽）
輕鬆從影片中擷取見解，並快速豐富您的應用程式，以增強發現和參與度。 使用視訊索引器連接器將視訊轉換為深入解析。
此連接器適用於以下產品和區域：
| Service | Class | Regions |
|---|---|---|
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure中國地區 - 美國國防部 （DoD） |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有地區 | 可共用 |
預設
適用：所有地區
建立連線的參數。
這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | 說明 | Required |
|---|---|---|---|
| API 金鑰 | 安全字串 | 此 API 的 API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 1200 | 60 秒 |
動作
| 上傳影片和索引 |
這個操作會上傳給定的影片，開始索引，並回傳新的分解 ID。 |
| 上傳影片與索引（使用網址） |
這個操作會上傳給定的影片，開始索引，並回傳新的分解 ID。 |
| 刪除影片及其見解 |
此操作會刪除上傳的影片，若 deleteInsights=true，則同時刪除產生的洞察。 |
| 取得 insights widget 網址 |
此操作會回傳一個網址至認知洞察元件，包括存取權杖。 |
| 取得 Insights 小工具的網址（使用外部 ID） |
此操作會根據給定的外部 ID 回傳一個 URL 到 cognitive insights widget，包括存取權杖。 |
| 取得帳戶 |
回傳使用者帳號的詳細資訊。 |
| 取得影片解析 |
此操作會回傳給定細分的完整細節，包括所有洞察（逐字稿、OCR、人員等）。 |
| 取得成績單（VTT）網址 |
此操作會回傳一個帶有該分類標題的 VTT 檔案的 URL。 |
| 取得玩家小工具的網址 |
此操作會回傳一個 URL，包含存取權杖給玩家小工具。 |
| 取得處理狀態 |
此操作會取得給定分解 ID 的處理狀態，若處理成功，則回傳進度（例如 30%）。 |
| 搜尋文字或字面 |
此操作執行搜尋並回傳結果。 若有，會回傳搜尋篩選器的匹配結果。 |
| 更新人名 |
此作業會更新指定臉部的名稱，並訓練臉部模型在未來的影片中辨識該臉部。 |
| 重新索引影片分解 |
此操作會重新索引給定的分解。 |
| 重新索引影片分解（使用外部識別碼） |
此操作會重新索引該外部 ID 的影片。 |
上傳影片和索引
這個操作會上傳給定的影片，開始索引，並回傳新的分解 ID。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案內容
|
fileContent | True | binary |
影片以多部分形式呈現。 |
|
語言
|
language | string |
影片的語言，用於產生逐字稿。 |
|
|
外部識別碼
|
externalId | string |
一個外部 ID（可稍後搜尋）來關聯影片。 |
|
|
後設資料
|
metadata | string |
要與視訊相關聯的中繼資料（將在查詢中傳回）。 |
|
|
說明
|
description | string |
影片說明。 |
|
|
Partition
|
partition | string |
一個用來分割影片的分割區（用於搜尋特定分割區）。 |
|
|
影片名稱
|
name | True | string |
影片名稱。 |
|
隱私權
|
privacy | True | string |
私人、組織或公共。 |
|
回調網址
|
callbackUrl | string |
一個網址，當索引完成時通知你。 |
傳回
與影片相關的身份及其解析。
- response
- videoResponse
上傳影片與索引（使用網址）
這個操作會上傳給定的影片，開始索引，並回傳新的分解 ID。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片網址
|
videoUrl | True | string |
影片的公開網址。 |
|
語言
|
language | string |
影片的語言，用於產生逐字稿。 |
|
|
外部識別碼
|
externalId | string |
一個外部 ID（可稍後搜尋）來關聯影片。 |
|
|
後設資料
|
metadata | string |
要與視訊相關聯的中繼資料（將在查詢中傳回）。 |
|
|
說明
|
description | string |
影片說明。 |
|
|
Partition
|
partition | string |
一個用來分割影片的分割區（用於搜尋特定分割區）。 |
|
|
影片名稱
|
name | True | string |
影片名稱。 |
|
隱私權
|
privacy | True | string |
私人、組織或公共。 |
|
回調網址
|
callbackUrl | string |
一個網址，當索引完成時通知你。 |
傳回
與影片相關的身份及其解析。
- response
- videoResponse
刪除影片及其見解
此操作會刪除上傳的影片，若 deleteInsights=true，則同時刪除產生的洞察。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
我與影片及其分解產生了關聯。 |
|
刪除洞察
|
deleteInsights | boolean |
是否也要刪除產生的洞察（真或假）。 |
傳回
- response
- object
取得 insights widget 網址
此操作會回傳一個網址至認知洞察元件，包括存取權杖。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
與影片相關的身份及其解析。 |
|
小部件類型
|
widgetType | string |
人、情感、關鍵字或搜尋。 |
傳回
認知洞察小工具的網址。
- 網址
- string
取得 Insights 小工具的網址（使用外部 ID）
此操作會根據給定的外部 ID 回傳一個 URL 到 cognitive insights widget，包括存取權杖。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
外部識別碼
|
externalId | True | string |
一個外部 ID（與此訂閱影片相關，上傳時可搜尋）。 |
|
小部件類型
|
widgetType | string |
需要包含一種子小工具（人物、情感、關鍵字、搜尋）。 |
傳回
認知洞察小工具的網址。
- 網址
- string
取得帳戶
回傳使用者帳號的詳細資訊。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
帳戶 ID
|
id | string | |
|
客戶名稱
|
name | string |
取得影片解析
此操作會回傳給定細分的完整細節，包括所有洞察（逐字稿、OCR、人員等）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
Breakdown ID，由上傳或搜尋 API 回傳。 |
|
語言
|
language | string |
要求文本的語言。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
帳戶 ID
|
accountId | string |
帳號有唯一編號。 |
|
影片識別碼
|
id | string |
與影片及其解析相關的獨特身份。 |
|
Partition
|
partition | string |
影片分割。 |
|
名稱
|
name | date-time |
影片名稱。 |
|
說明
|
description | string |
影片說明。 |
|
使用者名
|
userName | string |
影片帳號的使用者名稱。 |
|
創造時間
|
createTime | date-time |
影片製作時間。 |
|
組織
|
organization | string |
組織帳號屬於 |
|
隱私模式
|
privacyMode | string |
影片的隱私模式。 |
|
State
|
state | string |
上傳、處理、處理或失敗）。 |
|
擁有
|
isOwned | boolean |
如果影片是用戶擁有，那就沒錯。 |
|
是基礎
|
isBase | boolean |
如果影片是基礎影片，那是真的。 |
|
摘要見解
|
summarizedInsights | string |
影片分解中取自見解摘要 |
|
故障陣列
|
breakdowns | string |
影片的各種分解。 |
|
用戶喜歡
|
social.likedByUser | boolean |
如果影片被用戶按讚，那是真的。 否則為 False。 |
|
讚
|
social.likes | integer |
影片按讚數。 |
|
瀏覽次數
|
social.views | integer |
影片觀看次數。 |
取得成績單（VTT）網址
此操作會回傳一個帶有該分類標題的 VTT 檔案的 URL。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
與影片相關的身份及其解析。 |
|
語言
|
language | string |
文本中要求的語言。 |
傳回
影片VTT檔案的網址。
- 網址
- string
取得玩家小工具的網址
此操作會回傳一個 URL，包含存取權杖給玩家小工具。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
影片解析如下。 |
傳回
球員小工具的網址。
- 網址
- string
取得處理狀態
此操作會取得給定分解 ID 的處理狀態，若處理成功，則回傳進度（例如 30%）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
我與影片及其分解產生了關聯。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
State
|
state | string |
已上傳、處理中、處理中，或失敗。 |
|
Progress
|
progress | string |
影片的百分比是狀態正在處理的。 |
搜尋文字或字面
此操作執行搜尋並回傳結果。 若有，會回傳搜尋篩選器的匹配結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
臉部查詢
|
face | string |
一張值得尋找的臉。 |
|
|
文字查詢
|
query | string |
自由文本搜索。 |
|
|
搜尋公開帳號
|
searchInPublicAccount | string |
在公開帳號中看確實如此。 |
|
|
隱私權
|
privacy | string |
私人、組織或公共。 |
|
|
文字範圍
|
textScope | string |
搜尋範圍。 |
|
|
語言
|
language | string |
用來搜尋。 |
|
|
影片識別碼
|
id | string |
影片解析 ID 可搜尋。 |
|
|
Partition
|
partition | string |
要搜尋分割區。 |
|
|
Owner
|
owner | string |
一個需要尋找的主人。 |
|
|
頁面大小
|
pageSize | number |
要傳回的結果數目。 |
|
|
跳過
|
skip | number |
要略過的結果數目 （用於分頁）。 |
|
|
外部 ID
|
externalId | string |
一個外部 ID（與上傳時影片相關）可供搜尋。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
帳戶 ID
|
results.accountId | string |
那個上傳影片的帳號。 |
|
影片識別碼
|
results.id | string |
我與影片及其分解產生了關聯。 |
|
Partition
|
results.partition | string |
影片分割。 |
|
外部識別碼
|
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 |
如果影片是用戶擁有，那就沒錯。 |
|
是基礎
|
results.isBase | boolean |
如果影片是基礎影片，那是真的。 |
|
State
|
results.state | string |
已上傳、處理中、處理中，或失敗。 |
|
處理進度
|
results.processingProgress | string |
如果影片正在處理，進度百分比。 |
|
持續時間（以秒為單位）
|
results.durationInSeconds | integer |
影片長度以秒計。 |
|
縮圖網址
|
results.thumbnailUrl | string |
影片縮圖網址。 |
|
用戶喜歡
|
results.social.likedByUser | boolean |
如果影片被用戶按讚，那是真的。 否則為 False。 |
|
讚
|
results.social.likes | integer |
影片的按讚數。 |
|
瀏覽次數
|
results.social.views | integer |
影片觀看次數。 |
|
搜尋相符項
|
results.searchMatches | string |
搜尋匹配的陣列及匹配細節。 |
更新人名
此作業會更新指定臉部的名稱，並訓練臉部模型在未來的影片中辨識該臉部。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
影片解析如下。 |
|
臉部 ID
|
faceId | True | number |
臉部識別碼（來自影片的 json）。 |
|
新名稱
|
newName | True | string |
臉的新名稱（使用「未知 #1/2/3...」來匿名）。 |
傳回
- response
- object
重新索引影片分解
此操作會重新索引給定的分解。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
影片識別碼
|
id | True | string |
影片解析如下。 |
|
回調網址
|
callbackUrl | string |
一個網址，用來通知重新索引完成。 |
傳回
- response
- object
重新索引影片分解（使用外部識別碼）
此操作會重新索引該外部 ID 的影片。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
外部識別碼
|
externalId | True | string |
一個外部 ID（上傳時與此訂閱影片相關聯）。 |
|
回調網址
|
callbackUrl | string |
一個網址，用來通知重新索引完成。 |
傳回
- response
- object
定義
videoResponse（視頻回應）
物件
這是類型 'object'。
字串
這是基本資料類型「string」。