Implementazione: playlist

Gli esempi riportati di seguito mostrano come utilizzare l'API YouTube Data (v3) per eseguire funzioni relative a playlist e elementi di playlist.

Recuperare le playlist dell'utente corrente

Chiama il metodo playlists.list per recuperare le playlist dell'utente attualmente autenticato. Nella 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à è una 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, pertanto 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

Aggiungere 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 il titolo, la descrizione e lo stato della privacy della playlist. In questo esempio, il corpo della richiesta è:

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

Il seguente esempio contrassegna la nuova playlist come podcast:

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "podcastStatus": "enabled"
  }
}

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

Aggiornare una playlist

Questo esempio aggiorna lo stato della privacy di una playlist da private a public. L'esempio prevede due passaggi:

  • Passaggio 1: recupera l'ID della playlist

    Chiama il metodo playlists.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per il recupero delle playlist dell'utente corrente ne è un esempio. 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: aggiornare 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 della playlist da aggiornare specifica valori per le proprietà snippet.description o snippet.tags, questi valori devono essere specificati di nuovo nella richiesta di aggiornamento o verranno 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 all'API Explorer imposta un parametro che specifica il corpo della richiesta API. Il corpo della richiesta contiene una risorsa playlist, che definisce informazioni come il titolo, la descrizione e lo stato della privacy della playlist. In questo esempio viene utilizzato il seguente corpo della richiesta:

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

    Il seguente esempio contrassegna la playlist come programma di podcast:

    {
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "podcastStatus": "enabled"
  }
}

    Nota: se stai testando questa query in API Explorer, devi sostituire un ID playlist valido nel corpo della risorsa. Per ottenere un ID playlist, ti consigliamo di eseguire prima la richiesta mostrata sopra per l'aggiunta di una playlist. Estrai l'ID playlist dalla risposta dell'API e utilizza questo valore per la playlist che vuoi aggiornare. Il titolo e la descrizione della playlist utilizzati in questo esempio sono gli stessi di quelli utilizzati nell'esempio precedente.

Aggiungere un elemento di una playlist

Questo esempio aggiunge 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

    Chiama il metodo playlists.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per il recupero delle playlist dell'utente corrente ne è un esempio. 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 della proprietà che puoi impostare quando aggiungi un elemento della playlist.

Aggiungere un'immagine alla playlist

Puoi utilizzare il metodo playlistImages.insert dell'API v3 per caricare un'immagine di miniatura personalizzata e impostarla per una playlist. Nella richiesta, il valore del parametro playlistId identifica la playlist per la quale verrà utilizzata la miniatura.

Questa query non può essere testata utilizzando Explorer API perché non supporta la possibilità di caricare file multimediali, un requisito per questo metodo.

Aggiornare un elemento di una playlist

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

  • Passaggio 1: recupera l'ID playlist appropriato

    Chiama il metodo playlists.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per il recupero delle playlist dell'utente corrente ne è un esempio. 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 della 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 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. Utilizzerai questo valore per rimuovere un elemento dall'elenco nel passaggio successivo.

  • Passaggio 3: aggiorna l'elemento della playlist selezionato

    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 sull'ID 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 sull'ID video che identifica in modo univoco il video incluso nella playlist.
    • Imposta la proprietà snippet.position su 0 o sulla posizione in cui vuoi che venga visualizzato l'elemento (utilizzando un indice basato su 0).

    La richiesta API riportata di seguito aggiorna un elemento della 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 per le proprietà id, snippet.playlistId e snippet.resourceId.videoId.

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

Aggiornare l'immagine di una playlist

Puoi utilizzare il metodo playlistImages.update dell'API v3 per aggiornare l'immagine in miniatura di una playlist. Nella richiesta, il valore del parametro playlistId identifica la playlist per la quale verrà utilizzata la miniatura.

Questa query non può essere testata utilizzando Explorer API perché non supporta la possibilità di caricare file multimediali, un requisito per questo metodo.

Rimuovere un elemento di 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 dell'esempio riportato sopra per aggiornare un elemento della 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 elemento della playlist dell'elemento che vuoi rimuovere. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0.

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

Per completare la richiesta in Esplora 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 un'immagine di una playlist

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

  • Passaggio 1: recupera la playlist

    Chiama il metodo playlists.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per il recupero delle playlist dell'utente corrente ne è un esempio. 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 l'ID immagine della playlist

    Chiama il metodo playlistImages.list per recuperare l'immagine della miniatura di una playlist. Utilizza l'ID della playlist che vuoi modificare.

  • Passaggio 3: eliminazione di un'immagine della playlist

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

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

    Nota:se stai testando questa query in Explorer API, devi sostituire il valore del parametro id con un ID immagine della playlist valido.

Rimuovere una playlist

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

  • Passaggio 1: recupera l'ID della playlist

    Chiama il metodo playlists.list per recuperare le playlist nel canale dell'utente attualmente autenticato. La richiesta di esempio riportata sopra per il recupero delle playlist dell'utente corrente ne è un esempio. 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: eliminazione di una playlist

    Chiama il metodo playlists.delete per eliminare una playlist specifica. Nella richiesta, il parametro id specifica l'ID della playlist da eliminare. Questo metodo richiede un token di autorizzazione OAuth 2.0 valido. Se stai testando questa query in Explorer API, devi 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 stai testando 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 mostrata sopra per l'aggiunta di una playlist. Estrai l'ID playlist dalla risposta dell'API e utilizza questo valore per la playlist che vuoi eliminare.