ChannelSections

Zasób channelSection zawiera informacje o zbiorze które są polecane na kanale. Na przykład sekcja może zawierać filmy z kanału najnowsze filmy, najpopularniejsze filmy lub filmy z jednej lub kilku playlist.

Na kanale może być 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 pasują do kryteriów żądania do interfejsu API. Wypróbuj
wstaw
Dodaje sekcję kanału do kanału uwierzytelnionego użytkownika. Na kanale może być maksymalnie 10 półek. Wypróbuj teraz
zaktualizuj
Aktualizuje sekcję kanału. Wypróbuj teraz
usuń
Usuwa sekcję kanału. Wypróbuj teraz

Reprezentowanie zasobu

Poniższa struktura JSON przedstawia 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

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość wyniesie youtube#channelSection.
etag etag
Etag tego zasobu.
id string
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje sekcję 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 dla tej właściwości to:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje kanał, na którym opublikowano sekcję kanału.
snippet.title string
Tytuł sekcji. Możesz ustawić tytuł tylko sekcji kanału, która ma wartość snippet.type multiplePlaylists lub multipleChannels. Tak naprawdę musisz podać tytuł, gdy wstawisz lub zaktualizujesz którąś z tych sekcji. Jeśli określisz tytuł dla innych typów sekcji kanału, wartość zostanie zignorowana.

Wartość tej właściwości ma maksymalną długość 100 znaków i może zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i <.
snippet.position unsigned integer
Pozycja sekcji na stronie kanału. Ta właściwość używa indeksu opartego na 0. Wartość 0 określa pierwszą sekcję wyświetlaną na kanale, wartość 1 wskazuje drugą sekcję itd.

Jeśli podczas wstawiania sekcji kanału nie określisz wartości tej właściwości, domyślną opcją będzie wyświetlanie nowej sekcji na końcu.
contentDetails object
Obiekt contentDetails zawiera szczegółowe informacje o zawartości sekcji kanału, takie jak lista playlist lub kanałów, które się w niej znajdują.
contentDetails.playlists[] list
Lista z co najmniej jednym identyfikatorem playlisty widoczna w sekcji kanału. Jeśli właściwość snippet.type zasobu channelSection ma wartość singlePlaylist lub multiplePlaylists, musisz podać listę identyfikatorów playlist. Tej właściwości nie należy określać w przypadku innych typów sekcji. W przypadku typu singlePlaylist lista musi zawierać dokładnie 1 identyfikator playlisty.
contentDetails.channels[] list
Lista z co najmniej jednym identyfikatorem kanału widocznym w sekcji kanału. Jeśli właściwość snippet.type zasobu channelSection ma wartość multipleChannels, musisz podać listę identyfikatorów kanałów. Tej właściwości nie należy określać w przypadku innych typów sekcji. Nie możesz dodać własnego kanału do listy.