Implementazione: canali

Questa pagina spiega come utilizzare l'API YouTube Data (v3) per eseguire funzioni correlate al recupero e all'aggiornamento dei dati del canale. Una risorsa channel include gli ID playlist che identificano i video caricati e piaciuti 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 canale specifico. 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: recuperare 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

    La tua applicazione potrebbe mostrare le impostazioni recuperate, consentendo all'utente di modificarle per aggiornarle.

  • Passaggio 2: aggiornare 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 relative ai brand:

    {
  "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. Dovresti 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 la gestione delle sezioni del canale. Una sezione del canale è un insieme di video in primo piano su un canale. Ad esempio, una sezione potrebbe includere i caricamenti più recenti, i caricamenti più popolari o i video di una o più playlist di un canale.

L'esempio riportato di seguito 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 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 parametro mine su true. Questo parametro indica che stai recuperando le sezioni del canale dell'utente attualmente autenticato.

Caricare e impostare un'immagine della filigrana per un canale

Puoi chiamare il metodo watermarks.set per caricare un'immagine della filigrana e impostarla per un canale. L'immagine viene quindi visualizzata durante la riproduzione dei video del canale specificato. Puoi anche specificare un canale di destinazione a cui l'immagine verrà collegata, nonché i dettagli di temporizzazione 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, questa query non può essere testata utilizzando Explorer API perché non supporta la possibilità di caricare file multimediali, un requisito per questo metodo.