ChannelSections: list

Возвращает список ресурсов channelSection, соответствующих критериям запроса к API.

Влияние на квоту. Вызов этого метода имеет стоимость квоты в 1 единицу.

Примеры использования

Запрос

HTTP-запрос

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

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part определяет список свойств ресурса channelSection, разделенных запятыми, которые будут включены в ответ API.

Если параметр определяет свойство, содержащее дочерние свойства, они также будут включены в ответ. Например, в ресурсе channelSection свойство snippet содержит другие свойства, такие как заголовок раздела. Если вы зададите параметр part=snippet, ответ API будет содержать все вложенные свойства.

В списке ниже приведены названия part, которые можно включить в значение параметра:
  • contentDetails
  • id
  • snippet
Фильтры (укажите ровно один из следующих параметров)
channelId string
Параметр channelId задает идентификатор канала YouTube. Если в запросе указано значение этого параметра, API вернет только разделы указанного канала.
id string
Параметр id содержит список идентификаторов, разделенных запятыми. Каждый из них соответствует определенному ресурсу channelSection. В ресурсе channelSection свойство id указывает на идентификатор раздела.
mine boolean
Этот параметр можно использовать только в авторизованном запросе. Чтобы получить фид разделов, связанных с каналом YouTube аутентифицированного пользователя, задайте для этого параметра значение true.
Необязательные параметры
hl string
Этот параметр больше не поддерживается. Параметр hl позволял получать локализованные метаданные для раздела канала. Однако в Творческой студии YouTube и приложении YouTube эта функция больше не поддерживается.
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube по контенту.

Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя системы управления контентом YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.

Тело запроса

При вызове этого метода не указывайте тело запроса.

Ответ

В случае успеха метод возвращает тело ответа со следующей структурой:

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

Свойства

В таблице ниже приведены свойства, которые используются в этом ресурсе.

Свойства
kind string
Тип ресурса API. Значение будет youtube#channelSectionListResponse.
etag etag
Тег ETag этого ресурса.
items[] list
Список разделов канала, соответствующих критериям запроса.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробную информацию можно найти в документации по сообщениям об ошибках.

Тип ошибки Сведения об ошибке Описание
forbidden (403) channelSectionForbidden У пользователя, отправившего запрос, нет доступа к запрошенным разделам канала.
invalidValue (400) idInvalid В запросе указан недопустимый идентификатор раздела канала.
invalidValue (400) invalidCriteria Не удалось выполнить запрос, поскольку критерии фильтрации недействительны.
notFound (404) channelNotFound Не удалось найти канал, указанный в запросе.
notFound (404) channelSectionNotFound Не удалось найти раздел канала, указанный в запросе.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.