Esta página foi traduzida pela API Cloud Translation.

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.