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

Avertissement

Le 30 octobre 2020, les API Recherche Bing sont passées de Cognitive Services à Bing Search Services. 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

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, dans plusieurs services Cognitive Services.

Créer et initialiser un projet

  1. 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;
    
  2. 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

  1. 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;
    
  2. 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

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

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, dans plusieurs services Cognitive Services.

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

  1. 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 :

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

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. 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 {
              //...    
              }
          });
      ///...
      
    3. 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

  1. 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);
        //...
    }
    
  2. 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!");
        }
    }
    
  3. Appelez la méthode search depuis votre méthode main.

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

Étapes suivantes

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, dans plusieurs services Cognitive Services.

Créer et initialiser l’application

  1. 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');
    
  2. 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

  1. 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

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, dans plusieurs services Cognitive Services.

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

  1. 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
    
  2. 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

  1. 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")
    
  2. 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

Voir aussi