Les exemples suivants montrent comment effectuer différents types de requêtes de recherche dans l'API v3.
Vidéos
Cet exemple appelle la méthode search.list pour trouver les vidéos haute définition (HD) les plus vues associées à la requête "chien qui fait du skate". La requête définit les paramètres order, part, q, type et videoDefinition.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Consultez la documentation de la méthode search.list pour obtenir des exemples de code.
Playlists
Cet exemple montre comment trouver des playlists correspondant au terme de requête "GoogleDevelopers". Il appelle la méthode search.list et définit la valeur du paramètre type sur playlist afin que l'ensemble de résultats n'inclue que des playlists.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Chaînes
Cet exemple montre comment trouver des chaînes correspondant au terme de requête "voyage". Il appelle la méthode search.list et définit la valeur du paramètre type sur channel afin que l'ensemble de résultats n'inclue que les chaînes.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Résultats pertinents pour une langue spécifique
Cet exemple appelle la méthode search.list pour trouver les résultats de recherche les plus pertinents pour une langue spécifique. L'exemple montre que le terme de requête est marine (q=marine) et que la réponse de l'API doit contenir les résultats les plus pertinents pour la langue française (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Notez que la demande ne définit pas de valeur pour le paramètre type, ce qui signifie que chaque résultat de recherche peut faire référence à une vidéo, une playlist ou une chaîne.
les vidéos mises en ligne via l'application ou le site Web du développeur ;
Cet exemple montre comment utiliser le paramètre forDeveloper pour limiter une recherche afin de ne récupérer que les vidéos importées via l'application ou le site Web du développeur. Ce paramètre peut être utilisé avec des paramètres de recherche facultatifs, comme le paramètre q.
Remarque:Cette requête ne renvoie pas de résultats dans l'explorateur d'API, car celui-ci n'est pas compatible avec l'importation de vidéos. Vous pouvez exécuter cette requête pour votre propre application en dehors d'APIs Explorer, mais vous ne pouvez pas obtenir de résultats pour votre application à l'aide d'APIs Explorer.
Chaque vidéo mise en ligne est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la console Google APIs.
Lorsqu'une requête de recherche définit ultérieurement le paramètre forDeveloper sur "true", le service d'API utilise les identifiants d'autorisation de la requête pour identifier le développeur. Ainsi, un développeur peut limiter les résultats aux vidéos mises en ligne via son propre application ou son propre site Web, mais pas aux vidéos mises en ligne via d'autres applications ou sites.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true