Questa pagina è stata tradotta dall'API Cloud Translation.

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.