Implementazione: playlist

I seguenti esempi mostrano come utilizzare la YouTube Data API (v3) per eseguire funzioni relative alle playlist e agli elementi della playlist.

Recupera le playlist dell'utente corrente

Richiama il metodo playlists.list per recuperare le playlist dell'utente attualmente autenticato. Nella tua richiesta, imposta il valore del parametro mine su true. Tieni presente che una richiesta che utilizza il parametro mine deve essere autorizzata utilizzando OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=snippet,contentDetails
        &mine=true

Recuperare le playlist di un utente

Questo esempio recupera le playlist create da un determinato canale. L'esempio prevede due passaggi:

Recuperare informazioni su una playlist specifica

Per recuperare informazioni su una o più playlist specifiche, chiama il metodo playlists.list e imposta il parametro id su un elenco separato da virgole di ID playlist di YouTube che identificano le risorse desiderate. Un caso d'uso comune per questa funzionalità è la richiesta di recupero di informazioni aggiuntive su un gruppo di playlist restituite in un insieme di risultati di ricerca. Ad esempio, potresti voler recuperare il numero di elementi in ogni playlist.

La richiesta riportata di seguito chiama il metodo playlists.list per recuperare il numero di elementi in due playlist che corrispondono al termine di query "GoogleDevelopers". Queste informazioni si trovano nella proprietà contentDetails.itemCount della risorsa playlist, quindi la richiesta imposta il valore del parametro part su contentDetails. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=contentDetails
        &id=PLOU2XLYxmsIIM9h1Ybw2DuRw6o2fkNMeR,PLyYlLs02rgBYRWBzYpoHz7m2SE8mEZ68w

Aggiungi una playlist

Questo esempio chiama il metodo playlists.insert per creare una playlist privata nel canale dell'utente autenticato. Qualsiasi richiesta API a questo metodo deve essere autorizzata utilizzando OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.insert?
        part=snippet,status

Il link a Explorer API imposta anche un parametro che specifica il corpo della richiesta API. Il corpo della richiesta contiene una risorsa playlist, che definisce informazioni come titolo, descrizione e stato della privacy della playlist. In questo esempio, il corpo della richiesta è:

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "private"
  }
}

Esempi di codice correlati: Java, JavaScript, .NET, PHP, Python

Aggiornare una playlist

In questo esempio viene aggiornato lo stato di privacy della playlist da private a public. L'esempio prevede due passaggi:

  • Passaggio 1: recupera l'ID della playlist

    Richiama il metodo playlist.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per recuperare le playlist dell'utente corrente dimostra questa richiesta. L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco di playlist, utilizzando l'ID di ogni playlist come chiave.

  • Passaggio 2: aggiorna una playlist

    Chiama il metodo playlists.update per modificare una playlist specifica. Questo metodo richiede un token di autorizzazione OAuth 2.0 valido.

    Il corpo della richiesta deve includere la parte snippet della risorsa playlist perché la proprietà snippet.title è obbligatoria quando si chiama questo metodo. Inoltre, se la risorsa playlist in fase di aggiornamento specifica valori per le proprietà snippet.description o snippet.tags, tali valori devono essere specificati nuovamente nella richiesta di aggiornamento, altrimenti saranno eliminati.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.update?
        part=snippet,status

    Come nell'esempio precedente per l'aggiunta di una playlist, il link allo strumento Explorer API imposta un parametro che specifica il corpo della richiesta API. Il corpo della richiesta contiene una risorsa playlist, che definisce informazioni come titolo, descrizione e stato della privacy della playlist. Nell'esempio viene utilizzato il seguente corpo della richiesta:

    {
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "public"
  }
}

    Nota: se stai testando questa query in Explorer API, dovrai sostituire un ID playlist valido nel corpo della risorsa. Per ottenere un ID playlist, ti consigliamo di eseguire prima la richiesta riportata sopra per aggiungere una playlist. Estrai l'ID playlist dalla risposta dell'API e utilizza il valore corrispondente per la playlist che vuoi aggiornare. Il titolo e la descrizione della playlist usati in questo esempio sono uguali a quelli usati nell'esempio.

Aggiungi la playlist selezionata

In questo esempio viene aggiunto un elemento a una playlist. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Questo esempio prevede due passaggi:

  • Passaggio 1: recupera l'ID playlist appropriato

    Richiama il metodo playlist.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per recuperare le playlist dell'utente corrente dimostra questa richiesta. L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco di playlist, utilizzando l'ID di ogni playlist come chiave.

  • Passaggio 2: aggiungi un video alla playlist

    Chiama il metodo playlistItems.insert per aggiungere un video alla playlist. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Il corpo della richiesta è una risorsa playlistItem che specifica almeno i seguenti valori:

    La richiesta API riportata di seguito aggiunge un video a una playlist. Il corpo della richiesta è:

    {
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    }
  }
}

    Per completare la richiesta in Explorer API, devi impostare i valori per le proprietà snippet.playlistId e snippet.resourceId.videoId.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.insert?
        part=snippet

    Nota: la documentazione del metodo playlistItems.insert identifica gli altri valori delle proprietà che puoi impostare quando aggiungi una playlist.

Aggiorna la playlist selezionata

Questo esempio aggiorna una playlist in modo che sia il primo di una playlist. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Questo esempio prevede tre passaggi:

  • Passaggio 1: recupera l'ID playlist appropriato

    Richiama il metodo playlist.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per recuperare le playlist dell'utente corrente dimostra questa richiesta. L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco di playlist, utilizzando l'ID di ogni playlist come chiave.

  • Passaggio 2: recupera gli elementi dalla playlist selezionata

    Chiama il metodo playlistItems.list per recuperare l'elenco dei video nella playlist selezionata. Imposta il valore del parametro playlistId sull'ID playlist che hai ottenuto nel passaggio 1.

    Ogni risorsa nella risposta dell'API contiene una proprietà id che identifica l'ID elemento della playlist che identifica in modo univoco l'elemento. Questo valore verrà utilizzato per rimuovere un elemento dall'elenco nel passaggio successivo.

  • Passaggio 3: aggiorna la playlist selezionata

    Chiama il metodo playlistItems.update per modificare la posizione del video nella playlist. Imposta il valore del parametro part su snippet. Il corpo della richiesta deve essere una risorsa playlistItem che imposti almeno i seguenti valori:

    • Imposta la proprietà id con l'ID dell'elemento della playlist ottenuto nel passaggio 2.
    • Imposta la proprietà snippet.playlistId sull'ID playlist ottenuto nel passaggio 1.
    • Imposta la proprietà snippet.resourceId.kind su youtube#video.
    • Imposta la proprietà snippet.resourceId.videoId con l'ID video che identifica in modo univoco il video incluso nella playlist.
    • Imposta la proprietà snippet.position su 0 o nella posizione in cui vuoi che venga visualizzato l'elemento (utilizzando un indice basato su 0).

    La richiesta API riportata di seguito aggiorna una playlist in modo che sia il primo elemento di una playlist. Il corpo della richiesta è:

    {
  "id": "PLAYLIST_ITEM_ID",
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    },
    "position": 0
  }
}

    Per completare la richiesta in Explorer API, devi impostare i valori delle proprietà id, snippet.playlistId e snippet.resourceId.videoId.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.update?
        part=snippet

Rimuovere una playlist

Questo esempio elimina un video da una playlist. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Questo esempio prevede tre passaggi. I primi due passaggi sono gli stessi riportati nell'esempio sopra per l'aggiornamento di una playlist.

Dopo aver completato questi passaggi, chiama il metodo playlistItems.delete per rimuovere un video dalla playlist. Imposta il parametro id della richiesta sull'ID dell'elemento che vuoi rimuovere. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0.

Tieni presente che l'ID dell'elemento della playlist utilizzato per identificare un video in una playlist è diverso dall'ID video di YouTube che identifica in modo univoco il video. L'ID elemento della playlist identifica il video come un elemento di una determinata playlist.

Per completare la richiesta in Explorer API, devi impostare il valore della proprietà id.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.delete?
        id=PLAYLIST_ITEM_ID

Rimuovere una playlist

Questo esempio elimina una playlist. L'esempio prevede due passaggi:

  • Passaggio 1: recupera l'ID della playlist

    Richiama il metodo playlist.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per recuperare le playlist dell'utente corrente dimostra questa richiesta. L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco di playlist, utilizzando l'ID di ogni playlist come chiave.

  • Passaggio 2: elimina una playlist

    Chiama il metodo playlists.delete per eliminare una playlist specifica. Nella richiesta, il parametro id specifica l'ID della playlist eliminata. Questo metodo richiede un token di autorizzazione OAuth 2.0 valido. Se stai testando questa query in Explorer API, dovrai sostituire il valore del parametro id con un ID playlist valido.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.delete?
        id=PLAYLIST_ID

    Nota: se esegui il test di questa query in Explorer API, devi sostituire il valore del parametro id con un ID playlist valido. Per ottenere un ID playlist, ti consigliamo di eseguire prima la richiesta riportata sopra per aggiungere una playlist. Estrai l'ID playlist dalla risposta dell'API e utilizza il valore corrispondente per la playlist che vuoi eliminare.