Una risorsa playlist
rappresenta una playlist di YouTube. Una playlist è una raccolta di video che può essere visualizzata in sequenza e condivisa con altri utenti. Per impostazione predefinita, le playlist sono visibili pubblicamente agli altri utenti, ma possono essere pubbliche o private.
Inoltre, YouTube utilizza le playlist per identificare raccolte speciali di video per un canale, ad esempio:
- video caricati
- video con valutazioni positive (Mi piace)
channel resource
di un determinato canale.Puoi quindi utilizzare il metodo
playlistItems.list
per recuperare uno di questi elenchi. Puoi anche aggiungere o rimuovere elementi da questi elenchi chiamando i metodi playlistItems.insert
e playlistItems.delete
.
Metodi
L'API supporta i seguenti metodi per le risorse playlists
:
- list
- Restituisci una raccolta di playlist che corrispondono ai parametri della richiesta API. Ad esempio, puoi recuperare tutte le playlist di proprietà dell'utente autenticato oppure puoi recuperare una o più playlist in base ai relativi ID univoci. Prova subito.
- inserire
- Crea una playlist. Prova subito.
- aggiornamento
- Modifica una playlist. Ad esempio, potresti modificare il titolo, la descrizione o lo stato di privacy di una playlist. Prova subito.
- elimina
- Elimina una playlist. Prova subito.
Rappresentazione delle risorse
La seguente struttura JSON mostra il formato di una risorsa 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 } } }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#playlist . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco la playlist. |
snippet |
object L'oggetto snippet contiene i dettagli di base della playlist, come il titolo e la descrizione. |
snippet.publishedAt |
datetime La data e l'ora di creazione della playlist. Il valore è specificato nel formato ISO 8601. |
snippet.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale che ha pubblicato la playlist. |
snippet.title |
string Il titolo della playlist. |
snippet.description |
string La descrizione della playlist. |
snippet.thumbnails |
object Una mappa di immagini in miniatura associate alla playlist. Per ogni oggetto nella mappa, la chiave corrisponde al nome dell'immagine in miniatura, mentre il valore corrisponde a un oggetto contenente altre informazioni sulla miniatura. |
snippet.thumbnails.(key) |
object Le coppie chiave-valore valide sono:
|
snippet.thumbnails.(key).url |
string L'URL dell'immagine. |
snippet.thumbnails.(key).width |
unsigned integer La larghezza dell'immagine. |
snippet.thumbnails.(key).height |
unsigned integer L'altezza dell'immagine. |
snippet.channelTitle |
string Il titolo del canale a cui appartiene il video. |
snippet.tags[] |
list Questa proprietà è stata ritirata. Tag di parole chiave associati alla playlist. |
snippet.defaultLanguage |
string La lingua del testo nelle proprietà snippet.title e snippet.description della risorsa playlist . |
snippet.localized |
object L'oggetto snippet.localized contiene un titolo e una descrizione localizzati della playlist oppure il titolo nella lingua predefinita dei metadati della playlist.
localizations per aggiungere, aggiornare o eliminare titoli localizzati. |
snippet.localized.title |
string Il titolo localizzato della playlist. |
snippet.localized.description |
string La descrizione localizzata della playlist. |
status |
object L'oggetto status contiene informazioni sullo stato della playlist. |
status.privacyStatus |
string Stato della privacy della playlist. I valori validi per questa proprietà sono:
|
contentDetails |
object L'oggetto contentDetails contiene informazioni sui contenuti della playlist, incluso il numero di video al suo interno. |
contentDetails.itemCount |
unsigned integer Il numero di video nella playlist. |
player |
object L'oggetto player contiene informazioni che useresti per riprodurre la playlist in un player incorporato. |
player.embedHtml |
string Un tag <iframe> che incorpora un player che riproduce la playlist. |
localizations |
object L'oggetto localizations racchiude le traduzioni dei metadati della playlist. |
localizations.(key) |
object La lingua del testo localizzato associato alla coppia chiave-valore. Il valore è una stringa che contiene un codice lingua BCP-47. |
localizations.(key).title |
string Il titolo localizzato della playlist. |
localizations.(key).description |
string La descrizione localizzata della playlist. |