Questa pagina è stata tradotta dall'API Cloud Translation.

PlaylistItems

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

YouTube utilizza inoltre una playlist per identificare l'elenco dei video caricati da un canale, con ogni playlistItem che rappresenta un video caricato. Puoi recuperare l'ID playlist dell'elenco dalla channel resource per un determinato canale. Puoi quindi utilizzare il metodo playlistItems.list per l'elenco.

Metodi

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

list: Restituisce una raccolta di elementi della playlist che corrispondono ai parametri della richiesta API. Puoi recuperare tutti gli elementi della playlist di una playlist specificata o una o più playlist in base all'ID univoco. Prova subito.
inserire: Aggiunge una risorsa a una playlist. Prova subito.
Aggiorna: Modifica la voce di una playlist. Ad esempio, potresti aggiornare la posizione dell'elemento nella playlist. Prova subito.
elimina: Elimina una voce 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à che vengono 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 la voce della playlist.
`snippet`	`object` L'oggetto `snippet` contiene dettagli di base sull'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'elemento.
`snippet.description`	`string` La descrizione dell'elemento.
`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` 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, ad esempio 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 con una risoluzione più alta 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 è 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 ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px. `standard`: una versione a risoluzione ancora più alta dell'immagine in miniatura rispetto a quella con risoluzione `high`. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come elementi delle playlist o 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. Le dimensioni di questa immagine sono disponibili per alcuni video e altre risorse che fanno riferimento a video, ad esempio elementi delle 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 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 con 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 menzionata.
`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 utilizzato da YouTube per identificare in modo univoco il video nella playlist.
`contentDetails`	`object` L'oggetto `contentDetails` è incluso nella risorsa se l'elemento in questione è 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 ricerca `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, in cui dovrebbe iniziare la riproduzione del video. Il proprietario della playlist può specificare i momenti in cui deve essere avviata e interrotta la riproduzione del video nel contesto della playlist in questione. Il valore predefinito è `0`.
`contentDetails.endAt`	`string` Nota: questa proprietà è stata ritirata e, se impostata, il suo valore viene ignorato. Il tempo, misurato in secondi dall'inizio del video, in cui la riproduzione del video dovrebbe essere interrotta. Il proprietario della playlist può specificare i momenti in cui deve essere avviata e interrotta la riproduzione del video nel contesto della playlist in questione. Presupponi per impostazione predefinita 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 con il metodo `videos.insert` o `videos.update`.