Schnellstart: Verwenden der Clientbibliothek für die Bing-Videosuche

Artikel
10/22/2020

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für C# mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Voraussetzungen

Eine beliebige Edition von Visual Studio 2017 oder höher.
Das Json.NET-Framework, das als NuGet-Paket verfügbar ist.

Wählen Sie in Visual Studio im Projektmappen-Explorer die Option NuGet-Pakete verwalten aus, um Ihrem Projekt die Clientbibliothek für die Bing-Videosuche hinzuzufügen. Fügen Sie das Paket Microsoft.Azure.CognitiveServices.Search.VideoSearch hinzu.

Beim Installieren des [NuGet-Pakets mit dem SDK für die Videosuche] werden auch die folgenden Abhängigkeiten installiert:

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

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren eines Projekts

Erstellen Sie in Visual Studio eine neue C#-Konsolenprojektmappe. Fügen Sie dann Folgendes in die Hauptcodedatei ein:

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

Instanziieren Sie den Client, indem Sie ein neues ApiKeyServiceClientCredentials-Objekt mit Ihrem Abonnementschlüssel erstellen und den Konstruktor aufrufen.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Senden einer Suchanforderung und Verarbeiten der Ergebnisse

Verwenden Sie den Client, um eine Suchanforderung zu senden. Verwenden Sie „SwiftKey“ für die Suchabfrage.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Wenn Ergebnisse zurückgegeben wurden, können Sie das erste Ergebnis mit videoResults.Value[0] abrufen. Geben Sie anschließend die ID, den Titel und die URL des Videos aus.

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

Nächste Schritte

Erstellen einer Single-Page-Webanwendung

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für Java mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Voraussetzungen

Das Java Development Kit (JDK)
Die Gson-Bibliothek

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Installieren Sie die Abhängigkeit für die Bing-Videosuche-Clientbibliothek mithilfe von Maven, Gradle oder einem anderen Abhängigkeitsverwaltungssystem. Die Maven-POM-Datei erfordert die folgende Deklaration:

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

Erstellen und Initialisieren eines Projekts

Erstellen Sie in Ihrer bevorzugten IDE oder in Ihrem bevorzugten Editor ein neues Java-Projekt, und importieren Sie die folgenden Bibliotheken.

    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;

Erstellen eines Suchclients

Implementieren Sie den VideoSearchAPIImpl-Client, der Ihren API-Endpunkt und eine Instanz der ServiceClientCredentials-Klasse erfordert.

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

Führen Sie zum Implementieren von ServiceClientCredentials die folgenden Schritte aus:

Überschreiben Sie die Funktion applyCredentialsFilter() mit einem OkHttpClient.Builder-Objekt als Parameter.

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

Rufen Sie builder.addNetworkInterceptor() in applyCredentialsFilter() auf. Erstellen Sie ein neues Interceptor-Objekt, und überschreiben Sie seine intercept()-Methode, um ein Interceptor-Objekt vom Typ Chain zu übernehmen.
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```

Erstellen Sie in der Funktion intercept Variablen für Ihre Anforderung. Verwenden Sie Request.Builder() zum Erstellen Ihrer Anforderung. Fügen Sie dem Header Ocp-Apim-Subscription-Key Ihren Abonnementschlüssel hinzu, und geben Sie chain.proceed() für das Anforderungsobjekt zurück.

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

Senden einer Suchanforderung und Empfangen der Antwort

Erstellen Sie eine Funktion namens VideoSearch(), die Ihren Abonnementschlüssel als Zeichenfolge akzeptiert. Instanziieren Sie den zuvor erstellten Suchclient.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

Senden Sie innerhalb von VideoSearch() unter Verwendung des Clients eine Videosuchanforderung mit SwiftKey als Suchbegriff. Wenn die API für die Videosuche ein Ergebnis zurückgegeben hat, rufen Sie das erste Ergebnis ab, und geben Sie die ID, den Namen und die URL sowie die Gesamtanzahl der zurückgegebenen Videos aus.

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

Rufen Sie die Suchmethode über Ihre main-Methode auf.

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

Nächste Schritte

Erstellen einer Single-Page-Webanwendung

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für JavaScript mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Den Quellcode für dieses Beispiel finden Sie auf GitHub. Er enthält weitere Anmerkungen und Features.

Voraussetzungen

Die aktuelle Version von Node.js
Das Bing Videosuche-SDK für JavaScript
- Führen Sie zum Installieren npm install @azure/cognitiveservices-videosearch aus.
Die CognitiveServicesCredentials-Klasse aus dem Paket @azure/ms-rest-azure-js zum Authentifizieren des Clients.
- Führen Sie zum Installieren npm install @azure/ms-rest-azure-js aus.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren der Anwendung

Erstellen Sie eine neue JavaScript-Datei in Ihrer bevorzugten IDE oder einem Editor, und fügen Sie eine require()-Anweisung für die Bing-Videosuche-Clientbibliothek sowie das Modul CognitiveServicesCredentials hinzu. Erstellen Sie eine Variable für Ihren Abonnementschlüssel.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Erstellen Sie eine Instanz der CognitiveServicesCredentials-Klasse mit Ihrem Schlüssel. Verwenden Sie sie anschließend zum Erstellen einer Instanz des Clients für die Videosuche.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Senden der Suchanforderung

Senden Sie mithilfe von client.videosOperations.search() eine Suchanforderung an die Bing-Videosuche-API. Wenn die Suchergebnisse zurückgegeben werden, verwenden Sie .then(), um das Ergebnis zu protokollieren.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Nächste Schritte

Erstellen einer Single-Page-Webanwendung

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für Python mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Voraussetzungen

Python 2.x oder 3.x
Die Bing-Videosuche-Clientbibliothek für Python

Es wird empfohlen, eine virtuelle Python-Umgebung zu verwenden. Sie können eine virtuelle Umgebung mit dem venv-Modul installieren und initialisieren. Installieren Sie virtualenv für Python 2.7 mit:

python -m venv mytestenv

Installieren Sie die Clientbibliothek für die Bing-Videosuche mit:

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

Erstellen und Initialisieren der Anwendung

Erstellen Sie in Ihrer bevorzugten IDE bzw. in einem Editor eine neue Python-Datei, und fügen Sie die folgenden Importanweisungen hinzu.

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

Erstellen Sie eine Variable für Ihren Abonnementschlüssel.

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

Erstellen des Suchclients

Erstellen Sie eine Instanz von CognitiveServicesCredentials, und instanziieren Sie den Client:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Senden einer Suchanforderung und Erhalten einer Antwort

Verwenden Sie client.videos.search() mit Ihrer Suchabfrage, um eine Anforderung an die Bing-Videosuche-API zu senden und eine Antwort zu erhalten.
```
video_result = client.videos.search(query="SwiftKey")
```

Wenn die Antwort Suchergebnisse enthält, können Sie das erste Ergebnis abrufen und dafür die ID, den Namen und die URL ausgeben.

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

Nächste Schritte

Erstellen einer Single-Page-Webanwendung

Schnellstart: Verwenden der Clientbibliothek für die Bing-Videosuche

Voraussetzungen

Erstellen einer Azure-Ressource

Erstellen und Initialisieren eines Projekts

Senden einer Suchanforderung und Verarbeiten der Ergebnisse

Nächste Schritte

Weitere Informationen

Voraussetzungen

Erstellen einer Azure-Ressource

Erstellen und Initialisieren eines Projekts

Erstellen eines Suchclients

Senden einer Suchanforderung und Empfangen der Antwort

Nächste Schritte

Weitere Informationen

Voraussetzungen

Erstellen einer Azure-Ressource

Erstellen und Initialisieren der Anwendung

Senden der Suchanforderung

Nächste Schritte

Weitere Informationen

Erstellen einer Azure-Ressource

Voraussetzungen

Erstellen und Initialisieren der Anwendung

Erstellen des Suchclients

Senden einer Suchanforderung und Erhalten einer Antwort

Nächste Schritte

Weitere Informationen

Zusätzliche Ressourcen