L'elenco seguente mostra casi d'uso comuni per questo metodo. Passa il mouse sopra un caso d'uso per visualizzarne la descrizione o fai clic su un caso d'uso per caricare valori parametro di esempio in Explorer API. Puoi aprire Explorer API a schermo intero per visualizzare esempi di codice che vengono aggiornati in modo dinamico per riflettere i valori dei parametri inseriti in Spazio di esplorazione.
La tabella seguente mostra casi d'uso comuni per questo metodo. Puoi fare clic sul nome di un caso d'uso per caricare valori parametro di esempio in Explorer API. In alternativa, puoi vedere gli esempi di codice per un caso d'uso nell'Explorer API a schermo intero facendo clic sull'icona del codice sotto il nome di un caso d'uso. Nell'interfaccia utente a schermo intero, puoi aggiornare i valori dei parametri e delle proprietà e gli esempi di codice verranno aggiornati in modo dinamico per riflettere i valori inseriti.
Questo metodo ha un caso d'uso comune, descritto di seguito. I pulsanti sotto la descrizione completano Explorer API con valori di esempio oppure aprono l'Explorer API a schermo intero per mostrare gli esempi di codice che utilizzano quei valori. Inoltre, gli esempi di codice vengono aggiornati in modo dinamico se modifichi i valori.
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. |