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 agli altri utenti, ma possono essere pubbliche o private.

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

video caricati
video con valutazioni positive (Mi piace)

Per essere più specifici, questi elenchi sono associati a un canale, ovvero una raccolta di video, playlist e altre informazioni di YouTube relativi a una persona, un gruppo o una società. Puoi recuperare gli ID playlist di 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 elementi 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 della richiesta API. Ad esempio, puoi recuperare tutte le playlist di proprietà dell'utente autenticato oppure puoi recuperare una o più playlist in base ai relativi ID univoci. Prova subito.
inserire: Crea una playlist. Prova subito.
aggiornamento: Modifica una playlist. Ad esempio, potresti 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à 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 della playlist, come il titolo e la descrizione.
`snippet.publishedAt`	`datetime` La data e l'ora di creazione della 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 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 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 della playlist oppure il titolo nella lingua predefinita dei 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 restituire 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 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` Stato della 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 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` racchiude 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 localizzato della playlist.
`localizations.(key).description`	`string` La descrizione localizzata della playlist.