Início Rápido: usar a biblioteca de clientes da Pesquisa de Vídeo do Bing

Artigo
10/22/2020

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a Pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

Use este guia de início rápido para começar a pesquisar notícias com a biblioteca de clientes da Pesquisa de Vídeo do Bing para o C#. Embora a Pesquisa de Vídeo do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de clientes é uma forma fácil de integrar o serviço aos seus aplicativos. O código-fonte desse exemplo pode ser encontrado no GitHub com anotações e recursos adicionais.

Pré-requisitos

Qualquer edição do Visual Studio 2017 ou posterior.
A estrutura Json.NET, disponível como um pacote do NuGet.

Para adicionar a biblioteca de clientes da Pesquisa de Vídeo do Bing ao seu projeto, selecione Gerenciar Pacotes NuGet no Gerenciador de Soluções do Visual Studio. Adicione o pacote Microsoft.Azure.CognitiveServices.Search.VideoSearch.

Instalar o pacote [SDK de Pesquisa de Vídeo do NuGet] também instala as seguintes dependências:

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

Criar um recurso do Azure

Comece a usar a API de Pesquisa de Vídeo do Bing criando um dos seguintes recursos do Azure:

Recurso de Pesquisa do Bing v7

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Criar e inicializar um projeto

Crie uma solução de console C# no Visual Studio. Em seguida, adicione os itens a seguir ao arquivo de código principal.

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

Instanciar um cliente criando um novo objeto ApiKeyServiceClientCredentials com sua chave de assinatura e chamando o construtor.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Enviar uma solicitação de pesquisa e processar os resultados

Use o cliente para enviar uma solicitação de pesquisa. Use "SwiftKey" para a consulta de pesquisa.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Se algum resultado for retornado, obtenha o primeiro com videoResults.Value[0]. Em seguida, imprima a ID, o título e a URL do vídeo.

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!");
}

Próximas etapas

Criar um aplicativo Web de página única

Confira também

Use este guia de início rápido para começar a pesquisar notícias com a biblioteca de clientes da Pesquisa de Vídeo do Bing para o Java. Embora a Pesquisa de Vídeo do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de clientes é uma forma fácil de integrar o serviço aos seus aplicativos. O código-fonte desse exemplo pode ser encontrado no GitHub com anotações e recursos adicionais.

Pré-requisitos

Criar um recurso do Azure

Comece a usar a API de Pesquisa de Vídeo do Bing criando um dos seguintes recursos do Azure:

Recurso de Pesquisa do Bing v7

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Instale as dependências da biblioteca de clientes da Pesquisa de Vídeo do Bing usando Maven, Gradle ou outro sistema de gerenciamento de dependência. O arquivo POM Maven requer a seguinte declaração:

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

Criar e inicializar um projeto

Crie um novo projeto Java em seu IDE ou editor favorito e importe as bibliotecas a seguir.

    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;

Criar um cliente de pesquisa

Implemente o cliente VideoSearchAPIImpl, que exige o ponto de extremidade de API e uma instância da classe ServiceClientCredentials.

public static VideoSearchAPIImpl getClient(final String subscriptionKey) {
    return new VideoSearchAPIImpl("https://api.cognitive.microsoft.com/bing/v7.0/",
            new ServiceClientCredentials() {
            //...
            }
)};

Para implementar ServiceClientCredentials, siga estas etapas:

substitua a função applyCredentialsFilter() por um objeto OkHttpClient.Builder como parâmetro.

//...
new ServiceClientCredentials() {
        @Override
        public void applyCredentialsFilter(OkHttpClient.Builder builder) {
        //...
        }
//...

Em applyCredentialsFilter(), chame builder.addNetworkInterceptor(). Crie um objeto Interceptor e substitua seu método intercept() para usar um objeto interceptor Chain.

//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...

Na função intercept, crie variáveis para sua solicitação. Use Request.Builder() para criar sua solicitação. Adicione a chave de assinatura ao cabeçalho Ocp-Apim-Subscription-Key e retorne chain.proceed() no objeto de solicitação.

//...
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);
}
//...

Enviar uma solicitação de pesquisa e receber a resposta

Criar uma função chamada VideoSearch() que usa sua chave de assinatura como uma cadeia de caracteres. Criar uma instância de pesquisa de cliente criada anteriormente.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

Em VideoSearch(), envie uma solicitação de pesquisa de vídeo usando o cliente com SwiftKey como o termo de pesquisa. Se a API de Pesquisa de Vídeo retornou um resultado, obtenha o primeiro resultado e imprima sua ID, nome e URL, juntamente com o número total de vídeos retornados.

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!");
    }
}

Chame o método de pesquisa do seu método principal.

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

Próximas etapas

Criar um aplicativo Web de página única

Confira também

Use este guia de início rápido para começar a pesquisar notícias com a biblioteca de clientes da Pesquisa de Vídeo do Bing para o JavaScript. Embora a Pesquisa de Vídeo do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de clientes é uma forma fácil de integrar o serviço aos seus aplicativos. O código-fonte desta amostra pode ser encontrado no GitHub. Ele contém mais recursos e anotações.

Pré-requisitos

A versão mais recente do Node.js.
O SDK da Pesquisa de Vídeo do Bing para JavaScript
- Para instalar, execute npm install @azure/cognitiveservices-videosearch
A classe CognitiveServicesCredentials do pacote @azure/ms-rest-azure-js para autenticar o cliente.
- Para instalar, execute npm install @azure/ms-rest-azure-js

Criar um recurso do Azure

Comece a usar a API de Pesquisa de Vídeo do Bing criando um dos seguintes recursos do Azure:

Recurso de Pesquisa do Bing v7

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Criar e inicializar o aplicativo

Crie um arquivo JavaScript em seu IDE ou editor favorito e adicione uma instrução require() à biblioteca de clientes da Pesquisa de Vídeo do Bing e o módulo CognitiveServicesCredentials. Criar uma variável para a chave de assinatura.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Crie uma instância de CognitiveServicesCredentials com sua chave. Em seguida, use-a para criar uma instância do cliente de pesquisa de vídeo.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Enviar a solicitação de pesquisa

Use client.videosOperations.search() para enviar uma solicitação de pesquisa para a API de Pesquisa de Vídeo do Bing. Quando os resultados da pesquisa forem retornados, use .then() para registrar o resultado em log.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Próximas etapas

Criar um aplicativo Web de página única

Confira também

Use este guia de início rápido para começar a pesquisar notícias com a biblioteca de clientes da Pesquisa de Vídeo do Bing para o Python. Embora a Pesquisa de Vídeo do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de clientes é uma forma fácil de integrar o serviço aos seus aplicativos. O código-fonte desse exemplo pode ser encontrado no GitHub com anotações e recursos adicionais.

Criar um recurso do Azure

Comece a usar a API de Pesquisa de Vídeo do Bing criando um dos seguintes recursos do Azure:

Recurso de Pesquisa do Bing v7

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Pré-requisitos

Python 2.x ou 3.x
A biblioteca de clientes da Pesquisa de Vídeo do Bing para Python

Recomendamos usar um ambiente virtual do Python. Instale e inicialize o ambiente virtual com o módulo venv. Instale o virtualenv para o Python 2.7 com:

python -m venv mytestenv

Instalar a biblioteca de clientes da Pesquisa de Vídeo do Bing com:

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

Criar e inicializar o aplicativo

Crie um novo arquivo Python em seu IDE ou o editor favorito e adicione as seguintes instruções de importação.

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

Criar uma variável para a chave de assinatura.

subscription_key = "YOUR-SUBSCRIPTION-KEY"
endpoint = "YOUR-ENDPOINT"

Crie o cliente de pesquisa

Crie uma instância do CognitiveServicesCredentials e instancie o cliente:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Enviar uma solicitação de pesquisa e obter uma resposta

Use client.videos.search() com sua consulta de pesquisa para enviar uma solicitação para a API de Pesquisa de Vídeo do Bing e obter uma resposta.
```
video_result = client.videos.search(query="SwiftKey")
```

Se a resposta contiver os resultados da pesquisa, obtenha o primeiro deles e imprima sua ID, seu nome e sua 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..")

Próximas etapas

Criar um aplicativo Web de página única

Início Rápido: usar a biblioteca de clientes da Pesquisa de Vídeo do Bing

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Enviar uma solicitação de pesquisa e processar os resultados

Próximas etapas

Confira também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Criar um cliente de pesquisa

Enviar uma solicitação de pesquisa e receber a resposta

Próximas etapas

Confira também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar o aplicativo

Enviar a solicitação de pesquisa

Próximas etapas

Confira também

Criar um recurso do Azure

Pré-requisitos

Criar e inicializar o aplicativo

Crie o cliente de pesquisa

Enviar uma solicitação de pesquisa e obter uma resposta

Próximas etapas

Confira também

Recursos adicionais