ChannelSections

Una risorsa channelSection contiene informazioni su un insieme di video che un canale ha scelto di mostrare. Ad esempio, una sezione potrebbe includere gli ultimi caricamenti del canale, i caricamenti più popolari o i video di una o più playlist.

Un canale può creare al massimo 10 scaffali.

Metodi

L'API supporta i seguenti metodi per le risorse di channelSections:

list
Restituisce un elenco di channelSection risorse che soddisfano i criteri della richiesta API. Prova subito.
inserire
Aggiunge una sezione del canale al canale dell'utente autenticato. Un canale può creare al massimo 10 scaffali. Prova subito.
Aggiorna
Aggiorna una sezione del canale. Prova subito.
elimina
Elimina una sezione del canale. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa channelSections:

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

Proprietà

La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#channelSection.
etag etag
L'Etag di questa risorsa.
id string
L'ID utilizzato da YouTube per identificare in modo univoco la sezione del canale.
snippet object
L'oggetto snippet contiene dettagli di base sulla sezione canale, come tipo e titolo.
snippet.type string
Il tipo della sezione canale.

I valori validi per questa proprietà sono:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
L'ID utilizzato da YouTube per identificare in modo univoco il canale che ha pubblicato la sezione del canale.
snippet.title string
Il titolo della sezione. Puoi impostare soltanto il titolo di una sezione di un canale con valore snippet.type pari a multiplePlaylists o multipleChannels; in effetti, devi specificare un titolo quando inserisci o aggiorni uno di questi tipi di sezioni. Se specifichi un titolo per altri tipi di sezioni di canale, il valore verrà ignorato.

Il valore di questa proprietà ha una lunghezza massima di 100 caratteri e potrebbe contenere tutti i caratteri UTF-8 validi tranne < e >.
snippet.position unsigned integer
La posizione della sezione sulla pagina del canale. Questa proprietà utilizza un indice basato su 0. Un valore 0 identifica la prima sezione che viene visualizzata sul canale, un valore 1 identifica la seconda sezione e così via.

Se non specifichi un valore per questa proprietà quando inserisci una sezione del canale, per impostazione predefinita viene utilizzata per impostazione predefinita la nuova sezione.
contentDetails object
L'oggetto contentDetails contiene dettagli sui contenuti della sezione canale, come un elenco di playlist o canali presenti nella sezione.
contentDetails.playlists[] list
Un elenco di uno o più ID playlist presenti in una sezione del canale. Devi specificare un elenco di ID playlist se la proprietà snippet.type della risorsa channelSection è singlePlaylist o multiplePlaylists e questa proprietà non deve essere specificata per altri tipi di sezioni. Se il tipo è singlePlaylist, questo elenco deve specificare esattamente un ID playlist.
contentDetails.channels[] list
Un elenco di uno o più ID canale presenti in una sezione canale. Devi specificare un elenco di ID canale se la proprietà snippet.type della risorsa channelSection è multipleChannels e questa proprietà non deve essere specificata per gli altri tipi di sezioni. Non puoi includere il tuo canale nell'elenco.