La liste ci-dessous présente des cas d'utilisation courants de cette méthode. Pointez sur un cas d'utilisation pour afficher sa description ou cliquez dessus pour charger des exemples de valeurs de paramètres dans APIs Explorer. Vous pouvez ouvrir l'explorateur d'API en plein écran pour consulter des exemples de code qui se mettent à jour de façon dynamique pour refléter les valeurs de paramètre saisies dans l'explorateur.
Le tableau ci-dessous présente des cas d'utilisation courants de cette méthode. Vous pouvez cliquer sur le nom d'un cas d'utilisation pour charger des exemples de valeurs de paramètres dans APIs Explorer. Vous pouvez également consulter des exemples de code pour un cas d'utilisation dans l'explorateur d'API en plein écran en cliquant sur l'icône de code sous le nom d'un cas d'utilisation. Dans l'interface utilisateur plein écran, vous pouvez mettre à jour les valeurs des paramètres et des propriétés. Les exemples de code seront mis à jour de façon dynamique pour refléter les valeurs saisies.
Cette méthode présente un cas d'utilisation courant, décrit ci-dessous. Les boutons situés sous la description fournissent des exemples de valeurs à APIs Explorer. Vous pouvez aussi ouvrir APIs Explorer en plein écran pour afficher des exemples de code utilisant ces valeurs. Les exemples de code sont également mis à jour de manière dynamique si vous modifiez les valeurs.
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. |