Implementierung: Suchanfragen

Die folgenden Beispiele zeigen, wie verschiedene Arten von Suchanfragen in der Version 3 der API ausgeführt werden.

Videos

In diesem Beispiel wird die Methode search.list aufgerufen, um die meistgesehenen HD-Videos (High Definition) zu finden, die mit der Suchanfrage „skateboarding dog“ verknüpft sind. In der Suchanfrage werden die Parameter order, part, q, type und videoDefinition festgelegt.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &order=viewCount
        &q=skateboarding+dog
        &type=video
        &videoDefinition=high

Codebeispiele finden Sie in der Dokumentation zur Methode search.list.

Playlists

In diesem Beispiel wird gezeigt, wie Sie Playlists finden, die dem Suchbegriff „GoogleDevelopers“ entsprechen. Dazu wird die Methode search.list aufgerufen und der Wert des Parameters type auf playlist gesetzt, sodass das Ergebnis-Set nur Playlists enthält.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

Kanäle

In diesem Beispiel wird gezeigt, wie Sie Kanäle finden, die dem Suchbegriff „travel“ entsprechen. Dazu wird die Methode search.list aufgerufen und der Wert des Parameters type auf channel gesetzt, sodass das Ergebnis-Set nur Kanäle enthält.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

Ergebnisse, die für eine bestimmte Sprache relevant sind

In diesem Beispiel wird die Methode search.list aufgerufen, um Suchergebnisse zu finden, die für eine bestimmte Sprache am relevantesten sind. Das Beispiel zeigt, dass der Suchbegriff marine (q=marine) ist und die API-Antwort Ergebnisse enthalten soll, die für die französische Sprache am relevantesten sind (relevanceLanguage=fr).

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=marine
        &relevanceLanguage=fr

Beachten Sie, dass in der Anfrage kein Wert für den Parameter type festgelegt ist. Das bedeutet, dass sich jedes Suchergebnis auf ein Video, eine Playlist oder einen Kanal beziehen kann.

Videos, die über die App oder Website des Entwicklers hochgeladen wurden

In diesem Beispiel wird gezeigt, wie Sie mit dem Parameter forDeveloper eine Suche so einschränken, dass nur Videos abgerufen werden, die über die App oder Website des Entwicklers hochgeladen wurden. Dieser Parameter kann in Verbindung mit optionalen Suchparametern wie dem Parameter q verwendet werden.

Hinweis:Diese Abfrage gibt im APIs Explorer keine Ergebnisse zurück, da der APIs Explorer keine Video-Uploads unterstützt. Sie können diese Abfrage für Ihre eigene Anwendung außerhalb des APIs Explorer ausführen, aber Sie können mit dem APIs Explorer keine Ergebnisse für Ihre Anwendung abrufen.

Jedes hochgeladene Video wird automatisch mit der Projektnummer getaggt, die mit der Anwendung des Entwicklers in der Google Cloud Console verknüpft ist.

Wenn in einer Suchanfrage der Parameter forDeveloper auf „true“ gesetzt wird, verwendet der API-Dienst die Autorisierungsanmeldedaten der Anfrage, um den Entwickler zu identifizieren. So kann ein Entwickler die Ergebnisse auf Videos beschränken, die über die eigene App oder Website des Entwicklers hochgeladen wurden, nicht aber auf Videos, die über andere Apps oder Websites hochgeladen wurden.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true