Playlists

Une ressource playlist représente une playlist YouTube. Une playlist est un ensemble de vidéos qui peuvent être regardées de manière séquentielle et partagées avec d'autres utilisateurs. Par défaut, les autres utilisateurs peuvent voir les playlists, mais elles peuvent être publiques ou privées.

YouTube utilise également des playlists pour identifier des ensembles de vidéos spécifiques sur une chaîne, par exemple:

• vidéos mises en ligne
• vidéos évalués de façon positive (J'aime)

Vous pouvez récupérer les ID de playlist de chacune de ces listes à partir de channel resource pour une chaîne donnée.

Vous pouvez ensuite utiliser la méthode playlistItems.list pour récupérer l'une de ces listes. Vous pouvez également ajouter ou supprimer des articles de ces listes en appelant les méthodes playlistItems.insert et playlistItems.delete.

Méthodes

L'API accepte les méthodes suivantes pour les ressources playlists:

list

Renvoie une collection de playlists qui correspondent aux paramètres de la requête API. Par exemple, vous pouvez récupérer toutes les playlists dont l'utilisateur authentifié est propriétaire, ou une ou plusieurs playlists par leur ID unique. Essayer

insérer

Crée une playlist. Essayer

mettre à jour

Modifie une playlist. Par exemple, vous pouvez modifier le titre, la description ou le niveau de confidentialité d'une playlist. Essayer

supprimer

Supprime une playlist. Essayer

Représentation des ressources

La structure JSON suivante montre le format d'une ressource playlists:

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind	string Identifie le type de ressource de l'API. La valeur sera youtube#playlist.
etag	etag ETag de cette ressource.
id	string ID que YouTube utilise pour identifier la playlist de façon unique.
snippet	object L'objet snippet contient des informations de base sur la playlist, telles que son titre et sa description.
snippet.publishedAt	datetime Date et heure de création de la playlist. La valeur est spécifiée au format ISO 8601.
snippet.channelId	string L'ID utilisé par YouTube pour identifier de façon unique la chaîne sur laquelle la playlist a été publiée.
snippet.title	string Titre de la playlist.
snippet.description	string Description de la playlist.
snippet.thumbnails	object Vignette associée à la playlist. 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 une ressource faisant référence à une vidéo, telle qu'un élément de playlist ou un résultat de recherche, fait 120 x 90 pixels de haut. La miniature par défaut d'une chaîne fait 88 x 88 pixels. medium : version haute résolution de la vignette. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 x 180 pixels. Pour une chaîne, cette image fait 240 px de large et 240 px de haut. high : version haute résolution de la vignette. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 x 360 pixels. Pour une chaîne, cette image fait 800 x 800 pixels. standard : version de résolution d'image miniature encore plus élevée que l'image de résolution high. Cette image est disponible pour certaines vidéos et autres ressources faisant référence à des vidéos, comme les playlists ou les résultats de recherche. Elle mesure 640 pixels de large et 480 pixels de haut. maxres : version la plus haute résolution de la vignette. Cette taille d'image est disponible pour certaines vidéos et autres ressources faisant référence à des vidéos, telles que des éléments de playlist ou des résultats de recherche. Elle mesure 1 280 pixels de large sur 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 à laquelle appartient la vidéo.
snippet.tags[]	list Cette propriété est obsolète. Mots clés associés à la playlist.
snippet.defaultLanguage	string Langue du texte dans les propriétés snippet.title et snippet.description de la ressource playlist.
snippet.localized	object L'objet snippet.localized contient soit le titre et la description localisés de la playlist, soit le titre en langue par défaut pour les métadonnées de la playlist. Le texte localisé est renvoyé dans l'extrait de ressource si la requête playlists.list a utilisé le paramètre hl pour spécifier la langue pour laquelle le texte localisé doit être renvoyé et si le texte localisé est disponible dans cette langue. Les métadonnées sont renvoyées pour la langue par défaut si aucune valeur de paramètre hl n'est spécifiée ou si une valeur est spécifiée, mais que les métadonnées localisées ne sont pas disponibles pour la langue spécifiée. La propriété contient une valeur en lecture seule. Utilisez l'objet localizations pour ajouter, mettre à jour ou supprimer des titres localisés.
snippet.localized.title	string Titre de la playlist localisée.
snippet.localized.description	string Description de la playlist localisée.
status	object L'objet status contient des informations sur l'état de la playlist.
status.privacyStatus	string État de confidentialité de la playlist. Les valeurs valides pour cette propriété sont les suivantes : private public unlisted
contentDetails	object L'objet contentDetails contient des informations sur le contenu de la playlist, y compris le nombre de vidéos qu'elle contient.
contentDetails.itemCount	unsigned integer Nombre de vidéos dans la playlist.
player	object L'objet player contient les informations que vous utiliseriez pour lire la playlist dans un lecteur intégré.
player.embedHtml	string Une balise <iframe> qui intègre un lecteur qui lit la playlist.
localizations	object L'objet localizations encapsule la traduction des métadonnées de la playlist.
localizations.(key)	object Langue du texte localisé associé à la clé-valeur. La valeur est une chaîne contenant un code de langue BCP-47.
localizations.(key).title	string Titre de la playlist localisée.
localizations.(key).description	string Description de la playlist localisée.