Cette page a été traduite par l'API Cloud Translation.

Search

Un résultat de recherche contient des informations sur une vidéo, une chaîne ou une playlist YouTube qui correspondent aux paramètres de recherche spécifiés dans une requête API. Bien qu'un résultat de recherche pointe vers une ressource identifiable de manière unique, telle qu'une vidéo, il ne possède pas ses propres données persistantes.

Méthodes

L'API prend en charge les méthodes de recherche suivantes:

liste: 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 ne récupérer qu'un type de ressource spécifique. Essayer maintenant

Représentation des ressources

La structure JSON suivante indique le format d'un résultat de recherche:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

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 ressource d'API. La valeur est `youtube#searchResult`.
`etag`	`etag` Etag de cette ressource.
`id`	`object` L'objet `id` contient des informations permettant d'identifier de manière unique la ressource correspondant à la requête de recherche.
`id.kind`	`string` Type de la ressource API.
`id.videoId`	`string` Si la valeur de la propriété `id.type` est `youtube#video`, cette propriété sera présente et sa valeur contiendra l'ID utilisé par YouTube pour identifier de façon unique une vidéo correspondant à la requête de recherche.
`id.channelId`	`string` Si la valeur de la propriété `id.type` est `youtube#channel`, cette propriété sera présente et sa valeur contiendra l'ID utilisé par YouTube pour identifier de façon unique une chaîne correspondant à la requête de recherche.
`id.playlistId`	`string` Si la valeur de la propriété `id.type` est `youtube#playlist`, cette propriété sera présente et sa valeur contiendra l'ID utilisé par YouTube pour identifier de façon unique une playlist correspondant à la requête de recherche.
`snippet`	`object` L'objet `snippet` contient des informations de base sur un résultat de recherche, telles que son titre ou sa description. Par exemple, si le résultat de la recherche est une vidéo, le titre correspondra au titre de la vidéo et la description à la description.
`snippet.publishedAt`	`datetime` Date et heure de création de la ressource identifiée par le résultat de recherche. La valeur est spécifiée au format ISO 8601.
`snippet.channelId`	`string` Valeur utilisée par YouTube pour identifier de façon unique la chaîne ayant publié la ressource identifiée par le résultat de recherche.
`snippet.title`	`string` Titre du résultat de recherche.
`snippet.description`	`string` Description du résultat de recherche.
`snippet.thumbnails`	`object` Carte de vignettes associées au résultat de recherche. Pour chaque objet de la carte, la clé est le nom de la vignette et la valeur est un objet contenant d'autres informations sur la vignette.
`snippet.thumbnails.(key)`	`object` Les clés-valeurs valides sont les suivantes: `default` : vignette par défaut La miniature par défaut d'une vidéo (ou d'une ressource faisant référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large et 90 pixels de haut. La miniature par défaut d'une chaîne fait 88 pixels de large et 88 pixels de haut. `medium` : version de la miniature dans une résolution plus élevée. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large et 180 pixels de haut. Pour une chaîne, elle mesure 240 pixels de large et 240 pixels de haut. `high` : version haute résolution de l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large et 360 pixels de haut. Pour une chaîne, elle mesure 800 pixels de large et 800 pixels de haut. `standard` : version de l'image miniature dans une résolution encore supérieure à celle de l'image avec une résolution `high`. Cette image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 640 pixels de large et 480 pixels de haut. `maxres` : version de la miniature avec la résolution la plus élevée. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 1 280 pixels de large et 720 pixels de haut.
`snippet.thumbnails.(key).url`	`string` URL de l'image.
`snippet.thumbnails.(key).width`	`unsigned integer` Largeur de l'image.
`snippet.thumbnails.(key).height`	`unsigned integer` Hauteur de l'image.
`snippet.channelTitle`	`string` Titre de la chaîne ayant publié la ressource identifiée par le résultat de recherche.
`snippet.liveBroadcastContent`	`string` Indique si une ressource `video` ou `channel` comporte du contenu diffusé en direct. Les valeurs de propriété valides sont `upcoming`, `live` et `none`. Pour une ressource `video`, la valeur `upcoming` indique que la vidéo est une diffusion en direct qui n'a pas encore commencé, tandis que la valeur `live` indique qu'il s'agit d'une diffusion en direct active. Pour une ressource `channel`, la valeur `upcoming` indique que la chaîne a une diffusion programmée qui n'a pas encore commencé, tandis qu'une valeur de `live` indique que la chaîne dispose d'une diffusion en direct active.