Zasób channelSection
zawiera informacje o zbiorze filmów, które poleca kanał. Sekcja może zawierać na przykład najnowsze filmy, najpopularniejsze filmy lub filmy z co najmniej jednej playlisty.
Kanał może mieć maksymalnie 10 półek.
Metody
Interfejs API obsługuje następujące metody w przypadku 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. Kanał może mieć maksymalnie 10 półek. Wypróbuj teraz
- zaktualizuj
- Aktualizuje sekcję kanału. Wypróbuj teraz
- usuń
- Usuwa sekcję kanału. Wypróbuj teraz
Reprezentowanie zasobów
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 ] } }
Usługi
Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:
Usługi | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#channelSection . |
etag |
etag Otagowanie tego zasobu. |
id |
string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji sekcji kanału. |
snippet |
object Obiekt snippet zawiera podstawowe informacje o sekcji kanału, takie jak jego typ i tytuł. |
snippet.type |
string Typ sekcji kanału. Prawidłowe wartości tej właściwości to:
|
snippet.channelId |
string Identyfikator, który jest używany przez YouTube do jednoznacznego identyfikowania kanału, który opublikował sekcję kanału. |
snippet.title |
string Tytuł sekcji. Możesz ustawić tylko tytuł sekcji kanału, która ma wartość snippet.type multiplePlaylists lub multipleChannels . Musisz podać tytuł podczas wstawiania lub aktualizowania którejś z tych sekcji. Jeśli określisz tytuł innych typów sekcji kanału, wartość zostanie zignorowana.Wartość tej właściwości może mieć maksymalnie 100 znaków i może zawierać wszystkie prawidłowe znaki UTF-8 oprócz < i >. |
snippet.position |
unsigned integer Pozycja sekcji na stronie kanału Ta usługa używa indeksu opartego na 0. Wartość 0 wskazuje pierwszą sekcję, która pojawia się na kanale, wartość 1 wskazuje drugą sekcję itd.Jeśli nie określisz wartości tej właściwości podczas wstawiania sekcji kanału, domyślnie wyświetli się ostatnia sekcja. |
contentDetails |
object Obiekt contentDetails zawiera szczegółowe informacje o treści kanału, takie jak lista playlist lub kanały, które się w niej znajdują. |
contentDetails.playlists[] |
list Co najmniej 1 identyfikator playlisty polecany w sekcji kanału. Musisz określić listę identyfikatorów playlist, jeśli właściwość snippet.type zasobu channelSection ma wartość singlePlaylist lub multiplePlaylists , a właściwość ta nie powinna być określona w przypadku innych typów sekcji. Jeśli typ to singlePlaylist , ta lista musi zawierać dokładnie 1 identyfikator playlisty. |
contentDetails.channels[] |
list Co najmniej 1 identyfikator kanału polecany w sekcji kanału. Musisz określić listę identyfikatorów kanałów, jeśli właściwość snippet.type zasobu channelSection ma wartość multipleChannels , a właściwość ta nie powinna być określona w przypadku innych typów sekcji. Nie możesz dodać do listy własnego kanału. |