Zasób channelSection
zawiera informacje o zbiorze filmów polecanych na kanale. Może ona na przykład zawierać najnowsze lub najpopularniejsze filmy z kanału albo filmy z jednej lub kilku playlist.
Kanał może utworzyć maksymalnie 10 półek.
Metody
Interfejs API obsługuje te metody zasobów channelSections
:
- list
- Zwraca listę
channelSection
zasobów, które spełniają kryteria żądania do interfejsu API. Wypróbuj teraz - wstaw
- Dodaje sekcję kanału do kanału uwierzytelnionego użytkownika. Na kanale można utworzyć maksymalnie 10 półek. Wypróbuj teraz
- aktualizacja
- Aktualizuje sekcję kanału. Wypróbuj teraz
- usuń
- Usuwa sekcję kanału. Wypróbuj teraz
Reprezentacja zasobu
Poniższa struktura JSON pokazuje format zasobu channelSections
:
{ "kind": "youtube#channelSection", "etag": etag, "id": string, "snippet": { "type": string, "channelId": string, "title": string, "position": unsigned integer }, "contentDetails": { "playlists": [ string ], "channels": [ string ] } }
Właściwości
Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:
Właściwości | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartością będzie youtube#channelSection . |
etag |
etag ETag tego zasobu. |
id |
string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania sekcji kanału. |
snippet |
object Obiekt snippet zawiera podstawowe informacje o sekcji kanału, takie jak jej typ i tytuł. |
snippet.type |
string Typ sekcji kanału. Prawidłowe wartości tej właściwości to:
|
snippet.channelId |
string Identyfikator używany w YouTube do jednoznacznej identyfikacji kanału, który opublikował sekcję kanału. |
snippet.title |
string Tytuł sekcji. Możesz ustawić tylko tytuł sekcji kanału, dla której snippet.type ma wartość multiplePlaylists lub multipleChannels . Musisz też podać tytuł podczas wstawiania lub aktualizowania sekcji tego typu. Jeśli określisz tytuł sekcji kanału innego typu, ta wartość będzie ignorowana.Wartość tej właściwości może mieć maksymalnie 100 znaków i może zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem znaków < i >. |
snippet.position |
unsigned integer Pozycja sekcji na stronie kanału. Ta usługa używa indeksu liczonego od 0. Wartość 0 określa pierwszą sekcję, która pojawia się na kanale, wartość 1 określa drugą sekcję itd.Jeśli wartość tej właściwości nie zostanie określona podczas wstawiania sekcji kanału, domyślnie nowa sekcja zostanie wyświetlona na końcu. |
contentDetails |
object Obiekt contentDetails zawiera szczegółowe informacje o zawartości sekcji kanału, np. listę znajdujących się w niej playlist lub kanałów. |
contentDetails.playlists[] |
list Lista zawierająca co najmniej jeden identyfikator playlisty występujący w sekcji kanału. Jeśli właściwość snippet.type zasobu channelSection to singlePlaylist lub multiplePlaylists i nie należy jej podawać w przypadku innych typów sekcji, musisz podać listę identyfikatorów playlist. Jeśli typem jest singlePlaylist , lista musi określać dokładnie 1 identyfikator playlisty. |
contentDetails.channels[] |
list Lista z co najmniej jednym identyfikatorem kanału prezentowanym w sekcji kanału. Jeśli właściwość snippet.type zasobu channelSection to multipleChannels i nie należy jej podawać w przypadku innych typów sekcji, musisz podać listę identyfikatorów kanałów. Nie możesz umieścić na liście własnego kanału. |