Playlists

Una risorsa playlist rappresenta una playlist di YouTube. Una playlist è una raccolta di video che possono essere visualizzati in sequenza e condivisi con altri utenti. Per impostazione predefinita, le playlist sono visibili pubblicamente agli altri utenti, ma possono essere pubbliche o private.

YouTube utilizza le playlist anche per identificare raccolte speciali di video per un canale, ad esempio:

  • video caricati
  • video con valutazioni positive (Mi piace)
Per essere più precisi, questi elenchi sono associati a un canale, ovvero una raccolta di video, playlist e altre informazioni di YouTube di una persona, un gruppo o un'azienda. Puoi recuperare gli ID playlist per ciascuno di questi elenchi da channel resource per un determinato canale.

Puoi quindi utilizzare il metodo playlistItems.list per recuperare uno qualsiasi di questi elenchi. Puoi anche aggiungere o rimuovere elementi da questi elenchi chiamando i metodi playlistItems.insert e playlistItems.delete.

Metodi

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

list
Restituisce una raccolta di playlist che corrispondono ai parametri della richiesta API. Ad esempio, puoi recuperare tutte le playlist di proprietà dell'utente autenticato oppure una o più playlist in base ai loro ID univoci. Prova subito.
insert
Crea una playlist. Prova subito.
aggiornamento
Modifica una playlist. Ad esempio, puoi modificare il titolo, la descrizione o lo stato della privacy di una playlist. Prova subito.
elimina
Elimina una playlist. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa playlists:

{
  "kind": "youtube#playlist",
  "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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string,
    "podcastStatus": enum
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": 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#playlist.
etag etag
L'ETag di questa risorsa.
id string
L'ID che YouTube utilizza per identificare in modo univoco la playlist.
snippet object
L'oggetto snippet contiene i dettagli di base della playlist, come titolo e descrizione.
snippet.publishedAt datetime
La data e l'ora in cui è stata creata la playlist. Il valore è specificato nel formato ISO 8601.
snippet.channelId string
L'ID utilizzato da YouTube per identificare in modo univoco il canale che ha pubblicato la playlist.
snippet.title string
Il titolo della playlist.
snippet.description string
La descrizione della playlist.
snippet.thumbnails object
Una mappa delle immagini in miniatura associate alla 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 il video.
snippet.tags[] list
Questa proprietà è stata ritirata.

Tag delle parole chiave associati alla playlist.
snippet.defaultLanguage string
La lingua del testo nelle proprietà snippet.title e snippet.description della risorsa playlist.
snippet.localized object
L'oggetto snippet.localized contiene un titolo e una descrizione localizzati per la playlist oppure il titolo nella lingua predefinita per i metadati della playlist.
  • Il testo localizzato viene restituito nello snippet della risorsa se la richiesta playlists.list ha utilizzato il parametro hl per specificare una lingua per la quale deve essere restituito il testo localizzato e il testo localizzato è disponibile in quella lingua.
  • I metadati per la lingua predefinita vengono restituiti se non viene specificato un valore del parametro hl o se viene specificato un valore, ma i metadati localizzati non sono disponibili per la lingua specificata.
La proprietà contiene un valore di sola lettura. Utilizza l'oggetto localizations per aggiungere, aggiornare o eliminare i titoli localizzati.
snippet.localized.title string
Il titolo localizzato della playlist.
snippet.localized.description string
La descrizione localizzata della playlist.
status object
L'oggetto status contiene informazioni sullo stato della playlist.
status.privacyStatus string
Lo stato della privacy della playlist.

I valori validi per questa proprietà sono:
  • private
  • public
  • unlisted
status.podcastStatus string
Lo stato della playlist come podcast. Se il valore è enabled, la playlist viene contrassegnata come podcast. Per impostare lo stato del podcast di una playlist su enabled, la playlist deve avere un'immagine della playlist.

I valori validi per questa proprietà sono:
  • enabled
  • disabled
  • unspecified
contentDetails object
L'oggetto contentDetails contiene informazioni sui contenuti della playlist, incluso il numero di video nella playlist.
contentDetails.itemCount unsigned integer
Il numero di video nella playlist.
player object
L'oggetto player contiene le informazioni che utilizzeresti per riprodurre la playlist in un player incorporato.
player.embedHtml string
Un tag <iframe> che incorpora un player che riproduce la playlist.
localizations object
L'oggetto localizations contiene le traduzioni dei metadati della playlist.
localizations.(key) object
La lingua del testo localizzato associato al valore della chiave. Il valore è una stringa che contiene un codice lingua BCP-47.
localizations.(key).title string
Il titolo localizzato della playlist.
localizations.(key).description string
La descrizione localizzata della playlist.