Implementazione: canali

Questa pagina spiega come utilizzare l'API YouTube Data (v3) per eseguire funzioni relative al recupero e all'aggiornamento dei dati del canale. Una risorsa channel include gli ID delle playlist che identificano i video caricati e con Mi piace di 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 diversi modi per identificare il canale:

Impostare le informazioni sul 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 mostrare le impostazioni recuperate, consentendo all'utente di modificarle 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 all'API Explorer 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 Esplora API, devi impostare il valore della proprietà id sull'ID canale del canale dell'utente autenticato. Devi anche 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 gestire le sezioni del canale. Una sezione del canale è un insieme di video in evidenza su un canale. Ad esempio, una sezione potrebbe includere i caricamenti più recenti o più popolari di un canale oppure i video di una o più playlist.

L'esempio riportato di seguito recupera le sezioni del canale per il canale YouTube ufficiale di Google. La richiesta chiama il metodo channelSections.list e imposta il valore del parametro channelId su UCK8sQmJBp8GCxrOtXWBpyEA, che è l'ID canale 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, anziché utilizzare il parametro channelId, imposti il valore del parametro mine su true. Questo parametro indica che stai recuperando le sezioni del canale per il canale dell'utente attualmente autenticato.

Caricare e impostare un'immagine in filigrana per un canale

Puoi chiamare il metodo watermarks.set per caricare un'immagine della filigrana e impostarla per un canale. L'immagine viene visualizzata durante la riproduzione dei video del canale specificato. Puoi anche specificare un canale di destinazione a cui verrà collegata l'immagine, nonché i dettagli relativi alla tempistica che determinano quando viene visualizzata la filigrana e per quanto tempo.

Il metodo watermarks.unset elimina l'immagine del watermark di un canale.

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