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 ad 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 voti positivi (Mi piace)
Per essere più specifici, questi elenchi sono associati a un canale, ovvero a un insieme di video, playlist e altre informazioni di YouTube di una persona, un gruppo o una società. Puoi recuperare gli ID playlist per ciascuno di questi elenchi dal channel resource di un determinato canale.

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

Metodi

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

list
Restituisci 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 tramite i suoi ID univoci. Prova subito.
inserisci
Crea una playlist. Prova subito.
aggiorna
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 della risorsa

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 utilizzato da YouTube per identificare in modo univoco la playlist.
snippet object
L'oggetto snippet contiene i 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 di immagini in miniatura associate alla playlist. Per ogni oggetto della mappa, la chiave è il nome dell'immagine in miniatura, mentre 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, come un elemento della playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è larga 88 px in larghezza e 88 px in 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 con una risoluzione ancora più elevata rispetto all'immagine 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 è larga 640 px e alta 480 px.
  • maxres - La versione con la massima risoluzione dell'immagine in miniatura. Queste dimensioni dell'immagine sono disponibili per alcuni video e altre risorse che fanno riferimento ai video, come elementi di 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 di 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 del podcast della playlist. 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, compreso 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 riprodurrà la playlist.
localizations object
L'oggetto localizations incapsula le traduzioni dei metadati della playlist.
localizations.(key) object
La lingua del testo localizzato associato al valore chiave. Il valore è una stringa contenente un codice lingua BCP-47.
localizations.(key).title string
Il titolo localizzato della playlist.
localizations.(key).description string
La descrizione localizzata della playlist.