Playlists

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

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

  • video caricati
  • video con Mi piace (incluso)
Per essere più precisi, questi elenchi sono associati a un canale, ovvero una raccolta di video di una persona, un gruppo o una società, playlist e altre informazioni di YouTube. Puoi recuperare gli ID playlist di ciascuno di questi elenchi dalla sezione channel resource di un determinato canale.

Puoi quindi utilizzare il metodo playlistItems.list per recuperare uno 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 di playlists:

list
Restituisce una raccolta di playlist che corrispondono ai parametri di richiesta dell'API. Ad esempio, puoi recuperare tutte le playlist di proprietà dell'utente autenticato oppure una o più playlist in base agli ID univoci. Prova subito.
inserire
Crea una playlist. Prova subito.
Aggiorna
Modifica una playlist. Ad esempio, puoi modificare il titolo, la descrizione o lo stato di 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
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": 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#playlist.
etag etag
L'Etag di questa risorsa.
id string
L'ID utilizzato da YouTube per identificare in modo univoco la playlist.
snippet object
L'oggetto snippet contiene dettagli di base sulla playlist, come il titolo e la 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 miniature 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
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 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 localizzato e una descrizione per la playlist oppure il titolo nella lingua predefinita dei metadati della playlist.
  • Il testo localizzato viene restituito nello snippet di 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 è stato specificato un valore parametro hl oppure se è stato specificato un valore, ma non sono disponibili metadati localizzati per la lingua specificata.
La proprietà contiene un valore di sola lettura. Utilizza l'oggetto localizations per aggiungere, aggiornare o eliminare titoli localizzati.
snippet.localized.title string
Il titolo della playlist localizzata.
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 di privacy della playlist.

I valori validi per questa proprietà sono:
  • private
  • public
  • unlisted
contentDetails object
L'oggetto contentDetails contiene informazioni sui contenuti della playlist, incluso il numero di video al suo interno.
contentDetails.itemCount unsigned integer
Il numero di video nella playlist.
player object
L'oggetto player contiene le informazioni che useresti 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 include le traduzioni dei metadati della playlist.
localizations.(key) object
La lingua del testo localizzato associato alla coppia chiave-valore. Il valore è una stringa che contiene un codice lingua BCP-47.
localizations.(key).title string
Il titolo della playlist localizzata.
localizations.(key).description string
La descrizione localizzata della playlist.