En la siguiente lista, se muestran casos de uso comunes para este método. Coloca el cursor sobre un caso de uso para ver su descripción o haz clic en él para cargar los valores de los parámetros de muestra en el Explorador de APIs. Puedes abrir el Explorador de APIs en pantalla completa para ver muestras de código que se actualizan de forma dinámica para reflejar los valores de los parámetros ingresados en el Explorador.
En la siguiente tabla, se muestran casos de uso comunes para este método. Puedes hacer clic en el nombre de un caso de uso para cargar los valores de parámetros de muestra en el Explorador de APIs. También puedes ver muestras de código de un caso de uso en el Explorador de APIs en pantalla completa haciendo clic en el ícono de código debajo del nombre de un caso de uso. En la IU de pantalla completa, puedes actualizar los valores de los parámetros y las propiedades, y las muestras de código se actualizarán de forma dinámica para reflejar los valores que ingreses.
Este método tiene un caso de uso común, que se describe a continuación. Los botones debajo de la descripción completan el Explorador de APIs con valores de muestra o abren el Explorador de APIs en pantalla completa para mostrar muestras de código que usan esos valores. Las muestras de código también se actualizan de forma dinámica si cambias los valores.
Use cases | |
---|---|
list (by keyword) | This example retrieves the first 25 search results associated with the keyword surfing. By default, the type parameter does not specify a value, which means the response could include videos, playlists, and channels. |
list (by location) | This example retrieves search results associated with the keyword surfing that also specify in their metadata a geographic location within 10 miles of the point identified by the location parameter value. (The sample request specifies a point on the North Shore of Oahu, Hawaii . The request retrieves the top five results, which is the default number returned when the maxResults parameter is not specified. |
list (live events) | This example retrieves a list of active live broadcasts (see the eventType parameter value) that are associated with the keyword news. Since the eventType parameter is set, the request must also set the type parameter value to video . |
list (my videos) | This example searches within the authorized user's videos for videos that match the keyword fun. The forMine parameter indicates that the response should only search within the authorized user's videos. Also, since this request uses the forMine parameter, it must also set the type parameter value to video .If you have not uploaded any videos associated with that term, you will not see any items in the API response list. |