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.