Guia de início rápido: usar a biblioteca de cliente da Pesquisa de Vídeo do Bing

Advertência

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram movidas 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 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 através do Azure Marketplace.

Use este guia de início rápido para começar a pesquisar notícias com a biblioteca de cliente da Pesquisa de Vídeo do Bing para 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 cliente fornece uma maneira fácil de integrar o serviço em seus aplicativos. O código-fonte deste 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 NuGet.

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

A instalação do pacote [NuGet Video Search SDK] 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 Pesquisa do Bing v7

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

Recurso multisserviços

Disponível através do portal do Azure até eliminar o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos, em vários serviços de IA do Azure.

Criar e inicializar um projeto

Crie uma nova solução de console C# no Visual Studio. Em seguida, adicione o seguinte 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;

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

Enviar um pedido 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 foi retornado, 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!");
}

Próximos passos

Criar um aplicativo Web de página única

Ver também

Use este início rápido para começar a pesquisar notícias com a biblioteca de cliente da Pesquisa de Vídeo do Bing para 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 cliente fornece uma maneira fácil de integrar o serviço em seus aplicativos. O código-fonte deste exemplo pode ser encontrado no GitHub, com anotações e recursos adicionais.

Pré-requisitos

O Kit de Desenvolvimento em Java (JDK)
A biblioteca Gson

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 Pesquisa do Bing v7

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

Recurso multisserviços

Disponível através do portal do Azure até eliminar o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos, em vários serviços de IA do Azure.

Instale as dependências da biblioteca de cliente do Bing Video Search usando o Maven, o Gradle ou outro sistema de gerenciamento de dependência. O arquivo Maven POM 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 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 cliente VideoSearchAPIImpl, que requer o seu ponto final da 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 o ServiceClientCredentials, siga estes passos:

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

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

Dentro de applyCredentialsFilter(), ligue para builder.addNetworkInterceptor(). Crie um novo objeto Interceptor e sobrescreva o seu método intercept() para receber um objeto intercetor Chain.

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

Dentro da função intercept, crie variáveis para o seu pedido. Use Request.Builder() para criar sua solicitação. Adicione sua 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);
}
//...

Envie um pedido de pesquisa e receba a resposta

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

Dentro de VideoSearch(), envie uma solicitação de pesquisa de vídeo usando o cliente, com SwiftKey como termo de pesquisa. Se a API de Pesquisa de Vídeo retornar resultados, extraia o primeiro resultado e imprima o seu 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óximos passos

Criar um aplicativo Web de página única

Ver também

Use este início rápido para começar a pesquisar notícias com a biblioteca de cliente da Pesquisa de Vídeo do Bing para 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 cliente fornece uma maneira fácil de integrar o serviço em seus aplicativos. O código-fonte deste exemplo pode ser encontrado no GitHub. Ele contém mais anotações e recursos.

Pré-requisitos

A última versão do Node.js.
O SDK de 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 Pesquisa do Bing v7

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

Recurso multisserviços

Disponível através do portal do Azure até eliminar o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos, em vários serviços de IA do Azure.

Criar e inicializar o aplicativo

Crie um novo arquivo JavaScript em seu IDE ou editor favorito e adicione uma require() instrução para o cliente, a biblioteca e CognitiveServicesCredentials o módulo da Pesquisa de Vídeo 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 sua chave. Em seguida, use-o 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

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.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Próximos passos

Criar um aplicativo Web de página única

Ver também

Use este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeo do Bing para 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 cliente fornece uma maneira fácil de integrar o serviço em seus aplicativos. O código-fonte deste 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 Pesquisa do Bing v7

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

Recurso multisserviços

Disponível através do portal do Azure até eliminar o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos, em vários serviços de IA do Azure.

Pré-requisitos

Python 2.x ou 3.x
A biblioteca de cliente do Bing Video Search para python

É recomendável que você use um ambiente virtual Python. Você pode instalar e inicializar um ambiente virtual com o módulo venv. Instale virtualenv para Python 2.7 com:

python -m venv mytestenv

Instale a biblioteca de cliente do Bing Video Search 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 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

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 resultados de pesquisa, obtenha o primeiro e imprima seu 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..")

Próximos passos

Criar um aplicativo Web de página única

Ver também

Last updated on 2020-10-22

Partilhar via

Guia de início rápido: usar a biblioteca de cliente da Pesquisa de Vídeo do Bing

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Enviar um pedido de pesquisa e processar os resultados

Próximos passos

Ver também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar um projeto

Criar um cliente de pesquisa

Envie um pedido de pesquisa e receba a resposta

Próximos passos

Ver também

Pré-requisitos

Criar um recurso do Azure

Criar e inicializar o aplicativo

Enviar o pedido de pesquisa

Próximos passos

Ver também

Criar um recurso do Azure

Pré-requisitos

Criar e inicializar o aplicativo

Criar o cliente de pesquisa

Enviar um pedido de pesquisa e obter uma resposta

Próximos passos

Ver também

Recursos adicionais