Эта страница переведена с помощью Cloud Translation API.

ChannelSections: insert

Добавляет раздел канала в канал аутентифицированного пользователя. В канале можно создать максимум 10 полок.

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

Распространенные случаи использования

Запрос

HTTP-запрос

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

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

Параметры

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

Параметры
Обязательные параметры
`part`	`string` Параметр `part` в этой операции служит двум целям. Он определяет свойства, которые будут установлены операцией записи, а также свойства, которые будут включены в ответ API. Следующий список содержит названия `part` , которые можно включить в значение параметра: `contentDetails` `id` `snippet`
Дополнительные параметры
`onBehalfOfContentOwner`	`string` Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр `onBehalfOfContentOwner` указывает, что учетные данные авторизации запроса идентифицируют пользователя YouTube CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube.
`onBehalfOfContentOwnerChannel`	`string` Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр `onBehalfOfContentOwnerChannel` указывает идентификатор канала YouTube, на который добавляется видео. Этот параметр является обязательным, если в запросе указано значение параметра `onBehalfOfContentOwner` , и его можно использовать только вместе с этим параметром. Кроме того, запрос должен быть авторизован с использованием учетной записи CMS, связанной с владельцем контента, указанным в параметре `onBehalfOfContentOwner` . Наконец, канал, указанный в значении параметра `onBehalfOfContentOwnerChannel` , должен быть связан с владельцем контента, указанным в параметре `onBehalfOfContentOwner` . Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Он позволяет владельцам контента один раз пройти аутентификацию и выполнять действия от имени канала, указанного в значении параметра, без необходимости предоставления учетных данных аутентификации для каждого отдельного канала.

Тело запроса

Укажите ресурс ChannelSection в теле запроса. Для этого ресурса:

Вы должны указать значение для этих свойств:
- snippet.type
Вы можете установить значения для этих свойств:
- snippet.type
- snippet.title
- snippet.position
- contentDetails.playlists[]
- contentDetails.channels[]

Ответ

В случае успеха этот метод возвращает ресурс ChannelSection в теле ответа.

Ошибки

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

Тип ошибки	Детализация ошибки	Описание
`badRequest (400)`	`notEditable`	Этот раздел канала не может быть создан.
`badRequest (400)`	`typeRequired`	Ресурс `channelSection` должен указать значение поля `snippet.type` .
`forbidden (403)`	`channelSectionForbidden`	Запрос не прошел проверку подлинности или не поддерживается для этого канала.
`invalidValue (400)`	`channelNotActive`	По крайней мере один из указанных каналов не активен.
`invalidValue (400)`	`channelsDuplicated`	Запрос не выполнен, поскольку указаны повторяющиеся каналы.
`invalidValue (400)`	`channelsNeeded`	Если свойство `snippet.type` имеет значение `multipleChannels` , то необходимо указать свойство `contentDetails.channels[]` и указать хотя бы один канал.
`invalidValue (400)`	`channelsNotExpected`	Ресурс, предоставленный вместе с запросом, указал значение свойства `contentDetails.channels[]` , но каналы не ожидаются для этого типа раздела канала.
`invalidValue (400)`	`contentDetailsNeeded`	Вставляемый ресурс должен содержать объект `contentDetails` для этого типа раздела канала.
`invalidValue (400)`	`inValidPosition`	Свойство `snippet.position` содержит недопустимое значение.
`invalidValue (400)`	`maxChannelSectionExceeded`	Запрос невозможно выполнить, поскольку в канале уже имеется максимальное количество разделов канала.
`invalidValue (400)`	`maxChannelsExceeded`	Запрос не выполнен, так как была предпринята попытка включить слишком много каналов в раздел каналов.
`invalidValue (400)`	`maxPlaylistExceeded`	Запрос не выполнен, так как была предпринята попытка включить слишком много плейлистов в раздел канала.
`invalidValue (400)`	`onePlaylistNeeded`	Если свойство `snippet.type` имеет значение `singlePlaylist` , то свойство `contentDetails.playlists[]` должно указывать ровно один список воспроизведения.
`invalidValue (400)`	`ownChannelInChannels`	Вы не можете включить свой собственный канал в раздел канала, который появляется на этом канале.
`invalidValue (400)`	`playlistIsPrivate`	Один или несколько из указанных плейлистов являются частными и поэтому не могут быть включены в раздел канала.
`invalidValue (400)`	`playlistsDuplicated`	Запрос не выполнен, поскольку в нем указаны повторяющиеся плейлисты.
`invalidValue (400)`	`playlistsNeeded`	Если свойство `snippet.type` имеет значение `singlePlaylist` или `multiplePlaylists` , необходимо указать свойство `contentDetails.playlists[]` .
`invalidValue (400)`	`playlistsNotExpected`	Ресурс, предоставленный вместе с запросом, указал значение свойства `contentDetails.playlists[]` , но списки воспроизведения не ожидаются для этого типа раздела канала.
`invalidValue (400)`	`snippetNeeded`	Необходимо указать `snippet` для создания раздела канала.
`invalidValue (400)`	`titleLengthExceeded`	Значение свойства `snippet.title` слишком длинное.
`invalidValue (400)`	`titleRequired`	Если свойство `snippet.type` имеет значение `multiplePlaylists` или `multipleChannels` , необходимо задать заголовок раздела, указав значение свойства `snippet.title` .
`notFound (404)`	`channelNotFound`	Невозможно найти один или несколько указанных каналов.
`notFound (404)`	`playlistNotFound`	Невозможно найти один или несколько указанных плейлистов.

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

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.