ChannelSections: list

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

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Parametry

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

Parametry
Parametry wymagane
part string
Parametr part określa rozdzieloną przecinkami listę co najmniej jednej właściwości zasobu channelSection, która ma być uwzględniona w odpowiedzi interfejsu API.

Jeśli parametr wskazuje właściwość zawierającą właściwości podrzędne, zostaną one uwzględnione w odpowiedzi. 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 też zawierać wszystkie te zagnieżdżone właściwości.

Ta lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
Filtry (podaj jeden z tych parametrów)
channelId string
Parametr channelId określa identyfikator kanału YouTube. Jeśli żądanie określa 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). W zasobie channelSection właściwość id określa identyfikator sekcji.
mine boolean
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Ustaw wartość tego parametru na true, aby pobierać kanały z sekcji kanału powiązanych z kanałem YouTube uwierzytelnionego użytkownika.
Parametry opcjonalne
hl string
Ten parametr został wycofany. Parametr hl umożliwił pobieranie zlokalizowanych metadanych sekcji kanału. Ta funkcja została jednak wycofana w YouTube Studio oraz w aplikacji YouTube.
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelni, 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, metoda zwróci odpowiedź w następującym formacie:

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

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#channelSectionListResponse.
etag etag
Otagowanie tego zasobu.
items[] list
Lista sekcji kanałów, które spełniają kryteria żą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 wybranych sekcji kanału.
invalidValue (400) idInvalid Żądanie określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie można zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe.
notFound (404) channelNotFound Nie udało się znaleźć kanału powiązanego z prośbą.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału powiązanej z żądaniem.

Wypróbuj

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