Se usó la API de Cloud Translation para traducir esta página.

Channels: update

La API ahora admite la capacidad de marcar tu canal o videos como “creado para niños”. Además, los recursos channel y video ahora también contienen una propiedad que identifica el estado “creado para niños” de ese canal o video. Las Condiciones del Servicio y las Políticas para Desarrolladores de los Servicios de la API de YouTube también se actualizaron el 10 de enero de 2020. Para obtener más información, consulta los registros de revisión del Servicio de la API de YouTube Data y las Condiciones del Servicio de los Servicios de la API de YouTube.

Actualiza los metadatos de un canal. Ten en cuenta que este método solo admite actualizaciones de los objetos brandingSettings, invideoPromotion y localizations del recurso channel y sus propiedades secundarias.

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

Casos de uso habituales

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/youtube/v3/channels

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes permisos. Para obtener más información sobre la autenticación y autorización, consulta Cómo implementar la autorización de OAuth 2.0.

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 que incluirá la respuesta de la API. La API solo permite que el valor del parámetro se establezca en `brandingSettings`, `invideoPromotion` o `localizations`. (Solo puedes actualizar cualquiera de esas partes con una sola solicitud). Ten en cuenta que este método anula los valores existentes de todas las propiedades mutables que se contienen en la parte que especifica el valor del parámetro.
Parámetros opcionales
`onBehalfOfContentOwner`	`string` Este parámetro solo se puede usar en una solicitud autorizada. El parámetro `onBehalfOfContentOwner` indica que el usuario autenticado 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 muchos canales de YouTube diferentes. Permite a los propietarios de 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.

Cuerpo de la solicitud

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

Debes especificar un valor para estas propiedades:
- id
Puedes establecer los valores de las siguientes propiedades:
- brandingSettings.channel.country
- brandingSettings.channel.description
- brandingSettings.channel.defaultLanguage
- brandingSettings.channel.keywords
- brandingSettings.channel.trackingAnalyticsAccountId
- brandingSettings.channel.unsubscribedTrailer
- localizations.(key)
- localizations.(key).title
- localizations.(key).description
- status.selfDeclaredMadeForKids
Si envías una solicitud de actualización sin especificar un valor para una propiedad que ya tiene un valor, el valor actual de la propiedad se eliminará.

Respuesta

Si la respuesta es correcta, este método muestra un recurso channel en el cuerpo de la respuesta.

Errores

En la siguiente tabla, se identifican los mensajes de error que podría mostrar la API en respuesta a una llamada a este método. Para obtener más información, consulta API de datos de YouTube: Errores.

Tipo de error	Detalle del error	Descripción
`badRequest (400)`	`brandingValidationError`	Uno de los valores del objeto `brandingSettings` no pasó la validación. Usa el método `channels.list` para recuperar la configuración existente del canal y actualizar los valores de la propiedad según los lineamientos de la documentación del recurso `channels`.
`badRequest (400)`	`channelTitleUpdateForbidden`	Cuando actualices el `brandingSettings part` de un canal, debes establecer el valor de la propiedad `brandingSettings.channel.title` en el título actual del canal o omitir la propiedad. La API muestra un error si cambias el valor de la propiedad.
`badRequest (400)`	`defaultLanguageNotSetError`	Se debe configurar `defaultLanguage` para actualizar `localizations`.
`badRequest (400)`	`invalidBrandingOption`	Una de las configuraciones del desarrollo de la marca que especificaste no existe. Usa el método `channels.list` para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación del recurso `channels`.
`badRequest (400)`	`invalidCustomMessage`	Los metadatos de la solicitud especifican un mensaje personalizado no válido. Verifica el valor de la propiedad `invideoPromotion.items[].customMessage` en el recurso que envió la solicitud.
`badRequest (400)`	`invalidDuration`	Los metadatos de la solicitud especifican una duración no válida en la parte invideoPromotion.
`badRequest (400)`	`invalidDuration`	Los metadatos de la solicitud especifican un tipo de posición no válido para determinar cómo el elemento promovido se ubica en el reproductor de video. Verifica el valor de la propiedad `invideoPromotion.position.type` en el recurso que envió la solicitud.
`badRequest (400)`	`invalidRecentlyUploadedBy`	Los metadatos de la solicitud especifican un ID de canal no válido. Verifica el valor de la propiedad `invideoPromotion.items[].id.recentlyUploadedBy` en el recurso que envió la solicitud.
`badRequest (400)`	`invalidTimingOffset`	Los metadatos de la solicitud especifican un desfase de tiempo no válido en la parte de invideoPromotion.
`badRequest (400)`	`invalidTimingOffset`	Los metadatos de la solicitud especifican una equidistancia de sincronización no válida para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad `invideoPromotion.timing.offsetMs` en el recurso que envió la solicitud.
`badRequest (400)`	`invalidTimingType`	Los metadatos de la solicitud especifican un método de sincronización no válido para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad `invideoPromotion.timing.type` en el recurso que envió la solicitud.
`badRequest (400)`	`localizationValidationError`	Uno de los valores del objeto localizations no pasó la validación. Usa el método `channels.list` para recuperar valores válidos y asegúrate de actualizarlos según los lineamientos de la documentación de recursos de los canales.
`badRequest (400)`	`tooManyPromotedItems`	Se superó la cantidad permitida de elementos promocionados en la parte de invideoPromotion.
`forbidden (403)`	`channelForbidden`	El canal especificado en el parámetro `id` no admite la solicitud o la solicitud no está autorizada correctamente.
`forbidden (403)`	`promotedVideoNotAllowed`	No se puede encontrar el canal que la solicitud de la API está intentando actualizar. Verifica el valor de la propiedad `id` en el recurso `channel` que envió la solicitud para asegurarte de que el ID del canal sea correcto.
`forbidden (403)`	`websiteLinkNotAllowed`	No se permite la URL del sitio web especificada.
`notFound (404)`	`channelNotFound`	No se puede encontrar el canal especificado en el parámetro `id`.
`notFound (404)`	`channelNotFound`	No se puede encontrar el canal especificado por el parámetro `id` o no tiene opciones de desarrollo de la marca.
`notFound (404)`	`unknownChannelId`	No se encontró el ID de canal especificado.
`notFound (404)`	`unknownChannelId`	No se encontró el ID de canal de recentlyUploadedBy especificado.
`notFound (404)`	`unknownVideoId`	No se puede encontrar la identificación de video especificada como un elemento promocionado.
`required (400)`	`requiredItemIdType`	Los metadatos de la solicitud deben especificar un tipo de artículo en la parte invideoPromotion.
`required (400)`	`requiredItemId`	Los metadatos de la solicitud deben especificar un ID de artículo en la parte invideoPromotion.
`required (400)`	`requiredTimingOffset`	Los metadatos de la solicitud deben especificar un desfase de tiempo predeterminado para que YouTube pueda determinar cuándo mostrar el elemento promocionado. Establece el valor de la propiedad `invideoPromotion.defaultTiming.offsetMs` en el recurso que envía la solicitud.
`required (400)`	`requiredTimingOffset`	Los metadatos de la solicitud deben especificar una equidistancia de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad `invideoPromotion.timing.offsetMs` en el recurso que envía la solicitud.
`required (400)`	`requiredTimingType`	Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad `invideoPromotion.defaultTiming.type` en el recurso que envía la solicitud.
`required (400)`	`requiredTimingType`	Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad `invideoPromotion.timing.type` en el recurso que envía la solicitud.
`required (400)`	`requiredTiming`	Los metadatos de la solicitud deben especificar un tiempo para cada elemento de la parte `invideoPromotion`.
`required (400)`	`requiredVideoId`	Los metadatos de la solicitud deben especificar una identificación de video para identificar el elemento promocionado.
`required (400)`	`requiredWebsiteUrl`	Los metadatos de la solicitud deben especificar una URL de sitio web en la parte invideoPromotion. Establece el valor de la propiedad `invideoPromotion.items[].id.websiteUrl` en el recurso que envía la solicitud.

Pruébalo

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