ChannelSections: list

Zwraca listę zasobów channelSection zgodnych z kryteriami żądania do interfejsu API.

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

Częste zastosowania

Żądanie

Żądanie HTTP

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

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa rozdzieloną przecinkami listę co najmniej 1 właściwości zasobu channelSection, które będą uwzględnione w odpowiedzi interfejsu API.

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

Poniższa lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
Filtry (określ dokładnie 1 z tych parametrów)
channelId string
Parametr channelId określa identyfikator kanału YouTube. Jeśli żądanie zawiera wartość tego parametru, interfejs API zwróci tylko sekcje określonego kanału.
id string
Parametr id określa rozdzieloną przecinkami listę identyfikatorów, które jednoznacznie identyfikują pobierane zasoby channelSection. We właściwości id zasobu channelSection znajduje się identyfikator sekcji.
mine boolean
Ten parametr można używać tylko w prawidłowo autoryzowanym żądaniu. Ustaw wartość tego parametru na true, aby pobrać plik danych sekcji kanału powiązanych z kanałem YouTube uwierzytelnionego użytkownika.
Parametry opcjonalne
hl string
Ten parametr został wycofany. Parametr hl umożliwiał pobieranie zlokalizowanych metadanych sekcji kanału. Ta funkcja została jednak wycofana w YouTube Studio i aplikacji YouTube.
onBehalfOfContentOwner string
Ten parametr można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci treść odpowiedzi o tej strukturze:

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

Właściwości

W tabeli poniżej znajdziesz definicje właściwości, które występują w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość to youtube#channelSectionListResponse.
etag etag
Etag tego zasobu.
items[] list
Lista sekcji kanału zgodnych z kryteriami żą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 informacji 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 Żądanie zawiera nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie udało się zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe.
notFound (404) channelNotFound Nie można znaleźć kanału powiązanego z żądaniem.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału powiązanej z żądaniem.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.