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

Playlists

Une ressource playlist représente une playlist YouTube. Une playlist est un ensemble de vidéos qui peuvent être regardées successivement et partagées avec d'autres utilisateurs. Par défaut, les playlists sont visibles par tous les utilisateurs, mais elles peuvent être publiques ou privées.

YouTube utilise également les playlists pour identifier des collections spéciales de vidéos pour une chaîne. Par exemple:

vidéos mises en ligne
vidéos ayant reçu une note positive

Plus précisément, ces listes sont associées à une chaîne, qui comprend les vidéos, les playlists et d'autres informations YouTube d'une personne, d'un groupe ou d'une entreprise. Vous pouvez récupérer les ID des playlists de chacune de ces listes à partir du fichier channel resource d'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 éléments de ces listes en appelant les méthodes playlistItems.insert et playlistItems.delete.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources playlists:

liste: Renvoie une collection de playlists correspondant aux paramètres de requête API. Par exemple, vous pouvez récupérer toutes les playlists appartenant à l'utilisateur authentifié, ou une ou plusieurs playlists en fonction de leur ID unique. Essayer
insérer: Crée une playlist. Essayer
mise à jour: Modifie une playlist. Par exemple, vous pouvez modifier le titre, la description ou l'état 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 d'API. La valeur est `youtube#playlist`.
`etag`	`etag` Etag de cette ressource.
`id`	`string` ID utilisé par YouTube pour identifier la playlist de façon unique.
`snippet`	`object` L'objet `snippet` contient des informations de base sur la playlist, comme 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` ID utilisé par YouTube pour identifier de façon unique la chaîne ayant publié la playlist.
`snippet.title`	`string` Titre de la playlist.
`snippet.description`	`string` Description de la playlist
`snippet.thumbnails`	`object` Carte des miniatures associées à 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 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 à laquelle appartient la vidéo.
`snippet.tags[]`	`list` Cette propriété est obsolète. Tags de 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 un titre et une description localisés pour la playlist, soit le titre dans la 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 pour la langue par défaut sont renvoyées 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 dont vous avez besoin pour lire la playlist dans un lecteur intégré.
`player.embedHtml`	`string` Une balise `<iframe>` intégrant 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.