Una risorsa playlistItem
identifica un'altra risorsa, ad esempio un video, inclusa in una playlist. Inoltre, la risorsa playlistItem
contiene dettagli sulla risorsa inclusa che riguardano specificamente il modo in cui la risorsa viene utilizzata nella playlist.
Inoltre, YouTube utilizza una playlist per identificare l'elenco dei video caricati di un canale, dove ogni playlistItem
dell'elenco rappresenta un video caricato. Puoi recuperare
l'ID playlist dell'elenco da channel resource
per un determinato canale. Puoi quindi utilizzare il
metodo playlistItems.list
nell'elenco.
Metodi
L'API supporta i seguenti metodi per le risorse playlistItems
:
- list
- Restituisci una raccolta di elementi della playlist che corrispondono ai parametri della richiesta API. Puoi recuperare tutti gli elementi della playlist in una playlist specificata o recuperare uno o più elementi della playlist tramite i relativi ID univoci. Prova subito.
- inserire
- Aggiunge una risorsa a una playlist. Prova subito.
- aggiornamento
- Modifica un elemento della playlist. Ad esempio, potresti aggiornare la posizione dell'elemento nella playlist. Prova subito.
- elimina
- Elimina un elemento della playlist. Prova subito.
Rappresentazione delle risorse
La seguente struttura JSON mostra il formato di una risorsa playlistItems
:
{ "kind": "youtube#playlistItem", "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, "videoOwnerChannelTitle": string, "videoOwnerChannelId": string, "playlistId": string, "position": unsigned integer, "resourceId": { "kind": string, "videoId": string, } }, "contentDetails": { "videoId": string, "startAt": string, "endAt": string, "note": string, "videoPublishedAt": datetime }, "status": { "privacyStatus": 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#playlistItem . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco l'elemento della playlist. |
snippet |
object L'oggetto snippet contiene i dettagli di base dell'elemento della playlist, come il titolo e la posizione all'interno della playlist. |
snippet.publishedAt |
datetime La data e l'ora in cui l'elemento è stato aggiunto alla playlist. Il valore è specificato nel formato ISO 8601. |
snippet.channelId |
string L'ID utilizzato da YouTube per identificare in modo univoco l'utente che ha aggiunto l'articolo alla playlist. |
snippet.title |
string Il titolo dell'elemento. |
snippet.description |
string La descrizione dell'elemento. |
snippet.thumbnails |
object Una mappa di immagini in miniatura associate all'elemento della 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 l'elemento della playlist. |
snippet.videoOwnerChannelTitle |
string Il titolo del canale che ha caricato questo video. |
snippet.videoOwnerChannelId |
string L'ID del canale che ha caricato questo video. |
snippet.playlistId |
string L'ID utilizzato da YouTube per identificare in modo univoco la playlist in cui si trova l'elemento della playlist. |
snippet.position |
unsigned integer L'ordine in cui l'elemento appare nella playlist. Il valore utilizza un indice in base zero, quindi il primo elemento ha la posizione 0 , il secondo la posizione 1 e così via. |
snippet.resourceId |
object L'oggetto id contiene informazioni che possono essere utilizzate per identificare in modo univoco la risorsa inclusa nella playlist come elemento della playlist. |
snippet.resourceId.kind |
string Il tipo o il tipo della risorsa indicata. |
snippet.resourceId.videoId |
string Se il valore della proprietà snippet.resourceId.kind è youtube#video , questa proprietà sarà presente e il suo valore conterrà l'ID che YouTube utilizza per identificare in modo univoco il video nella playlist. |
contentDetails |
object L'oggetto contentDetails viene incluso nella risorsa se l'elemento è un video di YouTube. L'oggetto contiene informazioni aggiuntive sul video. |
contentDetails.videoId |
string L'ID utilizzato da YouTube per identificare in modo univoco un video. Per recuperare la risorsa video , imposta il parametro di query id su questo valore nella richiesta API. |
contentDetails.startAt |
string Nota: questa proprietà è stata ritirata e, se impostata, il suo valore viene ignorato. Il tempo, misurato in secondi dall'inizio del video, entro il quale deve essere avviata la riproduzione. Il proprietario della playlist può specificare i momenti in cui deve iniziare e interrompere la riproduzione del video quando il video viene riprodotto nel contesto della playlist. Il valore predefinito è 0 . |
contentDetails.endAt |
string Nota: questa proprietà è stata deprecata e, se impostata, il suo valore viene ignorato. Il tempo, misurato in secondi dall'inizio del video, in cui deve essere interrotta la riproduzione. Il proprietario della playlist può specificare i momenti in cui deve iniziare e interrompere la riproduzione del video quando il video viene riprodotto nel contesto della playlist. Per impostazione predefinita, supponiamo che video.endTime sia la fine del video. |
contentDetails.note |
string Una nota generata dall'utente per questo elemento. Il valore della proprietà ha una lunghezza massima di 280 caratteri. |
contentDetails.videoPublishedAt |
datetime La data e l'ora in cui il video è stato pubblicato su YouTube. Il valore è specificato nel formato ISO 8601. |
status |
object L'oggetto status contiene informazioni sullo stato di privacy dell'elemento della playlist. |
status.privacyStatus |
string Lo stato della privacy dell'elemento della playlist. Il canale che ha caricato il video rappresentato dall'elemento della playlist può impostare questo valore utilizzando il metodo videos.insert o videos.update . |