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