PlaylistItems

Una risorsa playlistItem identifica un'altra risorsa, ad esempio un video, incluso in una playlist. Inoltre, la risorsa playlistItem contiene dettagli sulla risorsa inclusa che riguardano specificamente il modo in cui viene utilizzata nella playlist.

YouTube utilizza anche una playlist per identificare l'elenco dei video caricati di un canale, con ogni playlistItem nell'elenco che rappresenta un video caricato. Puoi recuperare l'ID della playlist dall'elenco della risorsa channel per un determinato canale. Puoi quindi utilizzare il metodo playlistItems.list per l'elenco.

Metodi

L'API supporta i seguenti metodi per le risorse playlistItems:

list
Restituisce una raccolta di elementi della playlist che corrispondono ai parametri della richiesta API. Puoi recuperare tutti gli elementi di una playlist specificata o uno o più elementi della playlist in base ai loro ID univoci. Prova subito.
insert
Aggiunge una risorsa a una playlist. Prova subito.
aggiornamento
Modifica un elemento della playlist. Ad esempio, puoi 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 che YouTube utilizza 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 nella 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'elemento alla playlist.
snippet.title string
Il titolo dell'articolo.
snippet.description string
La descrizione dell'articolo.
snippet.thumbnails object
Una mappa delle miniature associate all'elemento della playlist. Per ogni oggetto nella mappa, la chiave è il nome dell'immagine in miniatura e il valore è un oggetto che contiene altre informazioni sulla miniatura.
snippet.thumbnails.(key) object
I valori chiave validi sono:
  • default: l'immagine in miniatura predefinita. La miniatura predefinita per un video o una risorsa che fa riferimento a un video, ad esempio un elemento di una playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale è larga 88 px e alta 88 px.
  • medium: una versione a risoluzione più elevata dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine misura 240 px di larghezza e 240 px di altezza.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine ha una larghezza di 800 px e un'altezza di 800 px.
  • standard: una versione dell'immagine in miniatura con una risoluzione ancora più alta rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine ha una larghezza di 640 px e un'altezza di 480 px.
  • maxres: la versione con la risoluzione più alta dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine ha una larghezza di 1280 px e un'altezza di 720 px.
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 che YouTube utilizza 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 viene visualizzato nella playlist. Il valore utilizza un indice basato su zero, quindi il primo elemento ha una posizione di 0, il secondo elemento ha una posizione di 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 di risorsa a cui viene fatto riferimento.
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 è incluso nella risorsa se l'elemento incluso è 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 relativo valore viene ignorato.

Il tempo, misurato in secondi dall'inizio del video, in cui il video deve iniziare la riproduzione. Il proprietario della playlist può specificare gli orari in cui il video deve iniziare e interrompersi quando viene riprodotto nel contesto della playlist. Il valore predefinito è 0.
contentDetails.endAt string
Nota:questa proprietà è stata ritirata e, se impostata, il relativo valore viene ignorato.

Il tempo, misurato in secondi dall'inizio del video, in cui il video deve interrompere la riproduzione. Il proprietario della playlist può specificare gli orari in cui il video deve iniziare e interrompersi quando viene riprodotto nel contesto della playlist. Per impostazione predefinita, si presume 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 della 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.