PlaylistItems

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 viene utilizzata nella playlist.

YouTube utilizza una playlist anche 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 per quell'elenco dalla 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 di richiesta dell'API. Puoi recuperare tutti gli elementi di una playlist specifica o uno o più elementi di una playlist in base ai relativi ID univoci. Prova subito.
insert
Aggiungi una risorsa a una playlist. Prova subito.
update
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 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, ad esempio 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 di immagini in miniatura 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 di un video o di una risorsa che rimanda a un video, ad esempio un elemento di una playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è larga 88 px e alta 88 px.
  • medium: una versione dell'immagine in miniatura con una risoluzione più elevata. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 320 pixel e un'altezza di 180 pixel. Per un canale, l'immagine deve avere una larghezza di 240 pixel e un'altezza di 240 pixel.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 480 pixel e un'altezza di 360 pixel. Per un canale, l'immagine deve avere una larghezza di 800 pixel e un'altezza di 800 pixel.
  • standard: una versione dell'immagine in miniatura con una risoluzione ancora superiore 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 è larga 640 px e alta 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 è larga 1280 pixel e alta 720 pixel.
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 il video.
snippet.videoOwnerChannelId string
L'ID del canale che ha caricato il 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 viene visualizzato nella playlist. Il valore utilizza un indice a partire da zero, quindi il primo elemento ha una posizione 0, il secondo elemento una 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 genere della risorsa a cui si fa riferimento.
snippet.resourceId.videoId string
Se il valore della proprietà snippet.resourceId.kind è youtube#video, questa proprietà sarà presente e il relativo valore conterrà l'ID utilizzato da YouTube 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 momento, misurato in secondi dall'inizio del video, in cui deve iniziare la riproduzione del video. Il proprietario della playlist può specificare i momenti in cui deve iniziare e terminare la riproduzione del video 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 momento, misurato in secondi dall'inizio del video, in cui la riproduzione deve essere interrotta. Il proprietario della playlist può specificare i momenti in cui deve iniziare e terminare la riproduzione del video 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 di pubblicazione del video 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.