Быстрый старт: использование клиентской библиотеки поиска видео Bing

Предупреждение

30 октября 2020 г. API поиска Bing перемещены из служб ИИ Azure в службы поиска Bing. Эта документация предоставляется только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.

Используйте это краткое руководство, чтобы начать поиск новостей с клиентской библиотекой поиска видео Bing для C#. Хотя поиск видео Bing имеет REST API, совместимый с большинством языков программирования, клиентская библиотека предоставляет простой способ интеграции службы в приложения. Исходный код этого примера можно найти на GitHub с дополнительными заметками и функциями.

Предпосылки

Любой выпуск Visual Studio 2017 или более поздней версии.
Платформа Json.NET, доступная в виде пакета NuGet.

Чтобы добавить в проект клиентную библиотеку поиска видео Bing, выберите Управление пакетами NuGet из обозревателя решений в Visual Studio. Добавьте пакет Microsoft.Azure.CognitiveServices.Search.VideoSearch.

Установка пакета SDK для поиска видео NuGet также устанавливает следующие зависимости:

Microsoft.Rest.ClientRuntime
Microsoft.Rest.ClientRuntime.Azure
Newtonsoft.Json

Создание ресурса Azure

Начните использовать API поиска видео Bing, создав один из следующих ресурсов Azure:

Bing Search ресурс версии 7

Доступно на портале Azure до удаления ресурса.
Используйте бесплатный тарифный план, чтобы попробовать услугу, и перейдите на платный тариф для использования в работе.

многосервисного ресурса

Доступно на портале Azure до удаления ресурса.
Используйте один и тот же ключ и конечную точку для приложений в нескольких службах ИИ Azure.

Создание и инициализация проекта

Создайте новое консольное решение C# в Visual Studio. Затем добавьте следующий код в основной файл кода.

using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.VideoSearch;
using Microsoft.Azure.CognitiveServices.Search.VideoSearch.Models;

Создайте экземпляр клиента, создав новый объект ApiKeyServiceClientCredentials с ключом подписки и вызвав конструктор.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Отправка поискового запроса и обработка результатов

Используйте клиент для отправки запроса на поиск. Используйте SwiftKey для поискового запроса.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Если были возвращены какие-либо результаты, выберите первый с videoResults.Value[0]. Затем распечатайте идентификатор, заголовок и URL-адрес видео.

if (videoResults.Value.Count > 0)
{
    var firstVideoResult = videoResults.Value[0];

    Console.WriteLine($"\r\nVideo result count: {videoResults.Value.Count}");
    Console.WriteLine($"First video id: {firstVideoResult.VideoId}");
    Console.WriteLine($"First video name: {firstVideoResult.Name}");
    Console.WriteLine($"First video url: {firstVideoResult.ContentUrl}");
}
else
{
    Console.WriteLine("Couldn't find video results!");
}

Дальнейшие действия

Создание веб-приложения одной страницы

См. также

Используйте это краткое руководство, чтобы начать поиск новостей с клиентской библиотекой поиска видео Bing для Java. Хотя поиск видео Bing имеет REST API, совместимый с большинством языков программирования, клиентская библиотека предоставляет простой способ интеграции службы в приложения. Исходный код этого примера можно найти на GitHub с дополнительными заметками и функциями.

Предпосылки

Создание ресурса Azure

Начните использовать API поиска видео Bing, создав один из следующих ресурсов Azure:

Bing Search ресурс версии 7

Доступно на портале Azure до удаления ресурса.
Используйте бесплатный тарифный план, чтобы попробовать услугу, и перейдите на платный тариф для использования в работе.

многосервисного ресурса

Доступно на портале Azure до удаления ресурса.
Используйте один и тот же ключ и конечную точку для приложений в нескольких службах ИИ Azure.

Установите зависимости клиентской библиотеки поиска видео Bing с помощью Maven, Gradle или другой системы управления зависимостями. Для файла POM Maven требуется следующее объявление:

  <dependencies>
    <dependency>
      <groupId>com.microsoft.azure.cognitiveservices</groupId>
      <artifactId>azure-cognitiveservices-videosearch</artifactId>
      <version>0.0.1-beta-SNAPSHOT</version>
    </dependency>
  </dependencies>

Создание и инициализация проекта

Создайте проект Java в любимой интегрированной среде разработки или редакторе и импортируйте следующие библиотеки.

    import com.microsoft.azure.cognitiveservices.videosearch.*;
    import com.microsoft.azure.cognitiveservices.videosearch.VideoObject;
    import com.microsoft.rest.credentials.ServiceClientCredentials;
    import okhttp3.Interceptor;
    import okhttp3.OkHttpClient;
    import okhttp3.Request;
    import okhttp3.Response;
    import java.io.IOException;
    import java.util.ArrayList;
    import java.util.List;

Создание клиента для поиска

Реализуйте клиент VideoSearchAPIImpl, который требует вашей конечной точки API и экземпляр класса ServiceClientCredentials.
```
public static VideoSearchAPIImpl getClient(final String subscriptionKey) {
    return new VideoSearchAPIImpl("https://api.cognitive.microsoft.com/bing/v7.0/",
            new ServiceClientCredentials() {
            //...
            }
)};
```
Чтобы реализовать ServiceClientCredentials, выполните следующие действия.
1. переопределите функцию applyCredentialsFilter() с объектом OkHttpClient.Builder в качестве параметра.
```
//...
new ServiceClientCredentials() {
        @Override
        public void applyCredentialsFilter(OkHttpClient.Builder builder) {
        //...
        }
//...
```
2. В applyCredentialsFilter()вызовите builder.addNetworkInterceptor(). Создайте новый объект Interceptor и переопределите его метод intercept() для принятия объекта перехватчика Chain.
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```
3. В функции intercept создайте переменные для запроса. Используйте Request.Builder() для создания запроса. Добавьте ключ подписки в заголовок Ocp-Apim-Subscription-Key и верните chain.proceed() в объекте запроса.
```
//...
public Response intercept(Chain chain) throws IOException {
    Request request = null;
    Request original = chain.request();
    Request.Builder requestBuilder = original.newBuilder()
            .addHeader("Ocp-Apim-Subscription-Key", subscriptionKey);
    request = requestBuilder.build();
    return chain.proceed(request);
}
//...
```

Отправка поискового запроса и получение ответа

Создайте функцию с именем VideoSearch(), которая принимает ключ подписки в виде строки. Инициализируйте клиент поиска, созданный ранее.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

В VideoSearch()отправьте запрос на поиск видео с помощью клиента с SwiftKey в качестве условия поиска. Если API поиска видео вернул результат, получите первый результат и распечатайте его идентификатор, имя и URL-адрес, а также общее количество возвращенных видео.

VideosInner videoResults = client.searchs().list("SwiftKey");

if (videoResults == null){
    System.out.println("Didn't see any video result data..");
}
else{
    if (videoResults.value().size() > 0){
        VideoObject firstVideoResult = videoResults.value().get(0);

        System.out.println(String.format("Video result count: %d", videoResults.value().size()));
        System.out.println(String.format("First video id: %s", firstVideoResult.videoId()));
        System.out.println(String.format("First video name: %s", firstVideoResult.name()));
        System.out.println(String.format("First video url: %s", firstVideoResult.contentUrl()));
    }
    else{
        System.out.println("Couldn't find video results!");
    }
}

Вызовите метод поиска из основного метода.

public static void main(String[] args) {
    VideoSDK.VideoSearch("YOUR-SUBSCRIPTION-KEY");
}

Дальнейшие действия

Создание веб-приложения одной страницы

См. также

Используйте это краткое руководство, чтобы начать поиск новостей с клиентской библиотекой поиска видео Bing для JavaScript. Хотя поиск видео Bing имеет REST API, совместимый с большинством языков программирования, клиентская библиотека предоставляет простой способ интеграции службы в приложения. Исходный код для этого шаблона можно найти на портале GitHub. Он содержит дополнительные заметки и функции.

Предпосылки

Последняя версия Node.js.
Пакет SDK поиска видео Bing для JavaScript
- Чтобы установить его, выполните такую команду. npm install @azure/cognitiveservices-videosearch
Класс CognitiveServicesCredentials из пакета @azure/ms-rest-azure-js для проверки подлинности клиента.
- Чтобы установить его, выполните такую команду. npm install @azure/ms-rest-azure-js

Создание ресурса Azure

Начните использовать API поиска видео Bing, создав один из следующих ресурсов Azure:

Bing Search ресурс версии 7

Доступно на портале Azure до удаления ресурса.
Используйте бесплатный тарифный план, чтобы попробовать услугу, и перейдите на платный тариф для использования в работе.

многосервисного ресурса

Доступно на портале Azure до удаления ресурса.
Используйте один и тот же ключ и конечную точку для приложений в нескольких службах ИИ Azure.

Создание и инициализация приложения

Создайте новый файл JavaScript в любимой интегрированной среде разработки или редакторе и добавьте инструкцию require() для клиентской библиотеки поиска видео Bing и модуля CognitiveServicesCredentials. Создайте переменную для ключа подписки.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Создайте экземпляр CognitiveServicesCredentials с вашим ключом. Затем используйте его для создания экземпляра клиента поиска видео.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Отправка запроса поиска

Используйте client.videosOperations.search() для отправки запроса поиска в API Bing для поиска видео. Когда результаты поиска возвращаются, используйте .then() для регистрации результата.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Дальнейшие действия

Создание веб-приложения одной страницы

См. также

Используйте это краткое руководство, чтобы начать поиск новостей с клиентской библиотекой поиска видео Bing для Python. Хотя поиск видео Bing имеет REST API, совместимый с большинством языков программирования, клиентская библиотека предоставляет простой способ интеграции службы в приложения. Исходный код этого примера можно найти на GitHub с дополнительными заметками и функциями.

Создание ресурса Azure

Начните использовать API поиска видео Bing, создав один из следующих ресурсов Azure:

Bing Search ресурс версии 7

Доступно на портале Azure до удаления ресурса.
Используйте бесплатный тарифный план, чтобы попробовать услугу, и перейдите на платный тариф для использования в работе.

многосервисного ресурса

Доступно на портале Azure до удаления ресурса.
Используйте один и тот же ключ и конечную точку для приложений в нескольких службах ИИ Azure.

Предпосылки

Python 2.x или 3.x
Клиентская библиотека поиска видео Bing для Python

Рекомендуется использовать виртуальную среду Python . Вы можете установить и инициализировать виртуальную среду с помощью модуля venv. Установите virtualenv для Python 2.7 с помощью:

python -m venv mytestenv

Установите клиентную библиотеку поиска видео Bing с помощью следующих компонентов:

cd mytestenv
python -m pip install azure-cognitiveservices-search-videosearch

Создание и инициализация приложения

Создайте файл Python в избранной интегрированной среде разработки или редакторе и добавьте следующие инструкции импорта.

from azure.cognitiveservices.search.videosearch import VideoSearchClient
from azure.cognitiveservices.search.videosearch.models import VideoPricing, VideoLength, VideoResolution, VideoInsightModule
from msrest.authentication import CognitiveServicesCredentials

Создайте переменную для ключа подписки.
```
subscription_key = "YOUR-SUBSCRIPTION-KEY"
endpoint = "YOUR-ENDPOINT"
```

Создание клиента поиска

Создайте экземпляр CognitiveServicesCredentials, и инстанцируйте клиента.

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Отправка поискового запроса и получение ответа

Используйте client.videos.search() с поисковым запросом, чтобы отправить запрос в API поиска видео Bing и получить ответ.
```
video_result = client.videos.search(query="SwiftKey")
```

Если ответ содержит результаты поиска, получите первый и распечатайте его идентификатор, имя и URL-адрес.

if video_result.value:
    first_video_result = video_result.value[0]
    print("Video result count: {}".format(len(video_result.value)))
    print("First video id: {}".format(first_video_result.video_id))
    print("First video name: {}".format(first_video_result.name))
    print("First video url: {}".format(first_video_result.content_url))
else:
    print("Didn't see any video result data..")

Дальнейшие действия

Создание веб-приложения одной страницы

См. также

Last updated on 2020-10-22

Быстрый старт: использование клиентской библиотеки поиска видео Bing

Предпосылки

Создание ресурса Azure

Создание и инициализация проекта

Отправка поискового запроса и обработка результатов

Дальнейшие действия

См. также

Предпосылки

Создание ресурса Azure

Создание и инициализация проекта

Создание клиента для поиска

Отправка поискового запроса и получение ответа

Дальнейшие действия

См. также

Предпосылки

Создание ресурса Azure

Создание и инициализация приложения

Отправка запроса поиска

Дальнейшие действия

См. также

Создание ресурса Azure

Предпосылки

Создание и инициализация приложения

Создание клиента поиска

Отправка поискового запроса и получение ответа

Дальнейшие действия

См. также

Дополнительные ресурсы