다음을 통해 공유


Video Indexer(V2)

비디오에서 인사이트를 쉽게 추출하고 애플리케이션을 빠르게 보강하여 검색 및 참여를 향상시킵니다. Video Indexer 커넥터를 사용하여 비디오를 인사이트로 전환합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://vi.microsoft.com

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API의 API 키 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

계정 가져오기

이 작업은 사용자 계정의 세부 정보를 반환합니다.

계정 가져오기

이 작업은 사용자 계정의 세부 정보를 반환합니다.

계정 액세스 토큰 가져오기

계정 액세스 토큰을 가져옵니다(1시간 후에 만료됨).

비디오 검색

이 작업은 텍스트, 키워드 및 시각적 콘텐츠에 대한 검색을 수행합니다.

비디오 나열

이 작업은 계정의 모든 비디오 목록을 가져옵니다.

비디오 다시 인덱싱

이 작업은 지정된 비디오를 다시 인덱싱합니다.

비디오 대본 업데이트

비디오의 대본을 업데이트합니다.

비디오 및 인덱스 업로드

이 작업은 지정된 비디오를 업로드하고 인덱싱을 시작하고 새 비디오 인덱스 ID를 반환합니다. 지원되는 형식은 다음과 https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats같습니다. ).

비디오 삭제

이 작업은 비디오를 인덱싱할 때 찾은 지정된 비디오 및 모든 관련 인사이트를 삭제합니다.

비디오 원본 파일 삭제

이 작업은 비디오 원본 파일을 삭제하지만 비디오가 인덱싱될 때 찾은 인사이트를 삭제하지는 않습니다.

비디오 인덱스 가져오기

이 작업은 비디오 및 해당 인사이트를 가져옵니다.

비디오 축소판 그림 가져오기

비디오의 썸네일 이미지를 가져옵니다.

비디오 캡션 가져오기

이 작업은 비디오가 인덱싱될 때 추출된 캡션을 반환합니다.

얼굴 이름 업데이트

이 작업은 지정된 얼굴의 이름을 업데이트하고 향후 비디오에서 해당 얼굴을 인식하도록 얼굴 모델을 학습시킵니다.

외부 ID로 비디오 ID 가져오기

이 작업은 외부 ID에 해당하는 비디오 ID를 검색합니다.

계정 가져오기

이 작업은 사용자 계정의 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

반환

계정 가져오기

이 작업은 사용자 계정의 세부 정보를 반환합니다.

반환

계정 액세스 토큰 가져오기

계정 액세스 토큰을 가져옵니다(1시간 후에 만료됨).

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

편집 허용
allowEdit True boolean

토큰에 쓰기 권한이 있는지 여부를 확인합니다.

반환

액세스 토큰입니다.

response
tokenResponse

비디오 검색

이 작업은 텍스트, 키워드 및 시각적 콘텐츠에 대한 검색을 수행합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

쿼리 텍스트
query string

검색할 무료 텍스트입니다.

텍스트 범위
textScope string

검색할 텍스트 범위입니다.

개인 정보 보호
privacy string

비디오 개인 정보 보호.

비디오 ID
id string

검색할 비디오 ID입니다.

Partition
partition string

비디오를 검색할 파티션입니다.

소유자
owner string

검색할 비디오 소유자입니다.

얼굴 이름
face string

사람 또는 유명인을 검색합니다.

외부 식별자
externalId string

외부 ID(업로드 시 비디오와 연결됨)

페이지 크기
pageSize integer

반환할 결과 수입니다.

건너뛰기
skip integer

건너뛸 결과 수입니다(페이징에 사용됨).

원본 언어
sourceLanguage string

지정된 소스 언어를 가진 비디오만 포함합니다. 여러 언어 매개 변수(예: $language=영어=프랑스어)를 지정하여 여러 언어를 검색할 수 있습니다. 이 매개 변수를 비워 두면 모든 언어가 검색됩니다.

Language
language string

검색 언어입니다. 여러 언어 매개 변수(예: $language=영어=프랑스어)를 지정하여 여러 언어를 검색할 수 있습니다. 이 매개 변수를 비워 두면 모든 언어가 검색됩니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

반환

비디오 나열

이 작업은 계정의 모든 비디오 목록을 가져옵니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

페이지 크기
pageSize integer

반환할 결과 수입니다.

건너뛰기
skip integer

건너뛸 페이지 수입니다.

반환

비디오 다시 인덱싱

이 작업은 지정된 비디오를 다시 인덱싱합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

쓰기 권한이 있는 계정 액세스 토큰입니다.

인덱싱 사전 설정
indexingPreset string

사용할 인덱싱 사전 설정입니다.

스트리밍 사전 설정
streamingPreset string

사용할 스트리밍 사전 설정입니다.

콜백 URL
callbackUrl string

인덱싱이 완료되면 알릴 URL입니다. POST URL이어야 하며 Video Indexer는 2개 추가 쿼리 문자열 매개 변수인 ID 및 상태를 추가합니다.

Priority
priority string

인덱스 우선 순위(낮음, 보통 및 높음). 유료 지역에서만 사용할 수 있습니다.

브랜드 범주
brandsCategories string

쉼표로 구분된 브랜드 범주 목록입니다. 비디오 인덱서는 인덱싱할 때만 이러한 범주를 고려합니다. 지정하지 않으면 모든 브랜드가 사용됩니다.

원본 언어
sourceLanguage string

대본을 생성할 때 사용할 비디오의 원본 언어로 설정할 언어입니다.

비디오 대본 업데이트

비디오의 대본을 업데이트합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

캡션 언어
language True string

캡션의 언어입니다.

대본
content True string

업데이트할 대본입니다.

콜백 URL
callbackUrl string

인덱싱이 완료되면 알릴 URL입니다. POST URL이어야 하며 Video Indexer는 2개 추가 쿼리 문자열 매개 변수인 ID 및 상태를 추가합니다.

원본 언어로 설정
setAsSourceLanguage boolean

언어 매개 변수를 원본 언어로 설정해야 하는지 여부를 결정합니다.

성공 이메일 보내기
sendSuccessEmail boolean

완료 시 성공 이메일을 보낼지 여부를 결정합니다.

비디오 및 인덱스 업로드

이 작업은 지정된 비디오를 업로드하고 인덱싱을 시작하고 새 비디오 인덱스 ID를 반환합니다. 지원되는 형식은 다음과 https://docs.microsoft.com/azure/media-services/media-services-media-encoder-standard-formats같습니다. ).

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

액세스 토큰
accessToken True string

쓰기 권한이 있는 계정 액세스 토큰입니다.

비디오 이름
name True string

비디오의 제목입니다.

Description
description string

비디오 설명입니다.

Partition
partition string

비디오를 검색할 파티션입니다.

외부 식별자
externalId string

외부 ID(업로드 시 비디오와 연결됨)

콜백 URL
callbackUrl string

인덱싱이 완료되면 알릴 URL입니다. POST 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
priority string

인덱스 우선 순위(낮음, 보통 및 높음). 유료 지역에서만 사용할 수 있습니다.

브랜드 범주
brandsCategories string

쉼표로 구분된 브랜드 범주 목록입니다. 비디오 인덱서는 인덱싱할 때만 이러한 범주를 고려합니다. 지정하지 않으면 모든 브랜드가 사용됩니다.

반환

비디오 삭제

이 작업은 비디오를 인덱싱할 때 찾은 지정된 비디오 및 모든 관련 인사이트를 삭제합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

쓰기 권한이 있는 계정 액세스 토큰입니다.

비디오 원본 파일 삭제

이 작업은 비디오 원본 파일을 삭제하지만 비디오가 인덱싱될 때 찾은 인사이트를 삭제하지는 않습니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

쓰기 권한이 있는 계정 액세스 토큰입니다.

비디오 인덱스 가져오기

이 작업은 비디오 및 해당 인사이트를 가져옵니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

캡션 언어
language string

캡션의 언어입니다.

반환

비디오 축소판 그림 가져오기

비디오의 썸네일 이미지를 가져옵니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

썸네일 ID
thumbnailId True uuid

썸네일 ID입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

반환

비디오 캡션 가져오기

이 작업은 비디오가 인덱싱될 때 추출된 캡션을 반환합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

포맷
format True string

캡션 형식(예: vtt)입니다.

캡션 언어
language string

캡션의 언어입니다.

반환

추출된 캡션 목록입니다.

추출된 캡션 목록
string

얼굴 이름 업데이트

이 작업은 지정된 얼굴의 이름을 업데이트하고 향후 비디오에서 해당 얼굴을 인식하도록 얼굴 모델을 학습시킵니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

비디오 ID
videoId True string

비디오 ID입니다.

얼굴 ID
faceId True integer

얼굴 ID입니다.

액세스 토큰
accessToken True string

쓰기 권한이 있는 계정 액세스 토큰입니다.

새 얼굴 이름
newName True string

얼굴의 새 이름입니다.

외부 ID로 비디오 ID 가져오기

이 작업은 외부 ID에 해당하는 비디오 ID를 검색합니다.

매개 변수

Name 필수 형식 Description
위치
location True string

호출을 라우팅해야 하는 Azure 지역을 나타냅니다.

계정 ID
accountId True uuid

계정 ID는 계정에 대한 GUID(Globally Unique Identifier)입니다.

외부 식별자
externalId True string

외부 ID입니다.

액세스 토큰
accessToken True string

읽기 권한이 있는 계정 액세스 토큰입니다.

반환

비디오 ID입니다.

비디오 ID
string

정의

tokenResponse

액세스 토큰입니다.

액세스 토큰입니다.

액세스 토큰
string

Microsoft.VideoIndexer.Common.ContractsV2.PlaylistSearchResultV2

Name 경로 형식 Description
Results
results array of Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

검색 결과입니다.

nextPage
nextPage Microsoft.VideoIndexer.Common.ContractsV2.SearchPage

UploadResponse

Name 경로 형식 Description
비디오 ID
id string

비디오 ID입니다.

Microsoft.VideoIndexer.Common.ContractsV2.SinglePlaylistSearchResultV2

Name 경로 형식 Description
계정 ID
accountId uuid

계정 ID입니다.

비디오 ID
id string

비디오 ID입니다.

Partition
partition string

비디오의 파티션입니다.

외부 식별자
externalId string

비디오와 연결된 외부 ID입니다.

메타데이터
metadata string

메타데이터.

이름
name string

비디오의 이름입니다.

Description
description string

비디오에 대한 설명입니다.

생성됨
created date-time

비디오를 만들 때입니다.

마지막으로 수정한 날짜
lastModified date-time

비디오가 마지막으로 수정된 경우입니다.

마지막 인덱싱됨
lastIndexed date-time

비디오가 마지막으로 인덱싱된 경우입니다.

개인 정보 보호
privacyMode string

비디오의 개인 정보 모드(퍼블릭 또는 프라이빗)입니다.

사용자 이름
userName string

비디오 소유자의 사용자 이름입니다.

소유됨
isOwned boolean

통화를 한 사용자가 비디오를 소유하는지 여부를 나타냅니다.

Is Base
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

Name 경로 형식 Description
페이지 크기
pageSize integer

검색 결과의 페이지 크기입니다.

건너뛰기
skip integer

건너뛸 결과 수입니다(페이징에 사용됨).

완료
done boolean

검색이 완료되었는지 여부를 나타냅니다.

GetIndexResponse

Name 경로 형식 Description
계정 ID
accountId uuid

계정 ID입니다.

비디오 ID
id string

비디오 ID입니다.

비디오 파티션
partition string

비디오의 파티션입니다.

이름
name string

비디오의 이름입니다.

Description
description string

비디오에 대한 설명입니다.

사용자 이름
userName string

비디오 소유자의 사용자 이름입니다.

생성됨
created date-time

비디오의 생성 시간입니다.

개인 정보 보호
privacyMode string

비디오의 개인 정보 모드입니다.

state string

비디오의 처리 상태입니다. (업로드/처리/처리됨/실패/격리됨).

소유됨
isOwned boolean

사용자가 비디오를 소유하는지 여부를 나타냅니다.

편집 가능
isEditable boolean

비디오 가져오기 요청에 쓰기 권한이 있는 토큰이 있는지 여부입니다.

Is Base
isBase boolean

비디오가 기본 비디오인지 여부를 나타냅니다.

기간(초)
durationInSeconds integer

비디오의 기간(초)입니다.

Videos Insights
videos array of object

비디오 인덱스(json 문자열)에서 가져온 비디오 인사이트입니다.

비디오 범위
videosRanges

이 인덱스에 있는 비디오의 범위(json 문자열)입니다.

Microsoft.VideoIndexer.Common.ContractsV2.AccountContractSlim

Name 경로 형식 Description
계정 ID
id uuid

계정 ID입니다.

어카운트 이름
name string

계정 이름입니다.

계정 위치
location string

계정 위치입니다.

계정 유형
accountType string

계정 유형입니다.

계정 URL
url string

계정 URL + 계정 위치에 대한 API 호출을 수행해야 합니다.

Microsoft.VideoIndexer.Common.ContractsV2.ThumbNail

Name 경로 형식 Description
content-type입니다.
$content-type string

content-type입니다.

콘텐츠입니다.
$content string

콘텐츠입니다.

문자열

기본 데이터 형식 'string'입니다.