Início Rápido: Utilizar a biblioteca de cliente da Pesquisa de Vídeos do Bing

Artigo
10/22/2020

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja 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, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para C#. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub com anotações e funcionalidades adicionais.

Pré-requisitos

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

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

A instalação do [pacote do SDK de Pesquisa de Vídeos NuGet] também instala as seguintes dependências:

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

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar um projeto

Crie uma nova solução de consola C# no Visual Studio. Em seguida, adicione o seguinte ao ficheiro 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 o cliente ao criar um novo ApiKeyServiceClientCredentials objeto com a sua chave de subscrição e chamar o construtor.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Enviar um pedido de pesquisa e processar os resultados

Utilize o cliente para enviar um pedido de pesquisa. Utilize "SwiftKey" para a consulta de pesquisa.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Se forem devolvidos resultados, obtenha o primeiro com videoResults.Value[0]. Em seguida, imprima o ID, o título e o 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!");
}

Passos seguintes

Criar uma aplicação Web de página única

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para Java. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub, com anotações e funcionalidades adicionais.

Pré-requisitos

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Instale as dependências da biblioteca de cliente do Bing Video Search com o Maven, o Gradle ou outro sistema de gestão de dependências. O ficheiro POM do Maven necessita da 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 no seu IDE ou editor favorito e importe as seguintes bibliotecas.

    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 VideoSearchAPIImpl cliente, que requer o ponto final da API e uma instância da ServiceClientCredentials classe.

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

Para implementar ServiceClientCredentialso , siga estes passos:

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

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

No applyCredentialsFilter(), chame builder.addNetworkInterceptor(). Crie um novo Interceptor objeto e substitua o respetivo intercept() método para utilizar um Chain objeto de intercetor.

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

Na função intercept , crie variáveis para o seu pedido. Utilize Request.Builder() para criar o seu pedido. Adicione a chave de subscrição ao Ocp-Apim-Subscription-Key cabeçalho e regresse chain.proceed() ao objeto de pedido.

//...
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 um pedido de pesquisa e receber a resposta

Crie uma função denominada VideoSearch() que utiliza a chave de subscrição como uma cadeia. Instanciar o cliente de pesquisa criado anteriormente.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

No VideoSearch(), envie um pedido de pesquisa de vídeo com o cliente, com SwiftKey como o termo de pesquisa. Se a API de Pesquisa de Vídeo devolveu um resultado, obtenha o primeiro resultado e imprima o respetivo ID, nome e URL, juntamente com o número total de vídeos devolvidos.

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 a partir do seu método principal.

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

Passos seguintes

Criar uma aplicação Web de página única

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para JavaScript. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub. Contém mais anotações e funcionalidades.

Pré-requisitos

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

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar a aplicação

Crie um novo ficheiro JavaScript no seu IDE ou editor favorito e adicione uma require() instrução para a biblioteca e CognitiveServicesCredentials módulo de cliente da Pesquisa de Vídeos do Bing. Crie uma variável para a sua chave de subscrição.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Crie uma instância de CognitiveServicesCredentials com a sua chave. Em seguida, utilize-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 o pedido de pesquisa

Utilize client.videosOperations.search() para enviar um pedido de pesquisa para a API de Pesquisa de Vídeos do Bing. Quando os resultados da pesquisa forem devolvidos, utilize .then() para registar o resultado.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Passos seguintes

Criar uma aplicação Web de página única

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para Python. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub com anotações e funcionalidades adicionais.

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Pré-requisitos

Python 2.x ou 3.x
A biblioteca de cliente da Pesquisa de Vídeos do Bing para python

Recomenda-se que utilize um ambiente virtual python. Pode instalar e inicializar um ambiente virtual com o módulo venv. Instale o virtualenv para Python 2.7 com:

python -m venv mytestenv

Instale a biblioteca de cliente da Pesquisa de Vídeos do Bing com:

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

Criar e inicializar a aplicação

Crie um novo ficheiro Python no seu IDE ou 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

Crie uma variável para a sua chave de subscrição.

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

Criar o cliente de pesquisa

Crie uma instância do CognitiveServicesCredentialse instancie o cliente:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Enviar um pedido de pesquisa e obter uma resposta

Utilize client.videos.search() com a consulta de pesquisa para enviar um pedido para a API de Pesquisa de Vídeos do Bing e obter uma resposta.
```
video_result = client.videos.search(query="SwiftKey")
```

Se a resposta contiver resultados de pesquisa, obtenha o primeiro e imprima o respetivo ID, nome e 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..")

Passos seguintes

Criar uma aplicação Web de página única

Partilhar via

Início Rápido: Utilizar a biblioteca de cliente da Pesquisa de Vídeos do Bing

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Enviar um pedido de pesquisa e processar os resultados

Passos seguintes

Ver também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Criar um cliente de pesquisa

Enviar um pedido de pesquisa e receber a resposta

Passos seguintes

Ver também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar a aplicação

Enviar o pedido de pesquisa

Passos seguintes

Ver também

Criar um recurso do Azure

Pré-requisitos

Criar e inicializar a aplicação

Criar o cliente de pesquisa

Enviar um pedido de pesquisa e obter uma resposta

Passos seguintes

Ver também

Recursos adicionais