Una risorsa channelSection
contiene informazioni su un insieme di
video che un canale ha scelto di mettere in primo piano. Ad esempio, una sezione può presentare
caricamenti più recenti, caricamenti più popolari o video di una o più playlist.
Un canale può creare un massimo di 10 sezioni.
Metodi
L'API supporta i seguenti metodi per le risorse channelSections
:
- list
- Restituisci un elenco di
channelSection
risorse che corrispondono ai criteri della richiesta API. Prova subito. - inserisci
- Aggiunge una sezione del canale al canale dell'utente autenticato. Un canale può creare un massimo di 10 sezioni. Prova subito.
- aggiorna
- Aggiorna la sezione di un canale. Prova subito.
- elimina
- Elimina una sezione del canale. Prova subito.
Rappresentazione della risorsa
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à 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 i dettagli di base della sezione del canale, come il tipo e il titolo. |
snippet.type |
string Il tipo di sezione del canale. I valori validi per questa proprietà sono:
|
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 solo il titolo di una sezione del canale con un valore snippet.type pari a multiplePlaylists o multipleChannels ; inoltre, dovrai specificare un titolo quando inserisci o aggiorni uno di questi tipi di sezioni. Se specifichi un titolo per altri tipi di sezioni del canale, il valore verrà ignorato.Il valore di questa proprietà ha una lunghezza massima di 100 caratteri e può contenere tutti i caratteri UTF-8 validi tranne < e <. |
snippet.position |
unsigned integer La posizione della sezione nella pagina del canale. Questa proprietà usa un indice in base a 0. Il valore 0 identifica la prima sezione visualizzata nel canale, il valore 1 identifica la seconda sezione e così via.Se non specifichi un valore per questa proprietà quando inserisci una sezione del canale, il comportamento predefinito prevede la visualizzazione della nuova sezione per ultima. |
contentDetails |
object L'oggetto contentDetails contiene dettagli sui contenuti della sezione del 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 di un canale. Devi specificare un elenco di ID playlist se la proprietà snippet.type della risorsa channelSection è singlePlaylist o multiplePlaylists ; inoltre, 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 mostrati in una sezione di canale. Devi specificare un elenco di ID canale se la proprietà snippet.type della risorsa channelSection è multipleChannels . Questa proprietà non deve essere specificata per altri tipi di sezioni. Non puoi includere il tuo canale nell'elenco. |