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

ChannelSections: update

Обновляет раздел канала.

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

Общие варианты использования

Запрос

HTTP-запрос

PUT 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` указывает, что учетные данные авторизации запроса идентифицируют пользователя CMS YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют множеством различных каналов YouTube и управляют ими. Это позволяет владельцам контента пройти аутентификацию один раз и получить доступ ко всем своим видео и данным канала без необходимости предоставлять учетные данные для аутентификации для каждого отдельного канала. Учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента 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)`	`idInvalid`	Свойство `id` указывает недопустимый идентификатор раздела канала.
`invalidValue (400)`	`idRequired`	Свойство `id` должно указывать значение, идентифицирующее обновляемый раздел канала.
`invalidValue (400)`	`inValidPosition`	Свойство `snippet.position` содержит недопустимое значение.
`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)`	`channelSectionNotFound`	Раздел канала, который вы пытаетесь обновить, не найден.
`notFound (404)`	`playlistNotFound`	Не удается найти один или несколько указанных списков воспроизведения.

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

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