ChannelSections: list

Zwraca listę zasobów channelSection, które spełniają kryteria żądania do interfejsu API.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 1 jednostkę.

Typowe przypadki użycia

Prośba

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/channelSections

Parametry

W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa oddzieloną przecinkami listę właściwości zasobu channelSection, które będzie zawierać odpowiedź interfejsu API.

Jeśli parametr wskazuje właściwość zawierającą właściwości podrzędne, w odpowiedzi zostaną uwzględnione właściwości podrzędne. Na przykład w zasobie channelSection właściwość snippet zawiera inne właściwości, takie jak wyświetlany tytuł sekcji. Jeśli ustawisz part=snippet, odpowiedź interfejsu API będzie zawierać wszystkie te zagnieżdżone właściwości.

Na poniższej liście znajdziesz nazwy parametrów part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
Filtry (określ dokładnie jeden z tych parametrów)
channelId string
Parametr channelId określa identyfikator kanału w YouTube. Jeśli żądanie określa wartość tego parametru, interfejs API zwróci tylko sekcje wskazanego kanału.
id string
Parametr id zawiera rozdzieloną przecinkami listę identyfikatorów, które jednoznacznie identyfikują pobierane zasoby channelSection. W zasobie channelSection właściwość id określa identyfikator sekcji.
mine boolean
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Ustaw wartość tego parametru na true, aby pobierać kanał z sekcjami kanału powiązanymi z kanałem YouTube uwierzytelnionego użytkownika.
Parametry opcjonalne
hl string
Ten parametr został wycofany. Parametr hl umożliwiał pobieranie zlokalizowanych metadanych dla sekcji kanału. Ta funkcja została jednak wycofana w YouTube Studio i w aplikacji YouTube.
onBehalfOfContentOwner string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

{
  "kind": "youtube#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection Resource
  ]
}

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#channelSectionListResponse.
etag etag
ETag tego zasobu.
items[] list
Lista sekcji kanału pasujących do kryteriów żądania.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) channelSectionForbidden Zgłaszający nie ma dostępu do żądanych sekcji kanału.
invalidValue (400) idInvalid W żądaniu podano nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie można zrealizować żądania, ponieważ kryteria filtra są nieprawidłowe.
notFound (404) channelNotFound Nie udało się znaleźć kanału powiązanego z prośbą.
notFound (404) channelSectionNotFound Nie udało się znaleźć sekcji kanału powiązanej z prośbą.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.