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 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:
  • default - L'immagine in miniatura predefinita. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, come un elemento della playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è di 88 px di larghezza e 88 px di altezza.
  • medium - Una versione a risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 320 px e alta 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high - Una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 480 px e alta 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px.
  • standard - Una versione dell'immagine in miniatura a risoluzione ancora più elevata rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, ad esempio elementi della playlist o risultati di ricerca. Questa immagine è larga 640 px e alta 480 px.
  • maxres: la versione con la massima risoluzione dell'immagine in miniatura. Queste dimensioni delle immagini sono disponibili per alcuni video e altre risorse che fanno riferimento ai video, ad esempio elementi della playlist o risultati di ricerca. Questa immagine è larga 1280 px e alta 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 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.