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