Implementación: Solicitudes de búsqueda

En los siguientes ejemplos, se muestra cómo completar varios tipos diferentes de solicitudes de búsqueda en la API de v3.

Videos

En este ejemplo, se llama al método search.list para encontrar los videos en alta definición (HD) más vistos asociados con la búsqueda "perro en patineta". La consulta establece los parámetros order, part, q, type y videoDefinition.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &order=viewCount
        &q=skateboarding+dog
        &type=video
        &videoDefinition=high

Consulta la documentación del método search.list para ver muestras de código.

Playlists

En este ejemplo, se muestra cómo encontrar playlists que coincidan con el término de búsqueda "GoogleDevelopers". Llama al método search.list y establece el valor del parámetro type en playlist para que el conjunto de resultados solo incluya playlists.

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

Canales

En este ejemplo, se muestra cómo encontrar canales que coincidan con el término de búsqueda "viajes". Llama al método search.list y establece el valor del parámetro type en channel para que el conjunto de resultados solo incluya canales.

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

Resultados relevantes para un idioma específico

En este ejemplo, se llama al método search.list para encontrar los resultados de la búsqueda más relevantes para un idioma específico. En el ejemplo, se muestra que el término de la búsqueda es marine (q=marine) y que la respuesta de la API debe contener los resultados más relevantes para el idioma francés (relevanceLanguage=fr).

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

Ten en cuenta que la solicitud no establece un valor para el parámetro type, lo que significa que cada resultado de la búsqueda podría hacer referencia a un video, una playlist o un canal.

Videos subidos a través de la app o el sitio web del desarrollador

En este ejemplo, se muestra cómo usar el parámetro forDeveloper para restringir una búsqueda de modo que solo recupere videos subidos a través de la aplicación o el sitio web del desarrollador. Este parámetro se puede usar junto con parámetros de búsqueda opcionales, como el parámetro q.

Nota: Esta consulta no muestra resultados en el Explorador de APIs porque no admite cargas de video. Puedes ejecutar esta consulta para tu propia aplicación fuera del Explorador de APIs, pero no puedes obtener resultados para tu aplicación con el Explorador de APIs.

Cada video subido se etiqueta automáticamente con el número de proyecto asociado con la aplicación del desarrollador en la Consola de la API de Google.

Cuando una solicitud de búsqueda establece posteriormente el parámetro forDeveloper como verdadero, el servicio de la API usa las credenciales de autorización de la solicitud para identificar al desarrollador. Por lo tanto, un desarrollador puede restringir los resultados a los videos subidos a través de su propia app o sitio web, pero no a los videos subidos a través de otras apps o sitios.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true