Avvio rapido: Usare la libreria client di Ricerca video Bing
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:
- 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.
- 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
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:
- 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.
- 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 classeServiceClientCredentials
.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 oggettoOkHttpClient.Builder
come parametro.//... new ServiceClientCredentials() { @Override public void applyCredentialsFilter(OkHttpClient.Builder builder) { //... } //...
All'interno di
applyCredentialsFilter()
, chiamarebuilder.addNetworkInterceptor()
. Creare un nuovo oggettoInterceptor
ed eseguire l'override del relativo metodointercept()
per acquisire un oggetto intercettoreChain
.//... builder.addNetworkInterceptor( new Interceptor() { @Override public Response intercept(Chain chain) throws IOException { //... } }); ///...
All'interno della funzione
intercept
creare le variabili per la richiesta. UsareRequest.Builder()
per creare la richiesta. Aggiungere la chiave della sottoscrizione all'intestazioneOcp-Apim-Subscription-Key
e restituirechain.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, conSwiftKey
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
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
- Per installarlo, eseguire
- La classe
CognitiveServicesCredentials
del pacchetto@azure/ms-rest-azure-js
per autenticare il client.- Per installarlo, eseguire
npm install @azure/ms-rest-azure-js
- Per installarlo, eseguire
Creare una risorsa di Azure
Per iniziare a usare l'API Ricerca video Bing, creare una delle risorse di Azure seguenti:
- 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.
- 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 moduloCognitiveServicesCredentials
. 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
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:
- 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.
- 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..")