Channels: update

Ahora, la API admite la capacidad de marcar tu canal o videos como "creados 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 de los Servicios de APIs de YouTube y las Políticas para Desarrolladores también se actualizaron el 10 de enero de 2020. Para obtener más información, consulta los historiales de revisión de Servicio de la API de YouTube Data y las Condiciones del Servicio de los Servicios de APIs 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 alcances. Para obtener más información sobre la autenticación y la 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 propiedades 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 para todas las propiedades mutables que se incluyen 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 correctamente.

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 acceder a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal. La cuenta de CMS real con la que se autentica el usuario debe estar vinculada al propietario del contenido de YouTube especificado.

Este parámetro se debe proporcionar si la solicitud se autentica con credenciales para un usuario propietario de contenido de CMS que actúa en un canal administrado. Si se omite, la solicitud se ejecuta en el contexto directo del usuario autenticado y muestra un error HTTP 403 (acceso prohibido).

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 se aplica correctamente, 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 la API podría mostrar en respuesta a una llamada a este método. Para obtener más detalles, consulta API de YouTube Data: 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 las propiedades según los lineamientos de la documentación del recurso channels.
badRequest (400) channelTitleUpdateForbidden Cuando actualices la 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 establecer 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 según 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 una compensación de tiempo no válida en la parte invideoPromotion.
badRequest (400) invalidTimingOffset Los metadatos de la solicitud especifican una compensación de tiempo no válida para determinar cuándo el elemento promocionado 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 del recurso channels.
badRequest (400) tooManyPromotedItems Se superó la cantidad permitida de elementos promocionados en la parte invideoPromotion.
forbidden (403) channelForbidden El canal especificado en el parámetro id no admite la solicitud o esta no está autorizada correctamente.
forbidden (403) promotedVideoNotAllowed No se puede encontrar el canal que la solicitud a 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 recentlyUploadedBy especificado.
notFound (404) unknownVideoId No se puede encontrar el ID de video especificado como un elemento promocionado.
required (400) requiredItemIdType Los metadatos de la solicitud deben especificar un tipo de elemento 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 una compensación de tiempo predeterminada 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 compensación de tiempo para que YouTube pueda determinar cuándo mostrar el elemento promocionado. 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 promocionado. 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 promocionado. 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 en la parte invideoPromotion.
required (400) requiredVideoId Los metadatos de la solicitud deben especificar un ID de video para identificar el elemento promocionado.
required (400) requiredWebsiteUrl Los metadatos de la solicitud deben especificar una URL del 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 el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.