Implementierung: Suchanfragen

Die folgenden Beispiele zeigen, wie Sie verschiedene Arten von Suchanfragen in der API V3 ausführen können.

Videos

In diesem Beispiel wird die Methode search.list aufgerufen, um die HD-Videos zu finden, die mit der Suchanfrage „Skatehund“ am häufigsten angesehen werden. Die Abfrage legt die Parameter order, part, q, type und videoDefinition fest.

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

Dieses Beispiel zeigt, wie du Playlists findest, die mit dem Suchbegriff „GoogleDevelopers“ übereinstimmen. Sie ruft die Methode search.list auf und legt den Wert des Parameters type auf playlist fest, sodass die Ergebnismenge nur Playlists enthält.

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

Kanäle

Dieses Beispiel zeigt, wie Sie Kanäle finden, die dem Suchbegriff „travel“ entsprechen. Sie ruft die Methode search.list auf und legt den Wert des Parameters type auf channel fest, sodass die Ergebnismenge 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 dass die API-Antwort Ergebnisse enthalten sollte, die für die französische Sprache (relevanceLanguage=fr) am relevantesten sind.

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

In der Anfrage wird kein Wert für den Parameter type festgelegt. Das bedeutet, dass jedes Suchergebnis auf ein Video, eine Playlist oder einen Kanal verweisen kann.

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

In diesem Beispiel wird gezeigt, wie Sie mit dem Parameter forDeveloper die Suche auf Videos beschränken können, 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: Bei dieser Abfrage werden keine Ergebnisse im APIs Explorer zurückgegeben, da der APIs Explorer keine Videouploads unterstützt. Sie können diese Abfrage für Ihre eigene Anwendung außerhalb des APIs Explorer ausführen, erhalten jedoch mit dem APIs Explorer keine Ergebnisse für Ihre Anwendung.

Jedes hochgeladene Video wird automatisch mit der Projektnummer getaggt, die der App des Entwicklers in der Google API Console zugeordnet ist.

Wenn der Parameter forDeveloper anschließend in einer Suchanfrage auf „true“ gesetzt wird, identifiziert der API-Dienst den Entwickler anhand der Autorisierungsanmeldedaten der Anfrage. Ein Entwickler kann daher die Ergebnisse auf Videos beschränken, die über seine eigene App oder Website hochgeladen wurden, nicht jedoch 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