Les exemples suivants montrent comment traiter plusieurs types de requêtes de recherche dans la version 3 de l'API.
Vidéos
Cet exemple appelle la méthode search.list
pour trouver les vidéos haute définition (HD) les plus regardées associées à la requête "skateboard". 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 les 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 rechercher des canaux 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 des canaux.
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. Cet exemple montre que le terme de requête est marine (q=marine
) et que la réponse de l'API doit contenir des résultats plus pertinents pour le français (relevanceLanguage=fr
).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Sachez que la demande ne définit aucune valeur pour le paramètre type
. Autrement dit, 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 le site Web ou l'application du développeur
Cet exemple montre comment utiliser le paramètre forDeveloper
pour limiter une recherche afin de récupérer uniquement les vidéos mises en ligne via le site Web ou l'application 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 des 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 importée est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la console API Google.
Lorsqu'une requête de recherche définit ensuite 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 sur son propre site ou application, mais pas à celles envoyées via d'autres applications ou sites.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true