Индексатор видео (предварительная версия)

С легкостью извлеките аналитические сведения из видео и быстро обогатите приложения, чтобы улучшить обнаружение и взаимодействие. Используйте соединитель Индексатора видео, чтобы превратить видео в аналитические сведения.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Класс	Регионы
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure Для Китая      - Министерство обороны США (DoD)

Метаданные соединителя
Publisher	Корпорация Майкрософт

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Доступный для общего пользования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре Connectors для приложений холста — Power Apps | Microsoft Docs

Имя	Тип	Описание	Обязательный
Ключ API	securestring	Ключ API для этого API	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	1200	60 секунд

Действия

Обновление имени лица	Эта операция обновляет имя данного лица и обучает модель лица, чтобы распознать это лицо в будущих видео.
Отправка видео и индекс	Эта операция отправляет заданное видео, начинает индексировать его и возвращает новый идентификатор разбивки.
Отправка видео и индекса (с помощью URL-адреса)	Эта операция отправляет заданное видео, начинает индексировать его и возвращает новый идентификатор разбивки.
Переиндексирование видео (с помощью внешнего идентификатора)	Эта операция переиндексирует видео заданного внешнего идентификатора.
Поиск текста или лица	Эта операция выполняет поиск и возвращает результаты. При наличии возвращает совпадения фильтров поиска в результатах.
Получение URL-адреса мини-приложения аналитики	Эта операция возвращает URL-адрес мини-приложения Cognitive Insights, включая маркер доступа.
Получение URL-адреса мини-приложения аналитики (с помощью внешнего идентификатора)	Эта операция возвращает URL-адрес мини-приложения Cognitive Insights, включая маркер доступа на основе заданного внешнего идентификатора.
Получение URL-адреса мини-приложения проигрывателя	Эта операция возвращает URL-адрес мини-приложения проигрывателя, включая маркер доступа.
Получение URL-адреса расшифровки (VTT)	Эта операция возвращает URL-адрес VTT-файла с заголовками заданной разбивки.
Получение разбивки видео	Эта операция возвращает полные сведения о заданной разбивке, включая все аналитические сведения (расшифровка, OCR, люди и т. д.).
Получение состояния обработки	Эта операция извлекает состояние обработки заданного идентификатора разбивки и при обработке возвращает ход выполнения (например, 30%).
Получение учетных записей	Возвращает сведения о учетных записях пользователя.
Разбивка видео повторного индекса	Эта операция переиндексирует заданный разрыв.
Удаление видео и его аналитических сведений	Эта операция удаляет отправленное видео и при удаленииInsights=true, а затем удаляет созданные аналитические сведения.

Обновление имени лица

Идентификатор операции:

UpdateFaceName

Эта операция обновляет имя данного лица и обучает модель лица, чтобы распознать это лицо в будущих видео.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор разбивки видео.
Идентификатор лица	faceId	True	number	Идентификатор лица (из json видео).
Новое имя	newName	True	string	Новое имя лица (используйте "Неизвестное#1/2/3...", чтобы сделать анонимным).

Возвращаемое значение

response

object

Отправка видео и индекс

Идентификатор операции:

UploadVideoFileContent

Эта операция отправляет заданное видео, начинает индексировать его и возвращает новый идентификатор разбивки.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Содержимое файла	fileContent	True	binary	Видео в многопартийной форме.
Язык	language		string	Язык видео, используемый при создании расшифровки.
Внешний идентификатор	externalId		string	Внешний идентификатор, связанный с видео (можно выполнить поиск позже).
Метаданные	metadata		string	Метаданные для связи с видео (будут возвращены в запросах).
Описание	description		string	Описание видео.
Partition	partition		string	Секция для секционирования видео по (используется для поиска определенной секции).
Имя видео	name	True	string	Имя видео.
Конфиденциальность	privacy	True	string	Частный, организационный или общедоступный.
URL-адрес обратного вызова	callbackUrl		string	URL-адрес для уведомления о завершении индексирования.

Возвращаемое значение

Идентификатор, связанный с видео и его разбивкой.

response

videoResponse

Отправка видео и индекса (с помощью URL-адреса)

Идентификатор операции:

UploadVideo

Эта операция отправляет заданное видео, начинает индексировать его и возвращает новый идентификатор разбивки.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес видео	videoUrl	True	string	Общедоступный URL-адрес видео.
Язык	language		string	Язык видео, используемый при создании расшифровки.
Внешний идентификатор	externalId		string	Внешний идентификатор, связанный с видео (можно выполнить поиск позже).
Метаданные	metadata		string	Метаданные для связи с видео (будут возвращены в запросах).
Описание	description		string	Описание видео.
Partition	partition		string	Секция для секционирования видео по (используется для поиска определенной секции).
Имя видео	name	True	string	Имя видео.
Конфиденциальность	privacy	True	string	Частный, организационный или общедоступный.
URL-адрес обратного вызова	callbackUrl		string	URL-адрес для уведомления о завершении индексирования.

Возвращаемое значение

Идентификатор, связанный с видео и его разбивкой.

response

videoResponse

Переиндексирование видео (с помощью внешнего идентификатора)

Идентификатор операции:

Re-IndexBreakdownByExternalId

Эта операция переиндексирует видео заданного внешнего идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Внешний идентификатор	externalId	True	string	Внешний идентификатор (связанный с видео этой подписки при отправке).
URL-адрес обратного вызова	callbackUrl		string	URL-адрес для уведомления о завершении повторного индексирования.

Возвращаемое значение

response

object

Поиск текста или лица

Идентификатор операции:

Search

Эта операция выполняет поиск и возвращает результаты. При наличии возвращает совпадения фильтров поиска в результатах.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Запрос лиц	face		string	Лицо для поиска.
Текстовый запрос	query		string	Бесплатный текст для поиска.
Поиск общедоступной учетной записи	searchInPublicAccount		string	Значение true для просмотра в общедоступной учетной записи.
Конфиденциальность	privacy		string	Частный, организационный или общедоступный.
Область текста	textScope		string	Область поиска.
Язык	language		string	Поиск в.
Идентификатор видео	id		string	Идентификатор разбивки видео для поиска.
Partition	partition		string	Секционирование для поиска.
Owner	owner		string	Владелец для поиска.
Размер страницы	pageSize		number	Количество возвращаемых результатов.
Пропустить	skip		number	Количество пропускаемых результатов (используется для разбиения по страницам).
Внешний идентификатор	externalId		string	Внешний идентификатор для поиска (связанного с видео при отправке).

Возвращаемое значение

Имя	Путь	Тип	Описание
Results	results	array of object
Идентификатор учетной записи	results.accountId	string	Учетная запись, передаваемая видео.
Идентификатор видео	results.id	string	Идентификатор, связанный с видео и его разбивкой.
Partition	results.partition	string	Раздел видео.
Внешний идентификатор	results.externalId	string	Внешний идентификатор видео (пользователь, предоставленный при отправке).
Метаданные	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, если видео принадлежит пользователю.
База	results.isBase	boolean	Значение true, если видео является базовым видео.
Государство	results.state	string	Отправка, обработка, обработка или сбой.
Ход обработки	results.processingProgress	string	Процент хода выполнения видео, если состояние обрабатывается.
Длительность в секундах	results.durationInSeconds	integer	Длительность видео в секундах.
URL-адрес эскиза	results.thumbnailUrl	string	URL-адрес эскиза видео.
Нравится пользователю	results.social.likedByUser	boolean	Значение true, если видео понравилось пользователю. В противном случае - ложь.
Отметки "Мне нравится"	results.social.likes	integer	Количество нравится видео.
Views	results.social.views	integer	Количество представлений видео.
Поиск совпадений	results.searchMatches	string	Массив совпадений с поиском и подробными сведениями о совпадениях.

Получение URL-адреса мини-приложения аналитики

Идентификатор операции:

GetInsightsWidgetUrl

Эта операция возвращает URL-адрес мини-приложения Cognitive Insights, включая маркер доступа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор, связанный с видео и его разбивкой.
Тип мини-приложения	widgetType		string	Люди, тональность, ключевые слова или поиск.

Возвращаемое значение

Url-адрес мини-приложения Cognitive Insights.

URL-адрес

string

Получение URL-адреса мини-приложения аналитики (с помощью внешнего идентификатора)

Идентификатор операции:

GetInsightsWidgetUrlByExternalId

Эта операция возвращает URL-адрес мини-приложения Cognitive Insights, включая маркер доступа на основе заданного внешнего идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Внешний идентификатор	externalId	True	string	Внешний идентификатор для поиска (связанного с видео этой подписки при отправке).
Тип мини-приложения	widgetType		string	Тип вложенных мини-приложений для включения (люди, тональности, ключевые слова, поиск).

Возвращаемое значение

Url-адрес мини-приложения Cognitive Insights.

URL-адрес

string

Получение URL-адреса мини-приложения проигрывателя

Идентификатор операции:

GetPlayerWidgetUrl

Эта операция возвращает URL-адрес мини-приложения проигрывателя, включая маркер доступа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор разбивки видео.

Возвращаемое значение

URL-адрес мини-приложения проигрывателя.

URL-адрес

string

Получение URL-адреса расшифровки (VTT)

Идентификатор операции:

GetVttUrl

Эта операция возвращает URL-адрес VTT-файла с заголовками заданной разбивки.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор, связанный с видео и его разбивкой.
Язык	language		string	Запрошенный язык текста.

Возвращаемое значение

URL-адрес VTT-файла видео.

URL-адрес

string

Получение разбивки видео

Идентификатор операции:

GetBreakdown

Эта операция возвращает полные сведения о заданной разбивке, включая все аналитические сведения (расшифровка, OCR, люди и т. д.).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор разбивки, возвращаемый API отправки или поиска.
Язык	language		string	Запрошенный язык текста.

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор учетной записи	accountId	string	Уникальный идентификатор, связанный с учетной записью.
Идентификатор видео	id	string	Уникальный идентификатор, связанный с видео и его разбивкой.
Partition	partition	string	Раздел видео.
Имя	name	date-time	Имя видео.
Описание	description	string	Описание видео.
Имя пользователя	userName	string	Имя пользователя учетной записи видео.
Время создания	createTime	date-time	Время создания видео.
Предприятие	organization	string	Учетная запись организации принадлежит.
Режим конфиденциальности	privacyMode	string	Режим конфиденциальности видео.
Государство	state	string	Отправка, обработка, обработка или сбой).
Принадлежит	isOwned	boolean	Значение True, если видео принадлежит пользователю.
База	isBase	boolean	Значение true, если видео является базовым видео.
Сводка аналитических сведений	summarizedInsights	string	Сводка аналитических сведений, полученных из разбивки видео
Массив разбивки	breakdowns	string	Массив разбивки видео.
Нравится пользователю	social.likedByUser	boolean	Значение true, если видео понравилось пользователю. В противном случае - ложь.
Отметки "Мне нравится"	social.likes	integer	Количество нравится на видео.
Views	social.views	integer	Количество представлений видео.

Получение состояния обработки

Идентификатор операции:

GetProcessingState

Эта операция извлекает состояние обработки заданного идентификатора разбивки и при обработке возвращает ход выполнения (например, 30%).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор, связанный с видео и его разбивкой.

Возвращаемое значение

Имя	Путь	Тип	Описание
Государство	state	string	Отправка, обработка, обработка или сбой.
Progress	progress	string	Процент видео, если состояние обрабатывается.

Получение учетных записей

Идентификатор операции:

GetAccounts

Возвращает сведения о учетных записях пользователя.

Возвращаемое значение

Имя	Путь	Тип	Описание
		array of object
Идентификатор учетной записи	id	string
Имя учетной записи	name	string

Разбивка видео повторного индекса

Идентификатор операции:

Re-IndexBreakdown

Эта операция переиндексирует заданный разрыв.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор разбивки видео.
URL-адрес обратного вызова	callbackUrl		string	URL-адрес для уведомления о завершении повторного индексирования.

Возвращаемое значение

response

object

Удаление видео и его аналитических сведений

Идентификатор операции:

DeleteBreakdown

Эта операция удаляет отправленное видео и при удаленииInsights=true, а затем удаляет созданные аналитические сведения.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор видео	id	True	string	Идентификатор, связанный с видео и его разбивкой.
Удаление аналитики	deleteInsights		boolean	Следует ли удалять созданные аналитические сведения, а также (True или False).

Возвращаемое значение

response

object

Определения

videoResponse

Идентификатор, связанный с видео и его разбивкой.

Идентификатор, связанный с видео и его разбивкой.

Идентификатор видео

string

объект

Это тип object.

струна

Это базовый тип данных string.