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