Channels: update

Agora a API permite marcar seu canal ou vídeos como "conteúdo para crianças". Além disso, os recursos channel e video agora também contêm uma propriedade que identifica o status "conteúdo para crianças" desse canal ou vídeo. Os Termos de Serviço e as Políticas do desenvolvedor dos serviços da API YouTube também foram atualizados em 10 de janeiro de 2020. Para mais informações, consulte os históricos de revisão do serviço da API YouTube Data e os Termos de Serviço da API YouTube.

Atualiza os metadados de um canal. No momento, esse método só oferece suporte a atualizações dos objetos brandingSettings, invideoPromotion e localizations do recurso channel e das propriedades filhas deles.

Impacto da cota:uma chamada para esse método tem um custo de cota de 50 unidades.

Casos de uso comuns

Solicitação

Solicitação HTTP

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

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).

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

Parâmetros

A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.

Parâmetros
Parâmetros obrigatórios
part string
O parâmetro part tem duas finalidades nesta operação. Ele identifica as propriedades que a operação de gravação vai definir, bem como as propriedades que a resposta da API vai incluir.

No momento, a API só permite que o valor do parâmetro seja definido como brandingSettings, invideoPromotion ou localizations. Só é possível atualizar qualquer uma dessas partes com uma única solicitação.

Esse método substitui os valores atuais de todas as propriedades mutáveis contidas na parte especificada pelo valor do parâmetro.
Parâmetros opcionais
onBehalfOfContentOwner string
Esse parâmetro só pode ser usado em uma solicitação autorizada corretamente. O parâmetro onBehalfOfContentOwner indica que o usuário autenticado está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. Este parâmetro destina-se a parceiros de conteúdo do YouTube que possuem e gerenciam vários canais do YouTube diferentes. Ele permite que os proprietários de conteúdo autentiquem uma vez e tenham acesso a todos os dados de seu canal e de seus vídeos sem ter que fornecer credenciais de autenticação para cada canal. A conta do CMS real com a qual o usuário autentica precisa estar vinculada ao proprietário do conteúdo do YouTube especificado.

Corpo da solicitação

Forneça um recurso de canal no corpo da solicitação. Para esse recurso:

  • É necessário especificar um valor para essas propriedades:

    • id

  • Você pode definir valores para estas propriedades:

    • 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

    Se você estiver enviando uma solicitação de atualização e ela não especificar um valor para uma propriedade que já tenha um, o valor existente da propriedade será excluído.

Resposta

Se for bem-sucedido, este método retorna um recurso de canal no corpo da resposta.

Erros

A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.

Tipo de erro Detalhe do erro Descrição
badRequest (400) brandingValidationError Falha na validação de um dos valores no objeto brandingSettings. Use o método channels.list para recuperar as configurações atuais do canal e atualizar os valores da propriedade seguindo as orientações da documentação de recursos channels.
badRequest (400) channelTitleUpdateForbidden Ao atualizar o brandingSettings part de um canal, você precisa definir o valor da propriedade brandingSettings.channel.title como o título atual do canal ou omitir a propriedade. A API retornará um erro se você alterar o valor da propriedade.
badRequest (400) defaultLanguageNotSetError O defaultLanguage precisa ser definido para atualizar o localizations.
badRequest (400) invalidBrandingOption Uma das configurações de marca que você especificou não existe. Use o método channels.list para extrair valores válidos e atualize-os de acordo com as diretrizes na documentação de recursos channels.
badRequest (400) invalidCustomMessage Os metadados da solicitação especificam uma mensagem personalizada inválida. Verifique o valor da propriedade invideoPromotion.items[].customMessage no recurso que a solicitação enviou.
badRequest (400) invalidDuration Os metadados da solicitação especificam uma duração inválida na parte invideo Promotion.
badRequest (400) invalidDuration Os metadados da solicitação especificam um tipo de posição inválido para determinar como o item promovido está posicionado no player de vídeo. Verifique o valor da propriedade invideoPromotion.position.type no recurso que a solicitação enviou.
badRequest (400) invalidRecentlyUploadedBy Os metadados da solicitação especificam um ID de canal inválido. Verifique o valor da propriedade invideoPromotion.items[].id.recentlyUploadedBy no recurso que a solicitação enviou.
badRequest (400) invalidTimingOffset Os metadados da solicitação especificam um ajuste de horário inválido na parte invideo Promotion.
badRequest (400) invalidTimingOffset Os metadados da solicitação especificam um ajuste de horário inválido para determinar quando o item promovido deve ser exibido no player de vídeo. Verifique o valor da propriedade invideoPromotion.timing.offsetMs no recurso que a solicitação enviou.
badRequest (400) invalidTimingType Os metadados da solicitação especificam um método de tempo inválido para determinar quando o item promovido deve ser exibido no player de vídeo. Verifique o valor da propriedade invideoPromotion.timing.type no recurso que a solicitação enviou.
badRequest (400) localizationValidationError Falha na validação de um dos valores no objeto de localização. Use o método channels.list para recuperar valores válidos e não se esqueça de atualizá-los de acordo com as orientações contidas na documentação do recurso de canais.
badRequest (400) tooManyPromotedItems O número de itens promovidos permitidos foi excedido na parte invideo Promotion.
forbidden (403) channelForbidden O canal especificado no parâmetro id não suporta a solicitação ou a solicitação não está devidamente autorizada.
forbidden (403) promotedVideoNotAllowed O canal que a solicitação da API está tentando atualizar não pode ser encontrado. Verifique o valor da propriedade id no recurso channel que a solicitação enviou para garantir que o ID do canal esteja correto.
forbidden (403) websiteLinkNotAllowed O URL do site especificado não é permitido.
notFound (404) channelNotFound O canal especificado no parâmetro id não foi encontrado.
notFound (404) channelNotFound O canal especificado pelo parâmetro id não foi encontrado ou não tem opções de marca.
notFound (404) unknownChannelId O ID do canal especificado não foi encontrado.
notFound (404) unknownChannelId O ID do canalThe[latestUploadBy] especificado não foi encontrado.
notFound (404) unknownVideoId O ID do vídeo especificado como um item promovido não pode ser encontrado.
required (400) requiredItemIdType Os metadados da solicitação precisam especificar um tipo de item na parte invideo Promotion.
required (400) requiredItemId Os metadados da solicitação devem especificar um ID de item na parte invideo Promotion.
required (400) requiredTimingOffset Os metadados da solicitação precisam especificar um ajuste de horário padrão para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.defaultTiming.offsetMs no recurso enviado pela solicitação.
required (400) requiredTimingOffset Os metadados da solicitação devem especificar um ajuste de horário para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.timing.offsetMs no recurso enviado pela solicitação.
required (400) requiredTimingType Os metadados da solicitação devem especificar um método de horário para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.defaultTiming.type no recurso enviado pela solicitação.
required (400) requiredTimingType Os metadados da solicitação devem especificar um método de horário para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.timing.type no recurso enviado pela solicitação.
required (400) requiredTiming Os metadados da solicitação precisam especificar um tempo para cada item na parte invideoPromotion.
required (400) requiredVideoId Os metadados da solicitação devem especificar um ID de vídeo para identificar o item promovido.
required (400) requiredWebsiteUrl Os metadados da solicitação precisam especificar um URL de site na parte invideo Promotion. Defina o valor da propriedade invideoPromotion.items[].id.websiteUrl no recurso enviado pela solicitação.

Confira!

Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.