Démarrage rapide : Utiliser la bibliothèque de client Recherche de vidéos Bing

Article
10/22/2020

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

Utilisez ce guide de démarrage rapide pour démarrer une recherche de vidéos avec la bibliothèque de client Recherche de vidéos Bing pour C#. Si l’outil Recherche de vidéos Bing dispose d’une API REST compatible avec la plupart des langages de programmation, la bibliothèque de client offre quant à elle un moyen facile d’intégrer le service à vos applications. Le code source de cet exemple est disponible sur GitHub avec des fonctionnalités et annotations supplémentaires.

Prérequis

N’importe quelle édition de Visual Studio 2017 ou ultérieure.
Le framework Json.NET, disponible sous forme de package NuGet.

Pour ajouter la bibliothèque de client Recherche de vidéos Bing à votre projet, sélectionnez Gérer les packages NuGet à partir de l’Explorateur de solutions dans Visual Studio. Ajoutez le package Microsoft.Azure.CognitiveServices.Search.VideoSearch.

L’installation du [package NuGet du SDK Recherche de vidéos] installe également les dépendances suivantes :

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

Créer une ressource Azure

Commencez à utiliser l’API Recherche de vidéos Bing en créant une des ressources Azure suivantes :

Ressource Recherche Bing v7

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Créer et initialiser un projet

Créez une solution console en C# dans Visual Studio. Ajoutez ensuite les éléments suivants dans le fichier de code principal.

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

Instanciez le client en créant un objet ApiKeyServiceClientCredentials avec votre clé d’abonnement, puis en appelant le constructeur.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Envoyer une requête de recherche et traiter les résultats

Utilisez le client pour envoyer une requête de recherche. Utilisez « SwiftKey » pour la requête de recherche.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Si des résultats sont retournés, obtenez le premier avec videoResults.Value[0]. Ensuite, affichez l’ID, le titre et l’URL de la vidéo.

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

Étapes suivantes

Créer une application web monopage

Voir aussi

Utilisez ce guide de démarrage rapide pour démarrer une recherche de vidéos avec la bibliothèque de client Recherche de vidéos Bing pour Java. Si l’outil Recherche de vidéos Bing dispose d’une API REST compatible avec la plupart des langages de programmation, la bibliothèque de client offre quant à elle un moyen facile d’intégrer le service à vos applications. Le code source de cet exemple est disponible sur GitHub avec des fonctionnalités et annotations supplémentaires.

Prérequis

Le JDK (Java Development Kit)
La bibliothèque Gson

Créer une ressource Azure

Commencez à utiliser l’API Recherche de vidéos Bing en créant une des ressources Azure suivantes :

Ressource Recherche Bing v7

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Installez les dépendances de bibliothèque de client Recherche de vidéos Bing en utilisant Maven, Gradle ou un autre système de gestion des dépendances. Le fichier POM Maven nécessite la déclaration suivante :

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

Créer et initialiser un projet

Créez un projet Java dans votre éditeur ou IDE favori, puis importez les bibliothèques suivantes.

    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;

Créer un client de recherche

Implémentez le client VideoSearchAPIImpl, qui nécessite votre point de terminaison d’API et une instance de la classe ServiceClientCredentials.

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

Pour implémenter ServiceClientCredentials, effectuez les étapes suivantes :

Remplacez la fonction applyCredentialsFilter() avec un objet OkHttpClient.Builder en tant que paramètre.

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

Au sein de applyCredentialsFilter(), appelez builder.addNetworkInterceptor(). Créez un objet Interceptor et remplacez sa méthode intercept() pour prendre un objet intercepteur Chain.

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

Au sein de la fonction intercept, créez des variables pour votre requête. Utilisez Request.Builder() pour générer votre requête. Ajoutez votre clé d’abonnement à l’en-tête Ocp-Apim-Subscription-Key et retournez chain.proceed() sur l’objet de requête.

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

Envoyer une requête de recherche et recevoir la réponse

Créez une fonction nommée VideoSearch() qui prend votre clé d’abonnement comme chaîne. Instanciez le client recherche créé précédemment.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

Au sein de VideoSearch(), envoyez une requête de recherche de vidéos à l’aide du client, avec SwiftKey comme terme de recherche. Si l’API Recherche de vidéos retourne un résultat, obtenez le premier et affichez son ID, son nom et son URL, ainsi que le nombre total de vidéos retournées.

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

Appelez la méthode search depuis votre méthode main.

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

Étapes suivantes

Créer une application web monopage

Voir aussi

Utilisez ce guide de démarrage rapide pour démarrer une recherche de vidéos avec la bibliothèque de client Recherche de vidéos Bing pour JavaScript. Si l’outil Recherche de vidéos Bing dispose d’une API REST compatible avec la plupart des langages de programmation, la bibliothèque de client offre quant à elle un moyen facile d’intégrer le service à vos applications. Le code source de cet exemple est disponible sur GitHub. Il contient d’autres fonctionnalités et annotations.

Prérequis

La dernière version de Node.js.
Le SDK Recherche de vidéos Bing pour JavaScript
- Pour l’installer, exécutez npm install @azure/cognitiveservices-videosearch
La classe CognitiveServicesCredentials du package @azure/ms-rest-azure-js pour authentifier le client.
- Pour l’installer, exécutez npm install @azure/ms-rest-azure-js

Créer une ressource Azure

Commencez à utiliser l’API Recherche de vidéos Bing en créant une des ressources Azure suivantes :

Ressource Recherche Bing v7

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Créer et initialiser l’application

Créez un fichier JavaScript dans votre éditeur ou IDE favori, puis ajoutez une instruction require() pour la bibliothèque de client Recherche de vidéos Bing et le module CognitiveServicesCredentials. Créez une variable pour votre clé d’abonnement.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Créez une instance de CognitiveServicesCredentials avec votre clé. Ensuite, utilisez-la pour créer une instance du client de recherche de vidéos.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Envoyer la requête de recherche

Utilisez client.videosOperations.search() pour envoyer une requête de recherche à l’API Recherche de vidéos Bing. Quand les résultats de la recherche sont retournés, utilisez .then() pour journaliser le résultat.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Étapes suivantes

Créer une application web monopage

Voir aussi

Utilisez ce guide de démarrage rapide pour démarrer une recherche de vidéos avec la bibliothèque de client Recherche de vidéos Bing pour Python. Si l’outil Recherche de vidéos Bing dispose d’une API REST compatible avec la plupart des langages de programmation, la bibliothèque de client offre quant à elle un moyen facile d’intégrer le service à vos applications. Le code source de cet exemple est disponible sur GitHub avec des fonctionnalités et annotations supplémentaires.

Créer une ressource Azure

Commencez à utiliser l’API Recherche de vidéos Bing en créant une des ressources Azure suivantes :

Ressource Recherche Bing v7

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Prérequis

Python 2.x ou 3.x
Bibliothèque de client Recherche de vidéos Bing pour Python

Nous vous recommandons d’utiliser un environnement virtuel Python. Vous pouvez installer et lancer un environnement virtuel avec le module venv. Installez virtualenv pour Python 2.7 avec :

python -m venv mytestenv

Installez la bibliothèque de client Recherche de vidéos Bing avec :

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

Créer et initialiser l’application

Créez un fichier Python dans votre éditeur ou IDE favori, puis ajoutez les instructions d’importation suivantes.

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

Créez une variable pour votre clé d’abonnement.

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

Créer le client de recherche

Créez une instance de CognitiveServicesCredentials, et instanciez le client :

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Envoyer une requête de recherche et obtenir une réponse

Utilisez client.videos.search() avec votre requête de recherche pour envoyer une demande à l’API Recherche de vidéos Bing et obtenir une réponse.
```
video_result = client.videos.search(query="SwiftKey")
```

Si la réponse contient des résultats de recherche, obtenez le premier, puis imprimez son ID, son nom et sont 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..")

Étapes suivantes

Créer une application web monopage

Démarrage rapide : Utiliser la bibliothèque de client Recherche de vidéos Bing

Prérequis

Créer une ressource Azure

Créer et initialiser un projet

Envoyer une requête de recherche et traiter les résultats

Étapes suivantes

Voir aussi

Prérequis

Créer une ressource Azure

Créer et initialiser un projet

Créer un client de recherche

Envoyer une requête de recherche et recevoir la réponse

Étapes suivantes

Voir aussi

Prérequis

Créer une ressource Azure

Créer et initialiser l’application

Envoyer la requête de recherche

Étapes suivantes

Voir aussi

Créer une ressource Azure

Prérequis

Créer et initialiser l’application

Créer le client de recherche

Envoyer une requête de recherche et obtenir une réponse

Étapes suivantes

Voir aussi

Ressources supplémentaires