Les exemples suivants montrent comment effectuer plusieurs types de requêtes de recherche différents 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 "skateboarding dog". 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 "travel". 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 des 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 requête 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.
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 mises en ligne via l'application ou le site Web du développeur. Ce paramètre peut être utilisé conjointement avec des paramètres de recherche facultatifs, comme le paramètre q.
Remarque : Cette requête ne renvoie pas de résultats dans APIs Explorer, car celui-ci n'est pas compatible avec les mises en ligne 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 Cloud.
Lorsqu'une requête de recherche définit ensuite le paramètre forDeveloper sur "true", le service 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 sa 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