ChannelSections

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