ChannelSections: insert

Agrega una sección al canal del usuario autenticado. Cada canal puede crear hasta 10 bibliotecas.

Impacto de la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.

Casos de uso habituales

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/youtube/v3/channelSections

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

Alcance
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parámetros

En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part tiene dos propósitos en esta operación. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que incluirá la respuesta de la API.

La siguiente lista contiene los nombres de part que puedes incluir en el valor del parámetro:
  • contentDetails
  • id
  • snippet
Parámetros opcionales
onBehalfOfContentOwner string
Este parámetro solo se puede usar en una solicitud autorizada debidamente. Nota: Este parámetro está dirigido exclusivamente a socios de contenido de YouTube.

El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. Este parámetro está dirigido a socios de contenido de YouTube que poseen y administran varios canales de YouTube diferentes. Permite a los propietarios del contenido autenticarse una vez y tener acceso a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado.
onBehalfOfContentOwnerChannel string
Este parámetro solo se puede usar en una solicitud autorizada debidamente. Nota: Este parámetro está dirigido exclusivamente a socios de contenido de YouTube.

El parámetro onBehalfOfContentOwnerChannel especifica el ID del canal de YouTube al que se agrega un video. Este parámetro es obligatorio cuando una solicitud especifica un valor para el parámetro onBehalfOfContentOwner y solo se puede usar junto con ese parámetro. Además, la solicitud debe autorizarse con una cuenta de CMS que esté vinculada al propietario del contenido que especifica el parámetro onBehalfOfContentOwner. Por último, el canal que especifica el valor del parámetro onBehalfOfContentOwnerChannel debe estar vinculado al propietario del contenido especificado en el parámetro onBehalfOfContentOwner.

Este parámetro está dirigido a socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. Permite a los propietarios de contenido autenticarse una vez y llevar a cabo acciones en nombre del canal especificado en el valor del parámetro, sin tener que proporcionar credenciales de autenticación para cada canal por separado.

Cuerpo de la solicitud

Proporciona un recurso channelSection en el cuerpo de la solicitud Para ese recurso:

  • Debes especificar un valor para estas propiedades:

    • snippet.type

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

Respuesta

Si se aplica correctamente, este método muestra un recurso channelSection en el cuerpo de respuesta.

Errores

En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
badRequest (400) notEditable No se puede crear esta sección del canal.
badRequest (400) typeRequired El recurso channelSection debe especificar un valor para el campo snippet.type.
forbidden (403) channelSectionForbidden La solicitud no se autenticó correctamente o no es compatible con este canal.
invalidValue (400) channelNotActive Al menos uno de los canales especificados no está activo.
invalidValue (400) channelsDuplicated La solicitud falló porque especificó canales duplicados.
invalidValue (400) channelsNeeded Si la propiedad snippet.type tiene un valor de multipleChannels, se debe especificar la propiedad contentDetails.channels[], que debe especificar al menos un canal.
invalidValue (400) channelsNotExpected El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.channels[], pero no se esperan canales para este tipo de sección de canales.
invalidValue (400) contentDetailsNeeded El recurso que insertas debe contener un objeto contentDetails para este tipo de sección de canal.
invalidValue (400) inValidPosition La propiedad snippet.position contiene un valor no válido.
invalidValue (400) maxChannelSectionExceeded No se puede completar la solicitud porque el canal ya alcanzó la cantidad máxima de secciones.
invalidValue (400) maxChannelsExceeded La solicitud falló porque intentó incluir demasiados canales en la sección de canales.
invalidValue (400) maxPlaylistExceeded La solicitud falló porque intentó incluir demasiadas playlists en la sección del canal.
invalidValue (400) onePlaylistNeeded Si la propiedad snippet.type tiene el valor singlePlaylist, la propiedad contentDetails.playlists[] debe especificar exactamente una playlist.
invalidValue (400) ownChannelInChannels No puedes incluir tu propio canal en una sección que aparece allí.
invalidValue (400) playlistIsPrivate Una o más de las playlists especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal.
invalidValue (400) playlistsDuplicated La solicitud falló porque especificó playlists duplicadas.
invalidValue (400) playlistsNeeded Si la propiedad snippet.type tiene un valor de singlePlaylist o multiplePlaylists, se debe especificar la propiedad contentDetails.playlists[].
invalidValue (400) playlistsNotExpected El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.playlists[], pero no se esperan playlists para este tipo de sección de canal.
invalidValue (400) snippetNeeded Debes especificar un snippet para crear la sección del canal.
invalidValue (400) titleLengthExceeded El valor de la propiedad snippet.title es demasiado largo.
invalidValue (400) titleRequired Si la propiedad snippet.type tiene un valor de multiplePlaylists o multipleChannels, debes establecer el título de la sección especificando un valor para la propiedad snippet.title.
notFound (404) channelNotFound No se pudo encontrar uno o más de los canales especificados.
notFound (404) playlistNotFound No se puede encontrar una o más de las playlists especificadas.

Pruébalo

Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.