Questa pagina è stata tradotta dall'API Cloud Translation.

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`.