Implementazione: canali

Questa pagina spiega come utilizzare la YouTube Data API (v3) per eseguire le funzioni di recupero e aggiornamento dei dati del canale. Una risorsa channel include ID playlist che identificano i video caricati e piaciuti in un canale. Per recuperare queste informazioni quando chiami il metodo channels.list, assicurati che il valore del parametro part includa la parte della risorsa contentDetails.

Recuperare informazioni su un canale

Chiama il metodo channels.list per recuperare informazioni su un determinato canale. Esistono vari modi per identificare il canale:

Impostare le informazioni di branding di un canale

Questo esempio aggiorna le opzioni di branding di un canale. L'esempio prevede due passaggi:

  • Passaggio 1: recupera le opzioni di branding del canale

    Chiama il metodo channels.list e imposta il valore del parametro part su brandingSettings e il valore del parametro mine su true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    L'applicazione potrebbe visualizzare le impostazioni recuperate, consentendo all'utente di modificare le impostazioni per l'aggiornamento.

  • Passaggio 2: aggiorna le opzioni di branding del canale

    Chiama il metodo channels.list e imposta i seguenti valori:

    • Imposta la proprietà id sull'ID canale YouTube univoco del canale. L'ID può essere estratto dalla risposta dell'API nel passaggio 1.
    • Imposta il valore del parametro part su brandingSettings.

    Il link a Explorer API riportato di seguito crea una risorsa channel con le seguenti impostazioni di branding:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Per completare la richiesta in Explorer API, devi impostare il valore della proprietà id sull'ID canale del canale dell'utente autenticato. Devi inoltre impostare le proprietà dell'immagine in modo che corrispondano alle impostazioni correnti.

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

Gestire le sezioni del canale

L'API supporta i metodi channelSections.list, channelSections.insert, channelSections.update e channelSections.delete per la gestione delle sezioni del canale. Una sezione del canale è un insieme di video presenti in un canale. Ad esempio, una sezione potrebbe includere gli ultimi caricamenti del canale, i caricamenti più popolari o i video di una o più playlist.

L'esempio seguente recupera le sezioni del canale YouTube ufficiale di Google. La richiesta chiama il metodo channelSections.list e imposta il valore del parametro channelId su UCK8sQmJBp8GCxrOtXWBpyEA, che è l'ID del canale di Google. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Questa richiesta richiede l'autorizzazione se, invece di utilizzare il parametro channelId, imposti il valore del parametro mine su true. Questo parametro indica che stai recuperando sezioni del canale per il canale dell'utente attualmente autenticato.

Caricare e impostare un'immagine filigrana per un canale

Puoi chiamare il metodo watermarks.set per caricare un'immagine filigrana e impostarla per un canale. L'immagine viene quindi visualizzata durante le riproduzioni dei video del canale specificato. Puoi anche specificare un canale di destinazione a cui collegare l'immagine, nonché i dettagli relativi alle tempistiche che determinano quando viene visualizzata la filigrana e per quanto tempo è visibile.

Il metodo watermarks.unset elimina l'immagine della filigrana di un canale.

Purtroppo non è possibile testare questa query utilizzando Explorer API perché Explorer API non supporta la possibilità di caricare file multimediali, un requisito per questo metodo.