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
Этот параметр можно использовать только в правильно авторизованном запросе . Установите для этого параметра значение true , чтобы получить ленту разделов канала, связанных с каналом YouTube пользователя, прошедшего проверку подлинности.
Дополнительные параметры
hl string
Этот параметр устарел. Параметр hl обеспечивает поддержку извлечения локализованных метаданных для раздела канала. Однако эта функция устарела в YouTube Studio и в приложении YouTube.
onBehalfOfContentOwner string
Этот параметр можно использовать только в правильно авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

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

Тело запроса

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

Ответ

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

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

Характеристики

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

Характеристики
kind string
Идентифицирует тип ресурса API. Значение будет youtube#channelSectionListResponse .
etag etag
Etag этого ресурса.
items[] list
Список ChannelSections, соответствующих критериям запроса.

Ошибки

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

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

Попробуй это!

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