ChannelSections

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:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
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.