In den folgenden Beispielen wird gezeigt, wie Sie verschiedene Arten von Suchanfragen in der v3 API ausführen.
Videos
In diesem Beispiel wird die search.list-Methode aufgerufen, um die meistgesehenen HD-Videos (High Definition) zu finden, die mit der Suchanfrage „skateboarding dog“ (skateboardender Hund) verknüpft sind. Mit der Abfrage 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 der Methode search.list.
Playlists
In diesem Beispiel wird gezeigt, wie du Playlists findest, die mit dem Suchbegriff „GoogleDevelopers“ übereinstimmen. Dabei wird die Methode search.list aufgerufen und der Wert des Parameters type auf playlist festgelegt, 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
In diesem Beispiel wird gezeigt, wie du Kanäle findest, die dem Suchbegriff „Reisen“ entsprechen. Dabei wird die Methode search.list aufgerufen und der Wert des Parameters type auf channel festgelegt, 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. Im Beispiel ist der Suchbegriff marine (q=marine) und die API-Antwort sollte Ergebnisse enthalten, 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
Hinweis: 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.
Über die App oder Website des Entwicklers hochgeladene Videos
In diesem Beispiel wird gezeigt, wie du mit dem Parameter forDeveloper eine Suche so eingrenzt, 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 q-Parameter verwendet werden.
Hinweis:Diese Abfrage gibt im APIs Explorer keine Ergebnisse zurück, 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, aber keine Ergebnisse für Ihre Anwendung mit dem APIs Explorer abrufen.
Jedes hochgeladene Video wird automatisch mit der Projektnummer getaggt, die der Anwendung des Entwicklers in der Google API Console zugewiesen ist.
Wenn in einer Suchanfrage der Parameter forDeveloper anschließend auf „wahr“ 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, aber nicht 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