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 указывает, что учетные данные, которые используются для авторизации запроса, идентифицируют пользователя системы управления контентом 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 и ответ.