Implementación: Solicitudes de búsqueda

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

Videos

En este ejemplo, se llama al método search.list para encontrar los videos más populares y en alta definición (HD) asociados con la búsqueda "perro patinador". 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.

Listas de reproducción

En este ejemplo, se muestra cómo encontrar listas de reproducción 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 listas de reproducción.

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 "viajar". 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 buscar los resultados de la búsqueda más relevantes para un idioma específico. En el ejemplo, se muestra que el término de búsqueda es marine (q=marine) y que la respuesta de la API debe contener los resultados más relevantes para el 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 búsqueda puede hacer referencia a un video, una lista de reproducción o un canal.

Videos subidos mediante la aplicación o el sitio web del programador

En este ejemplo, se muestra cómo usar el parámetro forDeveloper para restringir una búsqueda y recuperar solo los videos subidos a través de la app 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 API porque el Explorador de API no admite la subida de videos. Puede ejecutar esta consulta para su propia aplicación fuera del Explorador de API, pero no puede obtener los resultados de su aplicación mediante el Explorador de API.

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

Cuando una solicitud de búsqueda establece posteriormente el parámetro forDeveloper como verdadero, el servicio de API usa las credenciales de autorización de la solicitud para identificar al desarrollador. Por lo tanto, un desarrollador puede restringir los resultados a videos subidos mediante la app o el sitio web del desarrollador, pero no a 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