Avvio rapido: Usare la libreria client di Ricerca video Bing

Articolo
10/22/2020

Avviso

Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.

Usare questa guida introduttiva per iniziare a cercare notizie con la libreria client ricerca video Bing per C#. Anche se Ricerca video Bing ha un'API REST compatibile con la maggior parte dei linguaggi di programmazione, la libreria client offre un modo semplice per integrare il servizio nelle applicazioni. Il codice sorgente per questo esempio è disponibile in GitHub con annotazioni e funzionalità aggiuntive.

Prerequisiti

Qualsiasi edizione di Visual Studio 2017 o versioni successive.
Framework Json.NET, disponibile come pacchetto NuGet.

Per aggiungere la libreria client di Ricerca video Bing al progetto, selezionare Gestisci pacchetti NuGet da Esplora soluzioni in Visual Studio. Aggiungere il pacchetto Microsoft.Azure.CognitiveServices.Search.VideoSearch.

L'installazione del [pacchetto NuGet dell'SDK di Ricerca video] determina l'installazione anche delle dipendenze seguenti:

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

Creare una risorsa di Azure

Per iniziare a usare l'API Ricerca video Bing, creare una delle risorse di Azure seguenti:

Risorsa Ricerca Bing v7

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.

Risorsa multi-servizio

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Creare e inizializzare un progetto

Creare una nuova soluzione di console C# in Visual Studio. Aggiungere quindi quanto segue nel file di codice principale.

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

Creare un'istanza del client creando un nuovo oggetto ApiKeyServiceClientCredentials con la chiave di sottoscrizione e chiamando il costruttore.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Inviare una richiesta di ricerca ed elaborare i risultati

Usare il client per inviare una richiesta di ricerca. Usare "SwiftKey" come query di ricerca.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Se vengono restituiti risultati, recuperare il primo con videoResults.Value[0]. Stampare quindi ID, titolo e URL del video.

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

Passaggi successivi

Creare un'app Web a pagina singola

Vedere anche

Usare questa guida introduttiva per iniziare a cercare notizie con la libreria client di Ricerca video Bing per Java. Anche se Ricerca video Bing ha un'API REST compatibile con la maggior parte dei linguaggi di programmazione, la libreria client offre un modo semplice per integrare il servizio nelle applicazioni. Il codice sorgente per questo esempio è disponibile in GitHub, con annotazioni aggiuntive e altre funzionalità.

Prerequisiti

Creare una risorsa di Azure

Per iniziare a usare l'API Ricerca video Bing, creare una delle risorse di Azure seguenti:

Risorsa Ricerca Bing v7

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.

Risorsa multi-servizio

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Installare le dipendenze della libreria client di Ricerca video Bing usando Maven, Gradle o un altro sistema di gestione delle dipendenze. Il file POM di Maven richiede la dichiarazione seguente:

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

Creare e inizializzare un progetto

Creare un nuovo progetto Java nell'ambiente di sviluppo integrato o nell'editor preferito e importare le librerie seguenti.

    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;

Creare un client di ricerca

Implementare il client VideoSearchAPIImpl, che richiede l'endpoint API, e un'istanza della classe ServiceClientCredentials.

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

Per implementare ServiceClientCredentials, seguire questa procedura:

Eseguire l'override della funzione applyCredentialsFilter(), con un oggetto OkHttpClient.Builder come parametro.

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

All'interno di applyCredentialsFilter(), chiamare builder.addNetworkInterceptor(). Creare un nuovo oggetto Interceptor ed eseguire l'override del relativo metodo intercept() per acquisire un oggetto intercettore Chain.
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```

All'interno della funzione intercept creare le variabili per la richiesta. Usare Request.Builder() per creare la richiesta. Aggiungere la chiave della sottoscrizione all'intestazione Ocp-Apim-Subscription-Key e restituire chain.proceed() per l'oggetto della richiesta.

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

Inviare una richiesta di ricerca e ricevere la risposta

Creare una funzione denominata VideoSearch() che accetta la chiave della sottoscrizione come stringa. Creare un'istanza del client di ricerca creato in precedenza.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

All'interno di VideoSearch() inviare una richiesta di ricerca di video usando il client, con SwiftKey come termine di ricerca. Se l'API Ricerca video ha restituito un risultato, ottenere il primo risultato e stampare i relativi ID, nome e URL, oltre al numero totale di video restituiti.

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

Chiamare il metodo search dal metodo main.

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

Passaggi successivi

Creare un'app Web a pagina singola

Vedere anche

Seguire questo argomento di avvio rapido per iniziare a cercare notizie con la libreria client di Ricerca video Bing per JavaScript. Anche se Ricerca video Bing ha un'API REST compatibile con la maggior parte dei linguaggi di programmazione, la libreria client offre un modo semplice per integrare il servizio nelle applicazioni. Il codice sorgente per questo esempio è disponibile su GitHub. Contiene altre annotazioni e funzionalità.

Prerequisiti

La versione più recente di Node.js.
L'SDK di Ricerca video Bing per JavaScript
- Per installarlo, eseguire npm install @azure/cognitiveservices-videosearch
La classe CognitiveServicesCredentials del pacchetto @azure/ms-rest-azure-js per autenticare il client.
- Per installarlo, eseguire npm install @azure/ms-rest-azure-js

Creare una risorsa di Azure

Per iniziare a usare l'API Ricerca video Bing, creare una delle risorse di Azure seguenti:

Risorsa Ricerca Bing v7

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.

Risorsa multi-servizio

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Creare e inizializzare l'applicazione

Creare un nuovo file JavaScript nell'editor o nell'ambiente IDE preferito, quindi aggiungere un'istruzione require() per la libreria client di Ricerca video Bing e il modulo CognitiveServicesCredentials. Creare una variabile per la chiave di sottoscrizione.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Creare un'istanza di CognitiveServicesCredentials con la chiave. Usarla quindi per creare un'istanza del client di ricerca video.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Inviare la richiesta di ricerca

Usare client.videosOperations.search() per inviare una richiesta di ricerca all'API Ricerca video Bing. Quando vengono restituiti i risultati della ricerca, usare .then() per registrare il risultato.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Passaggi successivi

Creare un'app Web a pagina singola

Vedere anche

Usare questa guida introduttiva per iniziare a cercare notizie con la libreria client Ricerca video Bing per Python. Anche se Ricerca video Bing ha un'API REST compatibile con la maggior parte dei linguaggi di programmazione, la libreria client offre un modo semplice per integrare il servizio nelle applicazioni. Il codice sorgente per questo esempio è disponibile in GitHub con annotazioni e funzionalità aggiuntive.

Creare una risorsa di Azure

Per iniziare a usare l'API Ricerca video Bing, creare una delle risorse di Azure seguenti:

Risorsa Ricerca Bing v7

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.

Risorsa multi-servizio

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare la stessa chiave e l'endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Prerequisiti

Python 2.x o 3.x
Libreria client ricerca video Bing per Python

È consigliabile usare un ambiente virtuale Python. È possibile installare e inizializzare un ambiente virtuale con il modulo venv. Installare virtualenv per Python 2.7 con:

python -m venv mytestenv

Installare la libreria client Ricerca video Bing con:

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

Creare e inizializzare l'applicazione

Creare un nuovo file Python nell'IDE o nell'editor preferito e aggiungere le istruzioni di importazione seguenti.

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

Creare una variabile per la chiave di sottoscrizione.

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

Creare il client di ricerca

Creare un'istanza di CognitiveServicesCredentials e creare un'istanza del client:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Inviare una richiesta di ricerca e ottenere una risposta

Usare client.videos.search() con la query di ricerca per inviare una richiesta all'API Ricerca video Bing e ottenere una risposta.
```
video_result = client.videos.search(query="SwiftKey")
```

Se la risposta contiene risultati della ricerca, recuperare il primo e stamparne l'ID, il nome e l'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..")

Passaggi successivi

Creare un'app Web a pagina singola

Avvio rapido: Usare la libreria client di Ricerca video Bing

Prerequisiti

Creare una risorsa di Azure

Creare e inizializzare un progetto

Inviare una richiesta di ricerca ed elaborare i risultati

Passaggi successivi

Vedere anche

Prerequisiti

Creare una risorsa di Azure

Creare e inizializzare un progetto

Creare un client di ricerca

Inviare una richiesta di ricerca e ricevere la risposta

Passaggi successivi

Vedere anche

Prerequisiti

Creare una risorsa di Azure

Creare e inizializzare l'applicazione

Inviare la richiesta di ricerca

Passaggi successivi

Vedere anche

Creare una risorsa di Azure

Prerequisiti

Creare e inizializzare l'applicazione

Creare il client di ricerca

Inviare una richiesta di ricerca e ottenere una risposta

Passaggi successivi

Vedere anche

Risorse aggiuntive