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

Aviso

As APIs de Pesquisa do Bing estão migrando dos Serviços Cognitivos para os Serviços de Pesquisa do Bing. A partir de 30 de outubro de 2020, todas as novas instâncias da Pesquisa do Bing precisam ser provisionadas seguindo o processo documentado aqui. As APIs de Pesquisa do Bing provisionadas por meio dos Serviços Cognitivos terão suporte nos próximos três anos ou até o final do seu Contrato Enterprise, o que ocorrer primeiro. Para obter instruções sobre a migração, confira Serviços de Pesquisa do Bing.

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

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 em vários Serviços Cognitivos.

Criar e inicializar um projeto

  1. 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;
    
  2. 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

  1. 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;
    
  2. 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

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 em vários Serviços Cognitivos.

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

  1. 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:

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

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. 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 {
              //...    
              }
          });
      ///...
      
    3. 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

  1. 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);
        //...
    }
    
  2. 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!");
        }
    }
    
  3. 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

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 em vários Serviços Cognitivos.

Criar e inicializar o aplicativo

  1. 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');
    
  2. 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

  1. 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

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 em vários Serviços Cognitivos.

Pré-requisitos

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

É recomendável 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

  1. 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
    
  2. 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

  1. 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")
    
  2. 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

Confira também