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
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:
|
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.
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 :
|
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. |