Search: list

Renvoie une collection de résultats de recherche correspondant aux paramètres de requête spécifiés dans la requête API. Par défaut, un ensemble de résultats de recherche identifie les ressources video, channel et playlist correspondantes, mais vous pouvez également configurer des requêtes pour n'extraire qu'un type de ressource spécifique.

Impact sur le quota : 100 appels par jour. Un appel à cette méthode a un coût de quota d'une unité dans le bucket de quota "Requêtes de recherche".

Cas d'utilisation courants

Requête

Requête HTTP

GET https://www.googleapis.com/youtube/v3/search

Paramètres

Le tableau suivant liste les paramètres acceptés par cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
part string
Le paramètre part spécifie une liste d'une ou plusieurs propriétés de ressource search, séparées par une virgule, que la réponse de l'API inclura. Définissez la valeur du paramètre sur snippet.
Filtres (spécifiez 0 ou 1 des paramètres suivants)
forContentOwner boolean
Ce paramètre ne peut être utilisé que dans une requête autorisée et est destiné exclusivement aux partenaires de contenu YouTube.

Le paramètre forContentOwner limite la recherche aux vidéos appartenant au propriétaire de contenu identifié par le paramètre onBehalfOfContentOwner. Si forContentOwner est défini sur "true", la demande doit également répondre aux exigences suivantes :
  • Le paramètre onBehalfOfContentOwner est obligatoire.
  • L'utilisateur qui autorise la demande doit utiliser un compte associé au propriétaire du contenu spécifié.
  • La valeur du paramètre type doit être définie sur video.
  • Aucun des autres paramètres suivants ne peut être défini : videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType.
forDeveloper boolean
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Le paramètre forDeveloper limite la recherche aux vidéos mises en ligne via l'application ou le site Web du développeur. Le serveur d'API utilise les identifiants d'autorisation de la requête pour identifier le développeur. Le paramètre forDeveloper peut être utilisé conjointement avec des paramètres de recherche facultatifs tels que le paramètre q.

Pour cette fonctionnalité, chaque vidéo importée est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la Google Developers Console.

Lorsqu'une requête de recherche définit ensuite le paramètre forDeveloper sur true, le serveur d'API utilise les identifiants d'autorisation de la requête pour identifier le développeur. Par conséquent, un développeur peut limiter les résultats aux vidéos mises en ligne via sa propre application ou son propre site Web, mais pas aux vidéos mises en ligne via d'autres applications ou sites.
forMine boolean
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Le paramètre forMine limite la recherche aux vidéos appartenant à l'utilisateur authentifié. Si vous définissez ce paramètre sur true, la valeur du paramètre type doit également être définie sur video. De plus, aucun des autres paramètres suivants ne peut être défini dans la même requête : videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType.
Paramètres facultatifs
channelId string
Le paramètre channelId indique que la réponse de l'API ne doit contenir que les ressources créées par la chaîne.

Remarque : Les résultats de recherche sont limités à un maximum de 500 vidéos si votre requête spécifie une valeur pour le paramètre channelId et définit la valeur du paramètre type sur video, mais qu'elle ne définit pas également l'un des filtres forContentOwner, forDeveloper ou forMine.
channelType string
Le paramètre channelType vous permet de limiter une recherche à un type de chaîne particulier.

Les valeurs acceptées sont les suivantes :
  • any : renvoie tous les canaux.
  • show : n'affiche que les séries.
eventType string
Le paramètre eventType limite la recherche aux événements diffusés. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • completed : n'incluez que les diffusions terminées.
  • live : n'inclut que les diffusions actives.
  • upcoming : n'inclut que les diffusions à venir.
location string
Le paramètre location, associé au paramètre locationRadius, définit une zone géographique circulaire et limite également la recherche aux vidéos qui spécifient, dans leurs métadonnées, un emplacement géographique situé dans cette zone. La valeur du paramètre est une chaîne qui spécifie les coordonnées de latitude/longitude, par exemple (37.42307,-122.08427).

  • La valeur du paramètre location identifie le point au centre de la zone.
  • Le paramètre locationRadius spécifie la distance maximale à laquelle le lieu associé à une vidéo peut se trouver par rapport à ce point pour que la vidéo soit toujours incluse dans les résultats de recherche.
L'API renvoie une erreur si votre requête spécifie une valeur pour le paramètre location, mais pas pour le paramètre locationRadius.

Remarque : Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.
locationRadius string
Le paramètre locationRadius, associé au paramètre location, définit une zone géographique circulaire.

La valeur de paramètre doit être un nombre à virgule flottante suivi d'une unité de mesure. Les unités de mesure valides sont m, km, ft et mi. Par exemple, les valeurs de paramètre valides incluent 1500m, 5km, 10000ft et 0.75mi. L'API n'accepte pas les valeurs de paramètre locationRadius supérieures à 1 000 kilomètres.

Remarque : Pour en savoir plus, consultez la définition du paramètre location.
maxResults unsigned integer
Le paramètre maxResults spécifie le nombre maximal d'éléments à renvoyer dans l'ensemble de résultats. Les valeurs acceptées sont comprises entre 0 et 50 inclus. La valeur par défaut est 5.

onBehalfOfContentOwner string
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Remarque : Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.

Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire de contenu spécifié dans la valeur de paramètre. Ce paramètre est destiné aux partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leurs chaînes, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.
order string
Le paramètre order spécifie la méthode qui sera utilisée pour classer les ressources dans la réponse de l'API. La valeur par défaut est relevance.

Les valeurs acceptées sont les suivantes :
  • date : les ressources sont triées par ordre chronologique inverse en fonction de leur date de création. Remarque : Comme cette fonctionnalité repose sur l'index de recherche, vous pouvez rencontrer des retards d'indexation pour les nouveaux contenus ou recevoir des ensembles de résultats incomplets. Pour récupérer de manière fiable les vidéos les plus récemment mises en ligne d'une chaîne, n'utilisez pas search.list. Utilisez plutôt la méthode playlistItems.list pour récupérer la playlist des vidéos mises en ligne de la chaîne.
  • rating : les ressources sont triées de la note la plus élevée à la plus basse. Remarque : Cette note est calculée à l'aide d'un score algorithmique interne et n'est pas strictement équivalente à un nombre décroissant de "J'aime".
  • relevance : les ressources sont triées en fonction de leur pertinence par rapport à la requête de recherche. Il s'agit de la valeur par défaut de ce paramètre.
  • title : les ressources sont triées par ordre alphabétique de titre.
  • videoCount : les chaînes sont triées par ordre décroissant du nombre de vidéos mises en ligne.
  • viewCount : les ressources sont triées du plus grand au plus petit nombre de vues. Pour les diffusions en direct, les vidéos sont triées par nombre de spectateurs simultanés pendant la diffusion.
pageToken string
Le paramètre pageToken identifie une page spécifique de l'ensemble de résultats à renvoyer. Dans une réponse de l'API, les propriétés nextPageToken et prevPageToken identifient d'autres pages qui pourraient être récupérées.
publishedAfter datetime
Le paramètre publishedAfter indique que la réponse de l'API ne doit contenir que les ressources créées à l'heure spécifiée ou après. La valeur est une date et une heure au format RFC 3339 (1970-01-01T00:00:00Z).
publishedBefore datetime
Le paramètre publishedBefore indique que la réponse de l'API ne doit contenir que les ressources créées avant ou à l'heure spécifiée. La valeur est une valeur de date et d'heure au format RFC 3339 (1970-01-01T00:00:00Z).
q string
Le paramètre q spécifie le terme de requête à rechercher.

Votre requête peut également utiliser les opérateurs booléens NOT (-) et OR (|) pour exclure des vidéos ou pour trouver des vidéos associées à l'un des termes de recherche. Par exemple, pour rechercher des vidéos correspondant à "nautisme" ou "voile", définissez la valeur du paramètre q sur boating|sailing. De même, pour rechercher des vidéos correspondant à "boating" ou "sailing", mais pas à "fishing", définissez la valeur du paramètre q sur boating|sailing -fishing. Notez que le caractère barre verticale doit être échappé au format URL lorsqu'il est envoyé dans votre requête API. La valeur d'échappement d'URL pour le caractère barre verticale est %7C.
regionCode string
Le paramètre regionCode indique à l'API de renvoyer les résultats de recherche pour les vidéos pouvant être visionnées dans le pays spécifié. La valeur du paramètre est un code pays ISO 3166-1 alpha-2.
relevanceLanguage string
Le paramètre relevanceLanguage indique à l'API de renvoyer les résultats de recherche les plus pertinents pour la langue spécifiée. La valeur du paramètre est généralement un code de langue à deux lettres ISO 639-1. Toutefois, vous devez utiliser les valeurs zh-Hans pour le chinois simplifié et zh-Hant pour le chinois traditionnel. Notez que les résultats dans d'autres langues seront toujours renvoyés s'ils sont très pertinents par rapport au terme de la requête de recherche.
safeSearch string
Le paramètre safeSearch indique si les résultats de recherche doivent inclure du contenu soumis à restriction en plus du contenu standard.

Les valeurs acceptées sont les suivantes :
  • moderate : YouTube filtre certains contenus des résultats de recherche, et au minimum ceux qui sont soumis à des restrictions dans votre pays. En fonction de leur contenu, les résultats de recherche peuvent être supprimés ou rétrogradés. Il s'agit de la valeur de paramètre par défaut.
  • none : YouTube ne filtre pas les résultats de recherche.
  • strict : YouTube essaiera d'exclure tous les contenus soumis à restriction de l'ensemble des résultats de recherche. En fonction de leur contenu, les résultats de recherche peuvent être supprimés ou rétrogradés dans les résultats de recherche.
topicId string
Le paramètre topicId indique que la réponse de l'API ne doit contenir que les ressources associées au sujet spécifié. La valeur identifie un ID de sujet Freebase.

Important : En raison de l'abandon de Freebase et de l'API Freebase, le paramètre topicId fonctionne différemment depuis le 27 février 2017. À cette date, YouTube a commencé à accepter un petit ensemble d'ID de thèmes sélectionnés, et vous ne pouvez utiliser que cet ensemble d'ID comme valeurs pour ce paramètre.

type string
Le paramètre type limite une requête de recherche pour ne récupérer qu'un type de ressource particulier. La valeur est une liste de types de ressources séparés par une virgule. La valeur par défaut est video,channel,playlist.

Les valeurs acceptées sont les suivantes :
  • channel
  • playlist
  • video
videoCaption string
Le paramètre videoCaption indique si l'API doit filtrer les résultats de recherche de vidéos en fonction de la présence ou non de sous-titres. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : ne filtre pas les résultats en fonction de la disponibilité des sous-titres.
  • closedCaption : n'inclure que les vidéos sous-titrées.
  • none : n'incluez que les vidéos sans sous-titres.
videoCategoryId string
Le paramètre videoCategoryId filtre les résultats de recherche de vidéos en fonction de leur catégorie. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.
videoDefinition string
Le paramètre videoDefinition vous permet de limiter une recherche pour n'inclure que des vidéos en haute définition (HD) ou en définition standard (SD). Les vidéos HD sont disponibles en résolution 720p au minimum, mais des résolutions supérieures, comme 1080p, peuvent également être disponibles. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : renvoie toutes les vidéos, quelle que soit leur résolution.
  • high : ne récupérer que les vidéos HD.
  • standard : n'extraire que les vidéos en définition standard.
videoDimension string
Le paramètre videoDimension vous permet de limiter une recherche pour ne récupérer que des vidéos 2D ou 3D. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • 2d : restreint les résultats de recherche pour exclure les vidéos en 3D.
  • 3d : limite les résultats de recherche aux vidéos en 3D.
  • any : inclut les vidéos 3D et non 3D dans les résultats renvoyés. Il s'agit de la valeur par défaut.
videoDuration string
Le paramètre videoDuration filtre les résultats de recherche de vidéos en fonction de leur durée. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : ne filtre pas les résultats de recherche de vidéos en fonction de leur durée. Il s'agit de la valeur par défaut.
  • long : n'inclure que les vidéos de plus de 20 minutes.
  • medium : n'incluez que les vidéos d'une durée comprise entre 4 et 20 minutes (incluses).
  • short : n'incluez que des vidéos de moins de quatre minutes.
videoEmbeddable string
Le paramètre videoEmbeddable vous permet de limiter une recherche aux vidéos pouvant être intégrées à une page Web. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : renvoie toutes les vidéos, qu'elles soient intégrables ou non.
  • true : n'affiche que les vidéos intégrables.
videoLicense string
Le paramètre videoLicense filtre les résultats de recherche pour n'inclure que les vidéos associées à une licence particulière. YouTube permet aux utilisateurs qui mettent en ligne des vidéos de choisir d'associer la licence Creative Commons ou la licence YouTube standard à chacune de leurs vidéos. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : renvoie toutes les vidéos correspondant aux paramètres de requête, quelle que soit leur licence.
  • creativeCommon : n'affiche que les vidéos sous licence Creative Commons. Les utilisateurs peuvent réutiliser les vidéos sous cette licence dans d'autres vidéos qu'ils créent. En savoir plus
  • youtube : ne renvoie que les vidéos disposant de la licence YouTube standard.
videoPaidProductPlacement string
Le paramètre videoPaidProductPlacement filtre les résultats de recherche pour n'inclure que les vidéos que le créateur a indiquées comme comportant une promotion rémunérée. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : renvoie toutes les vidéos, qu'elles contiennent ou non des promotions rémunérées.
  • true : n'extraire que les vidéos contenant des promotions rémunérées.
videoSyndicated string
Le paramètre videoSyndicated vous permet de limiter une recherche aux vidéos pouvant être lues en dehors de youtube.com. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptées sont les suivantes :
  • any : renvoie toutes les vidéos, syndiquées ou non.
  • true : ne récupérer que les vidéos syndiquées.
videoType string
Le paramètre videoType vous permet de limiter une recherche à un type de vidéos en particulier. Si vous spécifiez une valeur pour ce paramètre, vous devez également définir la valeur du paramètre type sur video.

Les valeurs acceptables sont les suivantes :
  • any : renvoie toutes les vidéos.
  • episode : ne récupère que les épisodes d'émissions.
  • movie : ne récupère que les films.

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "youtube#searchListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "regionCode": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    search Resource
  ]
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans un résultat de recherche :

Propriétés
kind string
Identifie le type de la ressource d'API. La valeur sera youtube#searchListResponse.
etag etag
Etag de cette ressource.
nextPageToken string
Jeton pouvant être utilisé comme valeur du paramètre pageToken pour récupérer la page suivante de l'ensemble de résultats.
prevPageToken string
Jeton pouvant être utilisé comme valeur du paramètre pageToken pour récupérer la page précédente de l'ensemble de résultats.
regionCode string
Code de région utilisé pour la requête de recherche. La valeur de la propriété est un code pays ISO à deux lettres qui identifie la région. La méthode i18nRegions.list renvoie une liste de régions prises en charge. La valeur par défaut est US. Si une région non compatible est spécifiée, YouTube peut tout de même sélectionner une autre région que la valeur par défaut pour traiter la requête.
pageInfo object
L'objet pageInfo encapsule les informations de pagination pour l'ensemble de résultats.
pageInfo.totalResults integer
Nombre total de résultats dans l'ensemble de résultats.Veuillez noter que la valeur est une approximation et peut ne pas représenter une valeur exacte. De plus, la valeur maximale est de 1 000 000.

Vous ne devez pas utiliser cette valeur pour créer des liens de pagination. Utilisez plutôt les valeurs des propriétés nextPageToken et prevPageToken pour déterminer s'il faut afficher des liens de pagination.
pageInfo.resultsPerPage integer
Nombre de résultats inclus dans la réponse de l'API.
items[] list
Liste des résultats correspondant aux critères de recherche.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code suivants. Consultez la documentation sur les bibliothèques clientes pour obtenir la liste des langages compatibles.

Apps Script

Cette fonction recherche des vidéos liées au mot clé "chiens". Les ID vidéo et les titres des résultats de recherche sont consignés dans le journal d'Apps Script.

Notez que cet exemple limite les résultats à 25. Pour obtenir plus de résultats, transmettez des paramètres supplémentaires comme indiqué ici : https://developers.google.com/youtube/data/reference/rest/v3/search/list
function searchByKeyword() {
  var results = YouTube.Search.list('id,snippet', {q: 'dogs', maxResults: 25});

  for(var i in results.items) {
    var item = results.items[i];
    Logger.log('[%s] Title: %s', item.id.videoId, item.snippet.title);
  }
}

Go

Cet exemple de code appelle la méthode search.list de l'API pour récupérer les résultats de recherche associés à un mot clé particulier.

Cet exemple utilise la bibliothèque cliente Go.

package main

import (
	"flag"
	"fmt"
	"log"
	"net/http"

	"google.golang.org/api/googleapi/transport"
	"google.golang.org/api/youtube/v3"
)

var (
	query      = flag.String("query", "Google", "Search term")
	maxResults = flag.Int64("max-results", 25, "Max YouTube results")
)

const developerKey = "YOUR DEVELOPER KEY"

func main() {
	flag.Parse()

	client := &http.Client{
		Transport: &transport.APIKey{Key: developerKey},
	}

	service, err := youtube.New(client)
	if err != nil {
		log.Fatalf("Error creating new YouTube client: %v", err)
	}

	// Make the API call to YouTube.
	call := service.Search.List("id,snippet").
		Q(*query).
		MaxResults(*maxResults)
	response, err := call.Do()
	handleError(err, "")

	// Group video, channel, and playlist results in separate lists.
	videos := make(map[string]string)
	channels := make(map[string]string)
	playlists := make(map[string]string)

	// Iterate through each item and add it to the correct list.
	for _, item := range response.Items {
		switch item.Id.Kind {
		case "youtube#video":
			videos[item.Id.VideoId] = item.Snippet.Title
		case "youtube#channel":
			channels[item.Id.ChannelId] = item.Snippet.Title
		case "youtube#playlist":
			playlists[item.Id.PlaylistId] = item.Snippet.Title
		}
	}

	printIDs("Videos", videos)
	printIDs("Channels", channels)
	printIDs("Playlists", playlists)
}

// Print the ID and title of each result in a list as well as a name that
// identifies the list. For example, print the word section name "Videos"
// above a list of video search results, followed by the video ID and title
// of each matching video.
func printIDs(sectionName string, matches map[string]string) {
	fmt.Printf("%v:\n", sectionName)
	for id, title := range matches {
		fmt.Printf("[%v] %v\n", id, title)
	}
	fmt.Printf("\n\n")
}

.NET

L'exemple de code suivant appelle la méthode search.list de l'API pour récupérer les résultats de recherche associés à un mot clé particulier.

Cet exemple utilise la bibliothèque cliente.NET.

using System;
using System.Collections.Generic;
using System.IO;
using System.Reflection;
using System.Threading;
using System.Threading.Tasks;

using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using Google.Apis.Upload;
using Google.Apis.Util.Store;
using Google.Apis.YouTube.v3;
using Google.Apis.YouTube.v3.Data;

namespace Google.Apis.YouTube.Samples
{
  /// <summary>
  /// YouTube Data API v3 sample: search by keyword.
  /// Relies on the Google APIs Client Library for .NET, v1.7.0 or higher.
  /// See https://developers.google.com/api-client-library/dotnet/get_started
  ///
  /// Set ApiKey to the API key value from the APIs & auth > Registered apps tab of
  ///   https://cloud.google.com/console
  /// Please ensure that you have enabled the YouTube Data API for your project.
  /// </summary>
  internal class Search
  {
    [STAThread]
    static void Main(string[] args)
    {
      Console.WriteLine("YouTube Data API: Search");
      Console.WriteLine("========================");

      try
      {
        new Search().Run().Wait();
      }
      catch (AggregateException ex)
      {
        foreach (var e in ex.InnerExceptions)
        {
          Console.WriteLine("Error: " + e.Message);
        }
      }

      Console.WriteLine("Press any key to continue...");
      Console.ReadKey();
    }

    private async Task Run()
    {
      var youtubeService = new YouTubeService(new BaseClientService.Initializer()
      {
        ApiKey = "REPLACE_ME",
        ApplicationName = this.GetType().ToString()
      });

      var searchListRequest = youtubeService.Search.List("snippet");
      searchListRequest.Q = "Google"; // Replace with your search term.
      searchListRequest.MaxResults = 50;

      // Call the search.list method to retrieve results matching the specified query term.
      var searchListResponse = await searchListRequest.ExecuteAsync();

      List<string> videos = new List<string>();
      List<string> channels = new List<string>();
      List<string> playlists = new List<string>();

      // Add each result to the appropriate list, and then display the lists of
      // matching videos, channels, and playlists.
      foreach (var searchResult in searchListResponse.Items)
      {
        switch (searchResult.Id.Kind)
        {
          case "youtube#video":
            videos.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.VideoId));
            break;

          case "youtube#channel":
            channels.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.ChannelId));
            break;

          case "youtube#playlist":
            playlists.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.PlaylistId));
            break;
        }
      }

      Console.WriteLine(String.Format("Videos:\n{0}\n", string.Join("\n", videos)));
      Console.WriteLine(String.Format("Channels:\n{0}\n", string.Join("\n", channels)));
      Console.WriteLine(String.Format("Playlists:\n{0}\n", string.Join("\n", playlists)));
    }
  }
}

Ruby

Cet exemple appelle la méthode search.list de l'API pour récupérer les résultats de recherche associés à un mot clé spécifique.

Cet exemple utilise la bibliothèque cliente Ruby.

#!/usr/bin/ruby

require 'rubygems'
gem 'google-api-client', '>0.7'
require 'google/api_client'
require 'trollop'

# Set DEVELOPER_KEY to the API key value from the APIs & auth > Credentials
# tab of
# {{ Google Cloud Console }} <{{ https://cloud.google.com/console }}>
# Please ensure that you have enabled the YouTube Data API for your project.
DEVELOPER_KEY = 'REPLACE_ME'
YOUTUBE_API_SERVICE_NAME = 'youtube'
YOUTUBE_API_VERSION = 'v3'

def get_service
  client = Google::APIClient.new(
    :key => DEVELOPER_KEY,
    :authorization => nil,
    :application_name => $PROGRAM_NAME,
    :application_version => '1.0.0'
  )
  youtube = client.discovered_api(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION)

  return client, youtube
end

def main
  opts = Trollop::options do
    opt :q, 'Search term', :type => String, :default => 'Google'
    opt :max_results, 'Max results', :type => :int, :default => 25
  end

  client, youtube = get_service

  begin
    # Call the search.list method to retrieve results matching the specified
    # query term.
    search_response = client.execute!(
      :api_method => youtube.search.list,
      :parameters => {
        :part => 'snippet',
        :q => opts[:q],
        :maxResults => opts[:max_results]
      }
    )

    videos = []
    channels = []
    playlists = []

    # Add each result to the appropriate list, and then display the lists of
    # matching videos, channels, and playlists.
    search_response.data.items.each do |search_result|
      case search_result.id.kind
        when 'youtube#video'
          videos << "#{search_result.snippet.title} (#{search_result.id.videoId})"
        when 'youtube#channel'
          channels << "#{search_result.snippet.title} (#{search_result.id.channelId})"
        when 'youtube#playlist'
          playlists << "#{search_result.snippet.title} (#{search_result.id.playlistId})"
      end
    end

    puts "Videos:\n", videos, "\n"
    puts "Channels:\n", channels, "\n"
    puts "Playlists:\n", playlists, "\n"
  rescue Google::APIClient::TransmissionError => e
    puts e.result.body
  end
end

main

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur Détail de l'erreur Description
badRequest (400) invalidChannelId Le paramètre channelId a spécifié un ID de chaîne non valide.
badRequest (400) invalidLocation La valeur du paramètre location et/ou locationRadius n'est pas au bon format.
badRequest (400) invalidRelevanceLanguage La valeur du paramètre relevanceLanguage n'est pas au bon format.
badRequest (400) invalidSearchFilter La requête contient une combinaison non valide de filtres de recherche et/ou de restrictions. Notez que vous devez définir le paramètre type sur video si vous définissez les paramètres forContentOwner ou forMine sur true. Vous devez également définir le paramètre type sur video si vous définissez une valeur pour les paramètres eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated ou videoType.

Essayer

Utilisez APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.