Histórico de revisões

Esta página lista as mudanças na API YouTube Data (v3) e atualizações da documentação. Assine este registro de alterações.

30 de outubro de 2024

Agora, a API oferece suporte à capacidade de identificar vídeos com conteúdo alterado ou sintético (A/S) realista. Saiba mais sobre as políticas do YouTube relacionadas a conteúdo de A/S.

Exemplos de conteúdo de A/S incluem vídeos que:

• Fazer uma pessoa real parecer dizer ou fazer algo que não disse ou fez
• Alterar filmagens de um evento ou lugar real
• Geração de uma cena de aparência realista que não existiu de verdade

Para indicar se um vídeo contém conteúdo de A/S, defina a propriedade status.containsSyntheticMedia. Essa propriedade pode ser definida ao chamar os métodos videos.insert ou videos.update. Se definida, a propriedade será retornada no recurso video.

30 de abril de 2024

Observação:este é um anúncio de descontinuação.

Esta atualização contém as seguintes alterações:

A API não oferece mais suporte para inserir ou recuperar discussões de canais. Essa mudança é consistente com a funcionalidade disponível no site do YouTube, que não permite postar comentários em canais.

13 de março de 2024

Observação:este é um anúncio de descontinuação.

Esta atualização contém as seguintes alterações:

O parâmetro sync para os métodos captions.insert e captions.update foi descontinuado. O YouTube vai deixar de oferecer suporte ao parâmetro a partir de 12 de abril de 2024.

Como resultado dessa mudança, os desenvolvedores precisam incluir informações de tempo ao inserir ou atualizar faixas de legenda, caso contrário, o upload vai falhar.

12 de março de 2024

Esta atualização contém as seguintes alterações:

A documentação do recurso captions foi atualizada para informar que o comprimento máximo permitido para o campo snippet.name é de 150 caracteres. A API vai retornar um erro nameTooLong se o nome da faixa for mais longo.

7 de março de 2024

Observação:este é um anúncio de descontinuação.

A propriedade de recurso channel brandingSettings.channel.moderateComments foi descontinuada. O YouTube vai deixar de oferecer suporte ao parâmetro a partir de 7 de março de 2024.

31 de janeiro de 2024

Esta atualização contém as seguintes alterações:

O novo parâmetro forHandle do método channels.list permite recuperar informações sobre um canal especificando o identificador do YouTube.

9 de novembro de 2023

Todas as referências ao recurso videoId em Comments foram removidas porque o recurso videoId não está sendo retornado usando uma chamada de API.

12 de setembro de 2023

Observação:este é um anúncio de descontinuação.

O método comments.markAsSpam foi descontinuado há vários anos. Esse método não é mais compatível com o YouTube e não é mais aceito pela API.

Um aviso de descontinuação foi adicionado a todos os documentos que fazem referência ao método comments.markAsSpam.

22 de agosto de 2023

O método search.list agora é compatível com o parâmetro videoPaidProductPlacement. Esse parâmetro permite filtrar os resultados da pesquisa para incluir apenas vídeos que o criador de conteúdo indicou como tendo uma promoção paga.

18 de agosto de 2023

A definição do liveStreamingDetails.concurrentViewers do recurso video foi atualizada para informar que as contagens de espectadores simultâneos retornadas pela API Data do YouTube podem ser diferentes das contagens de espectadores simultâneos processados e sem spam disponíveis no YouTube Analytics. A Central de Ajuda do YouTube tem mais informações sobre as métricas de transmissões ao vivo.

7 de agosto de 2023

Como anunciado em 12 de junho de 2023, o uso do parâmetro relatedToVideoId do método search.list foi descontinuado. Esse parâmetro não é mais compatível, e as referências a ele foram removidas da documentação da API.

28 de junho de 2023

O método thumbnails.set agora oferece suporte ao erro uploadRateLimitExceeded, que indica que o canal fez upload de muitas miniaturas nas últimas 24 horas e precisa tentar novamente mais tarde.

12 de junho de 2023

Observação:este é um anúncio de descontinuação.

O parâmetro relatedToVideoId do método search.list foi descontinuado. O YouTube vai deixar de oferecer suporte ao parâmetro a partir de 7 de agosto de 2023.

No momento, um aviso de descontinuação foi adicionado à documentação do método search.list. Esse parâmetro será totalmente removido da documentação do search.list a partir de 7 de agosto de 2023.

Além disso, um exemplo que demonstra como recuperar vídeos relacionados foi removido do guia de implementação da API.

22 de agosto de 2022

Correção de anotações de tipo para campos video.statistics para string de long não assinado.

5 de agosto de 2022

O YouTube mudou a forma como os IDs de legenda são gerados e, como parte dessa mudança, está atribuindo novos IDs a todas as faixas de legenda. Essa mudança pode ser incompatível com versões anteriores para aplicativos que armazenam valores de caption_id, mas não afeta aplicativos que não armazenam valores de caption_id.

Até 1º de dezembro de 2022, os métodos captions.list, captions.update, captions.download e captions.delete vão oferecer suporte aos IDs de faixa de legenda antigos e novos. No entanto, a partir de 1º de dezembro de 2022, o YouTube vai deixar de oferecer suporte aos IDs de faixa de legenda antigos. Nesse momento, chamar qualquer um desses métodos de API com um ID de faixa de legenda antigo resultará em um erro captionNotFound.

Para se preparar para essa mudança, planeje substituir todos os dados de faixas de legenda armazenadas até 1º de dezembro de 2022. Isso significa que, para qualquer vídeo em que você armazena dados de legenda, é necessário excluir os dados armazenados e chamar o método captions.list para recuperar o conjunto atual de legendas do vídeo e armazenar os dados na resposta da API como de costume.

12 de julho de 2022

Os Termos de Serviço dos serviços de API do YouTube foram atualizados. Consulte os Termos de Serviço dos Serviços da API do YouTube - História de revisões para mais informações.

27 de abril de 2022

A descrição do método videos.insert foi atualizada para informar que o tamanho máximo do arquivo de vídeos enviados aumentou de 128 GB para 256 GB.

8 de abril de 2022

As definições de parâmetro myRecentSubscribers e mySubscribers do método subscriptions.list foram atualizadas para informar que o número máximo de assinantes retornados pela API pode ser limitado. Essa mudança representa uma correção na documentação, e não uma mudança no comportamento da API.

15 de dezembro de 2021

Conforme anunciado em 18 de novembro de 2021, em conjunto com mudanças para tornar as contas de deslikes de vídeo privadas em toda a plataforma do YouTube, a propriedade statistics.dislikeCount do recurso video agora é privada.

Saiba mais sobre essa mudança no blog oficial do YouTube.

18 de novembro de 2021

Junto com as mudanças para tornar a contagem de marcações "Não gostei" de vídeos particular em toda a plataforma do YouTube, a propriedade statistics.dislikeCount do recurso video será privada a partir de 13 de dezembro de 2021. Isso significa que a propriedade só será incluída em uma resposta da API do endpoint videos.list se a solicitação da API tiver sido autenticada pelo proprietário do vídeo.

O endpoint videos.rate não é afetado por essa mudança.

Os desenvolvedores que não mostram as contagens de deslikes publicamente e ainda precisam da contagem de deslikes para o cliente da API podem solicitar uma exceção para inclusão na lista de permissões. Para solicitar uma isenção, preencha este formulário de inscrição.

Saiba mais sobre essa mudança no blog oficial do YouTube.

2 de julho de 2021

Observação:este é um anúncio de descontinuação.

O endpoint commentThreads.update foi descontinuado e não tem mais suporte. Esse endpoint duplicou a funcionalidade disponível em outros endpoints da API. Em vez disso, chame comments.update.

método e, se o código exigir um recurso commentThreads, faça uma chamada secundária para o método commentThreads.list.

1º de julho de 2021

Todos os desenvolvedores que usam os Serviços de API do YouTube precisam concluir uma auditoria de compliance da API para receber mais do que a alocação de cota padrão de 10.000 unidades. Até o momento, o processo de auditoria de compliance e as solicitações de alocações de unidades de cota adicionais foram realizados por desenvolvedores que preencheram e enviaram o Serviços de API do YouTube: formulário de auditoria e extensão de cotas.

Para esclarecer esses processos e atender melhor às necessidades dos desenvolvedores que usam nossos serviços de API, estamos adicionando três novos formulários e um guia para preenchê-los:

• Formulário de solicitações de desenvolvedores auditados: os desenvolvedores que já passaram por uma auditoria de compliance da API podem preencher e enviar este formulário mais curto para solicitar uma extensão de cota alocada.
• Formulário de contestação: os desenvolvedores cujos projetos de API falharam em uma auditoria de compliance (ou tiveram um aumento de unidade de cota negado) podem preencher e enviar este formulário.
• Formulário de mudança de controle: os desenvolvedores ou qualquer parte que opere um cliente de API em nome de um desenvolvedor que passe por uma mudança de controle (por exemplo, em função de compra ou venda de ações, fusão ou outra forma de transação corporativa) associada a um projeto de API precisa preencher e enviar este formulário. Isso permite que a equipe de APIs do YouTube atualize nossos registros, audite a conformidade do caso de uso do novo projeto de API e valide a alocação de cota atual do desenvolvedor.

Cada novo formulário informa o uso pretendido da API do YouTube e nos permite ajudar você melhor.

Confira mais detalhes no nosso novo guia de auditorias de compliance de API.

12 de maio de 2021

Observação:este é um anúncio de descontinuação.

Esta atualização abrange as seguintes mudanças de API:

• A propriedade contentDetails.relatedPlaylists.favorites do recurso channel foi descontinuada. A funcionalidade de favoritos de vídeos foi descontinuada há vários anos, conforme observado na entrada do histórico de revisões de 28 de abril de 2016.

  Antes dessa atualização, a API ainda criava uma nova playlist se um cliente tentasse adicionar um vídeo a uma playlist de favoritos inexistente. A partir de agora, a playlist não será criada nesse caso, e a API vai retornar um erro. As tentativas de modificar as playlists de favoritos adicionando, modificando ou excluindo itens também foram descontinuadas de acordo com os avisos anteriores e podem começar a retornar erros a qualquer momento.

• As seguintes propriedades de recurso channel foram descontinuadas. Essas propriedades já não são mais compatíveis com a interface do YouTube Studio e com o YouTube. Como resultado, eles também não são mais compatíveis com a API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Todas as propriedades foram removidas da representação do recurso channel, e as definições foram removidas da lista de propriedades do recurso. Além disso, os erros associados a essas propriedades foram removidos da documentação específica do método.

• As seguintes propriedades de recurso channelSection foram descontinuadas. Essas propriedades já não são mais compatíveis com a interface do YouTube Studio e com o YouTube. Como resultado, eles também não são mais compatíveis com a API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Junto com essa mudança, o parâmetro hl do método channelSection.list também foi descontinuado, já que os recursos compatíveis com ele não são mais aceitos.

  Todas as propriedades foram removidas da representação do recurso channelSection, e as definições foram removidas da lista de propriedades do recurso. Além disso, os erros associados a essas propriedades foram removidos da documentação específica do método.

• Para a propriedade snippet.type do recurso channelSection, os seguintes valores foram descontinuados. Esses valores já não são aceitos nas páginas de canal do YouTube e, como resultado, também não são mais aceitos pela API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• A propriedade snippet.tags[] do recurso playlist foi descontinuada. Essa propriedade já não é mais compatível com o YouTube e, como resultado, não é mais compatível com a API.

9 de fevereiro de 2021

O recurso playlistItem oferece suporte a duas novas propriedades:

• A propriedade snippet.videoOwnerChannelId identifica o ID do canal que enviou o vídeo da playlist.
• A propriedade snippet.videoOwnerChannelTitle identifica o nome do canal que enviou o vídeo da playlist.

28 de janeiro de 2021

Esta atualização contém as seguintes alterações:

• Os métodos playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list e playlists.update oferecem suporte a um novo erro playlistOperationUnsupported. O erro ocorre quando uma solicitação tenta realizar uma operação que não é permitida para uma playlist específica. Por exemplo, um usuário não pode excluir um vídeo da playlist de vídeos enviados ou a própria playlist.

  Em todos os casos, esse erro retorna um código de resposta HTTP 400 (solicitação inválida).

• Os erros watchHistoryNotAccessible e watchLaterNotAccessible do método playlistItems.list foram removidos da documentação. Embora o histórico de exibição e as listas "Assistir mais tarde" dos usuários não sejam acessíveis pela API, esses erros específicos não são retornados pela API.

15 de outubro de 2020

Duas novas seções foram adicionadas às Políticas para desenvolvedores:

• A nova Seção III.E.4.i fornece mais informações sobre os dados coletados e enviados pelo player incorporado do YouTube. Você é responsável por todos os dados do usuário enviados para nós por qualquer player incorporado do YouTube antes que o usuário interaja com o player para indicar a intenção de reprodução. É possível limitar os dados compartilhados com o YouTube antes que um usuário interaja com o player definindo a reprodução automática como falsa.
• A nova seção III.E.4.j se refere à verificação do status "Conteúdo para crianças" (MFK, na sigla em inglês) antes de incorporar o conteúdo aos seus sites e apps. Você é responsável por saber quando os vídeos incorporados no seu cliente de API são feitos para crianças e tratar os dados coletados do player incorporado de maneira adequada. Por isso, é necessário verificar o status do conteúdo usando o serviço da API Data do YouTube antes de incorporá-lo ao seu cliente de API usando qualquer player incorporado do YouTube.

O novo guia Como encontrar o status MadeForKids de um vídeo explica como procurar o status MFK de um vídeo usando o serviço da API Data do YouTube.

Além dessas mudanças, um lembrete foi adicionado à documentação de parâmetros do player incorporado para explicar que, se você ativar a reprodução automática, ela vai ocorrer sem nenhuma interação do usuário com o player. A coleta e o compartilhamento de dados de reprodução vão ocorrer no carregamento da página.

8 de outubro de 2020

Esta atualização abrange três pequenas mudanças relacionadas ao recurso channel:

• O objeto snippet.thumbnails, que identifica as imagens de miniatura de um canal, pode estar vazio para canais recém-criados e pode levar até um dia para ser preenchido.
• A propriedade statistics.videoCount reflete a contagem de vídeos públicos do canal, mesmo para os proprietários. Esse comportamento é consistente com as contagens mostradas no site do YouTube.
• As palavras-chave do canal, que são identificadas na propriedade brandingSettings.channel.keywords, podem ser truncadas se excederem o comprimento máximo permitido de 500 caracteres ou se contiverem aspas não codificadas ("). O limite de 500 caracteres não é por palavra-chave, mas sim no comprimento total de todas as palavras-chave. Esse comportamento é consistente com o do site do YouTube.

9 de setembro de 2020

Observação:este é um anúncio de descontinuação.

Esta atualização abrange as seguintes mudanças de API. Todas as mudanças vão entrar em vigor a partir de 9 de setembro de 2020, data deste anúncio. Com isso em mente, os desenvolvedores não devem mais depender de nenhum dos recursos de API listados abaixo.

• Os seguintes recursos, métodos, parâmetros e propriedades de recursos da API foram descontinuados imediatamente e vão deixar de funcionar na data deste anúncio ou depois dela:
  • As seguintes propriedades de recurso channel:
    • A propriedade statistics.commentCount
    • O objeto brandingSettings.image e todas as propriedades filhas
    • A lista brandingSettings.hints e todas as propriedades filhas
  • O parâmetro de filtro categoryId do método channels.list
  • O recurso guideCategories e o método guideCategories.list
• As respostas da API para o método channels.list não contêm mais a propriedade prevPageToken se a solicitação da API definir o parâmetro managedByMe como true. Essa mudança não afeta a propriedade prevPageToken para outras solicitações channels.list e não afeta a propriedade nextPageToken para nenhuma solicitação.
• As propriedades contentDetails.relatedPlaylists.watchLater e contentDetails.relatedPlaylists.watchHistory do recurso channel foram anunciadas como descontinuadas em 11 de agosto de 2016. O suporte do método playlistItems.insert e do método playlistItems.delete para essas playlists também foi descontinuado, e as duas propriedades foram removidas da documentação.
• O parâmetro mySubscribers do método channels.list, que foi anunciado como descontinuado em 30 de julho de 2013, foi removido da documentação. Use o método subscriptions.list e o parâmetro mySubscribers para recuperar uma lista de inscritos no canal do usuário autenticado.
• O objeto invideoPromotion do recurso channel e todas as propriedades filhas dele, que foram anunciadas como descontinuadas em 27 de novembro de 2017, foram removidas da documentação.

29 de julho de 2020

Simplificamos nosso processo de cobrança de cota para solicitações de API removendo o custo extra associado ao parâmetro part. A partir de agora, só vamos cobrar o custo básico do método chamado. Confira mais informações sobre a cota simplificada aqui.

O efeito dessa mudança é que a maioria das chamadas de API terá um custo de cota ligeiramente menor, enquanto algumas chamadas de API ainda terão o mesmo custo. Essa mudança não aumenta o custo de nenhuma chamada de API. No geral, o impacto provável é que sua cota alocada, que pode ser vista no console do Google Cloud, vai aumentar um pouco.

Recomendamos que todos os desenvolvedores concluam uma auditoria de compliance para os projetos e garantam o acesso contínuo aos serviços da API YouTube.

Esta entrada do histórico de revisões foi publicada originalmente em 20 de julho de 2020.

28 de julho de 2020

Todos os vídeos enviados pelo endpoint videos.insert de projetos de API não verificados criados após 28 de julho de 2020 serão restritos ao modo de visualização particular. Para suspender essa restrição, cada projeto precisa passar por uma auditoria para verificar a conformidade com os Termos de Serviço.

Os criadores de conteúdo que usam um cliente de API não verificado para enviar vídeos recebem um e-mail explicando que o conteúdo foi bloqueado como privado e que eles podem evitar a restrição usando um cliente oficial ou auditado.

Os projetos de API criados antes de 28 de julho de 2020 não são afetados por essa mudança no momento. No entanto, recomendamos que todos os desenvolvedores concluam uma auditoria de compliance para os projetos para garantir o acesso contínuo aos serviços da API YouTube.

21 de julho de 2020

[Atualizado em 28 de julho de 2020.] A atualização da documentação mencionada nesta entrada do histórico de revisões foi republicada em 28 de julho de 2020.

Ontem, publicamos uma atualização da documentação relacionada ao nosso processo de cobrança de cota. No entanto, devido a circunstâncias imprevistas, a mudança de cota ainda não está em vigor. Como resultado, a documentação foi revertida em prol da precisão. Para evitar confusão, a entrada do histórico de revisão que explica a mudança foi removida e será republicada em breve.

7 de julho de 2020

Observação:este é um anúncio de descontinuação.

Os parâmetros autoLevels e stabilize do método videos.insert foram descontinuados e removidos da documentação. Os valores são ignorados e não afetam a forma como os vídeos recém-enviados são processados.

15 de junho de 2020

O novo guia Como obedecer às políticas do desenvolvedor do YouTube oferece orientações e exemplos para garantir que seus clientes da API sigam partes específicas dos Termos e políticas (TOS) dos serviços de API do YouTube.

Esta orientação oferece informações sobre como o YouTube aplica determinados aspectos dos TOS das APIs, mas não substitui nenhum documento existente. O guia aborda algumas das perguntas mais comuns que os desenvolvedores fazem durante as auditorias de compliance de API. Esperamos que isso simplifique o processo de desenvolvimento de recursos e ajude você a entender como interpretamos e aplicamos nossas políticas.

4 de junho de 2020

Observação:esta é uma atualização de um anúncio anterior de descontinuação.

O recurso de boletim do canal foi totalmente descontinuado. Essa mudança foi anunciada inicialmente em 17 de abril de 2020 e entrou em vigor. Como resultado, o método activities.insert não é mais compatível, e o método activities.list não retorna mais boletins do canal. Para mais detalhes, consulte a Central de Ajuda do YouTube.

17 de abril de 2020

Observação:este é um anúncio de descontinuação.

O YouTube está descontinuando o recurso de boletim do canal. Como resultado, o método activities.insert será descontinuado, e o método activities.list vai deixar de retornar boletins do canal. Essas mudanças vão entrar em vigor na API a partir de 18 de maio de 2020. Para mais detalhes, consulte a Central de Ajuda do YouTube.

31 de março de 2020

Esta atualização contém as seguintes alterações:

• Novos recursos e métodos

  • O novo recurso member representa um membro de um canal do YouTube. Um membro oferece apoio financeiro recorrente a um criador de conteúdo e recebe benefícios especiais. Por exemplo, os membros podem participar de um chat quando o criador ativa o modo exclusivo para membros.

    Esse recurso substitui o recurso sponsor, que é documentado como parte da API YouTube Live Streaming. O recurso sponsor foi descontinuado, e os clientes de API precisam atualizar as chamadas para o método sponsors.list para usar o método members.list.

  • O novo recurso membershipsLevel identifica um nível de preço gerenciado pelo criador que autorizou a solicitação da API. O método membershipsLevels.list recupera uma lista de todos os níveis de associação do criador de conteúdo.

10 de janeiro de 2020

Agora, a API oferece suporte à capacidade de identificar conteúdo direcionado a crianças, que o YouTube chama de "conteúdo para crianças". Saiba mais sobre o conteúdo "para crianças" na Central de Ajuda do YouTube.

Os recursos channel e video oferecem suporte a duas novas propriedades para permitir que criadores de conteúdo e espectadores identifiquem conteúdo para crianças:

• A propriedade selfDeclaredMadeForKids permite que os criadores de conteúdo especifiquem se um canal ou vídeo é feito para crianças.
  
  Para canais, essa propriedade pode ser definida ao chamar o método channels.update. Para vídeos, essa propriedade pode ser definida ao chamar os métodos videos.insert ou videos.update.
  
  Essa propriedade só é incluída em respostas da API que contêm recursos channel ou video se o proprietário do canal autorizou a solicitação da API.
• A propriedade madeForKids permite que qualquer usuário extraia o status "conteúdo para crianças" de um canal ou vídeo. Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids. Consulte a Central de Ajuda do YouTube para mais informações sobre como definir o público do seu canal, vídeos ou transmissões.

Também atualizamos os Termos de Serviço e as Políticas de desenvolvedor dos serviços de API do YouTube. Consulte os Termos de Serviço dos Serviços da API do YouTube - História de revisões para mais informações. As mudanças nos Termos de Serviço dos serviços de API do YouTube e nas políticas para desenvolvedores vão entrar em vigor em 10 de janeiro de 2020 no horário do Pacífico.

10 de setembro de 2019

A documentação de referência da API foi atualizada para refletir uma mudança na maneira como as contagens de inscritos são informadas no YouTube e, consequentemente, nas respostas da API. Como resultado da mudança, as contagens de inscritos retornadas pelo serviço da API YouTube Data são arredondadas para três dígitos significativos para contagens maiores que 1.000 inscritos. Essa mudança afeta a propriedade statistics.subscriberCount do recurso channel.

Observação:essa mudança afeta o valor da propriedade mesmo nos casos em que um usuário envia uma solicitação autorizada para dados sobre o próprio canal. Os proprietários de canais ainda podem conferir o número exato de inscritos no YouTube Studio.

Por exemplo, se um canal tiver 123.456 inscritos, a propriedade statistics.subscriberCount vai conter o valor 123000. A tabela abaixo mostra exemplos de como as contagens de inscritos são arredondadas nas respostas da API e abreviadas em outras interfaces de usuário visíveis publicamente do YouTube:

Exemplo de contagem de inscritos	API YouTube Data	Interfaces do YouTube visíveis publicamente
1,234	1230	1,23 mil
12.345	12300	12,3 mil
123.456	123000	123 mil
1.234.567	1230000	1,23 mi
12.345.678	12300000	12,3 mi
123,456,789	123000000	123 mi

4 de abril de 2019

Esta atualização contém as seguintes alterações:

• A documentação de referência da API foi atualizada para explicar melhor os casos de uso comuns de cada método e fornecer exemplos de código dinâmicos e de alta qualidade pelo widget APIs Explorer. Consulte a documentação do método channels.list para conferir um exemplo. Agora há dois novos elementos nas páginas que descrevem métodos de API:

  • Com o widget do APIs Explorer, você pode selecionar escopos de autorização, inserir valores de parâmetro e de propriedade de exemplo, enviar solicitações de API e conferir as respostas. O widget também oferece uma visualização em tela cheia que mostra exemplos de código completos, que são atualizados dinamicamente para usar os escopos e valores que você inseriu.

  • A seção Casos de uso comuns descreve um ou mais casos de uso comuns para o método explicado na página. Por exemplo, é possível chamar o método channels.list para extrair dados sobre um canal específico ou sobre o canal do usuário atual.

    É possível usar os links nessa seção para preencher o APIs Explorer com valores de exemplo para seu caso de uso ou para abrir o APIs Explorer em tela cheia com esses valores já preenchidos. O objetivo dessas mudanças é facilitar a visualização de exemplos de código que são diretamente aplicáveis ao caso de uso que você está tentando implementar no seu próprio aplicativo.

  No momento, os exemplos de código têm suporte para Java, JavaScript, PHP, Python e curl.

• A ferramenta de exemplos de código também foi atualizada com uma nova interface que oferece todos os mesmos recursos descritos acima. Com essa ferramenta, você pode conferir casos de uso de diferentes métodos, carregar valores no APIs Explorer e abrir o APIs Explorer em tela cheia para conferir exemplos de código em Java, JavaScript, PHP e Python.

  Com essa mudança, as páginas que listavam exemplos de código disponíveis para Java, JavaScript, PHP e Python foram removidas.

• Os guias de início rápido para Java, JavaScript, PHP e Python foram atualizados. Os guias revisados explicam como executar um exemplo com uma chave de API e outro com um ID de cliente OAuth 2.0 usando exemplos de código do APIs Explorer.

As mudanças descritas acima substituem uma ferramenta interativa que foi adicionada à documentação da API em 2017.

9 de julho de 2018

Esta atualização contém as seguintes alterações:

• A definição da propriedade snippet.thumbnails do recurso channel foi atualizada para informar que, ao exibir miniaturas no app, o código precisa usar os URLs de imagem exatamente como eles são retornados nas respostas da API. Por exemplo, o aplicativo não pode usar o domínio http em vez do domínio https em um URL retornado em uma resposta da API.

  A partir de julho de 2018, os URLs das miniaturas do canal só vão estar disponíveis no domínio https, que é como os URLs aparecem nas respostas da API. Após esse período, imagens corrompidas podem aparecer no seu app se ele tentar carregar imagens do YouTube do domínio http.

• Observação:este é um anúncio de descontinuação.

  A propriedade recordingDetails.location.altitude do recurso video foi descontinuada. Não há garantia de que os vídeos vão retornar valores para essa propriedade. Da mesma forma, mesmo que as solicitações de API tentem definir um valor para essa propriedade, é possível que os dados recebidos não sejam armazenados.

22 de junho de 2018

O guia de implementação, anteriormente conhecido como guia de implementação e migração, foi atualizado para remover instruções de migração da API v2 para a v3. Além disso, as instruções também foram removidas para recursos que foram descontinuados na API v3, como vídeos favoritos.

27 de novembro de 2017

Esta atualização contém as seguintes alterações:

• Observação:este é um anúncio de descontinuação.

  O YouTube está removendo o suporte para os recursos Vídeo em destaque e Site em destaque, que são aceitos na API pelo objeto invideoPromotion do recurso channel. Como resultado, esse objeto, incluindo todas as propriedades filhas, está sendo descontinuado.

  Você ainda pode recuperar e definir dados de invideoPromotion até 14 de dezembro de 2017. Depois dessa data:

  • As tentativas de recuperar a parte invideoPromotion ao chamar channels.list vão retornar um invideoPromotion vazio ou nenhum dado invideoPromotion.
  • As tentativas de atualizar dados invideoPromotion ao chamar channels.update vão retornar uma resposta de sucesso até pelo menos 27 de maio de 2018, mas serão tratadas como no-ops, ou seja, não vão realizar uma atualização.

  Depois de 27 de maio de 2018, é possível que essas solicitações retornem mensagens de erro para indicar, por exemplo, que invalidPromotion é uma parte inválida.

16 de novembro de 2017

Esta atualização contém as seguintes alterações:

• A ferramenta interativa de snippet de código agora oferece suporte a exemplos de código Node.js. Os exemplos também aparecem na documentação de quase todos os métodos da API, como o método channels.list.

  Os exemplos personalizáveis foram criados para oferecer um ponto de partida específico para um caso de uso de um aplicativo Node.js. A funcionalidade é semelhante ao código no guia de início rápido do Node.js. No entanto, os exemplos contêm algumas funções de utilitário que não aparecem no início rápido:

  • A função removeEmptyParameters recebe uma lista de pares de chave-valor correspondentes aos parâmetros de solicitação da API e remove os parâmetros que não têm valores.
  • A função createResource recebe uma lista de pares de chave-valor correspondentes às propriedades em um recurso de API. Em seguida, ele converte as propriedades em um objeto JSON que pode ser usado em operações insert e update. O exemplo abaixo mostra um conjunto de nomes e valores de propriedade e o objeto JSON que o código criaria para eles:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Todos esses exemplos foram criados para serem transferidos por download e executados localmente. Para mais informações, consulte os pré-requisitos para executar exemplos de código completos localmente nas instruções da ferramenta de snippet de código.

25 de outubro de 2017

Esta atualização contém as seguintes alterações:

• Os exemplos de código Python na ferramenta interativa de snippet de código foram atualizados para usar as bibliotecas google-auth e google-auth-oauthlib em vez da biblioteca oauth2client, que foi descontinuada.

  Além dessa mudança, a ferramenta agora fornece exemplos de código completos para aplicativos Python instalados e aplicativos de servidor da Web Python, que usam fluxos de autorização um pouco diferentes. Para conferir os exemplos completos (e essa mudança):

  1. Acesse a ferramenta interativa de snippet de código ou a documentação de qualquer método de API, como channels.list.
  2. Clique na guia Python acima dos exemplos de código.
  3. Clique no botão acima das guias para alternar entre um snippet e uma amostra completa.
     
  4. A guia agora mostra um exemplo de código completo que usa o fluxo de autorização InstalledAppFlow. A descrição acima do exemplo explica isso e também inclui um link para um exemplo de aplicativo de servidor da Web.
  5. Clique no link para mudar para o exemplo do servidor da Web. Esse exemplo usa o framework de aplicativos da Web Flask e um fluxo de autorização diferente.

  Todos esses exemplos foram criados para serem transferidos por download e executados localmente. Se você quiser executar os exemplos, consulte as instruções para executar exemplos de código completos localmente nas instruções da ferramenta de snippet de código.

29 de agosto de 2017

Esta atualização contém as seguintes alterações:

• A definição do parâmetro forContentOwner do método search.list foi atualizada para informar que, se esse parâmetro for definido como true, o parâmetro type precisa ser definido como video.
• A definição do parâmetro regionCode do método search.list foi atualizada para esclarecer que o parâmetro restringe os resultados da pesquisa a vídeos que podem ser assistidos na região especificada.
• O YouTube atualizou os logotipos e ícones de branding. Os novos logotipos "Desenvolvido com o YouTube" podem ser baixados na página Diretrizes da promoção de marca. Outros logotipos e ícones do YouTube também aparecem nessa página e podem ser baixados no site da marca do YouTube.

24 de julho de 2017

Esta atualização contém as seguintes alterações:

• Um novo guia de início rápido da API YouTube Data está disponível para iOS. O guia explica como usar a API Data do YouTube em um aplicativo iOS simples escrito em Objective-C ou Swift.
• A ferramenta interativa de snippet de código da API Data do YouTube agora inclui documentação que explica alguns dos recursos da ferramenta:
  • Como executar solicitações de API
  • Como alternar entre snippets e exemplos de código completos
  • Como usar funções boilerplate
  • Como carregar recursos atuais (para métodos de atualização)

  Observação:a ferramenta também está incorporada à documentação de referência da API para métodos da API (exemplo).

1º de junho de 2017

Esta atualização contém as seguintes alterações:

• Observação:este é um anúncio de descontinuação.

  As seguintes propriedades de recurso video estão sendo descontinuadas. Embora as propriedades sejam aceitas até 1º de dezembro de 2017, não há garantia de que os vídeos continuem retornando valores para essas propriedades até essa data. Da mesma forma, as solicitações videos.insert e videos.update que definem esses valores de propriedade não vão gerar erros antes dessa data, mas é possível que os dados recebidos não sejam armazenados.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 de maio de 2017

Esta atualização contém as seguintes alterações:

• A documentação de referência da API foi atualizada para tornar os snippets de código mais onipresentes e interativos. As páginas que explicam métodos de API, como channels.list ou videos.rate, agora têm uma ferramenta interativa que permite visualizar e personalizar snippets de código em Java, JavaScript, PHP, Python, Ruby, Apps Script e Go.

  Para qualquer método, a ferramenta mostra snippets de código para um ou mais casos de uso, e cada caso de uso descreve uma maneira comum de chamar esse método. Por exemplo, é possível chamar o método channels.list para extrair dados sobre um canal específico ou sobre o canal do usuário atual.

  Também é possível interagir com exemplos de código:

  • Modifique os valores de parâmetro e propriedade, e os snippets de código serão atualizados dinamicamente para refletir os valores fornecidos.

  • Alterne entre snippets de código e exemplos completos. Um snippet de código mostra a parte do código que chama o método da API. Um exemplo completo contém esse snippet e o código boilerplate para autorizar e enviar solicitações. As amostras completas podem ser copiadas e executadas na linha de comando ou em um servidor da Web local.

  • Executar solicitações clicando em um botão. Para executar solicitações, você precisa autorizar a ferramenta a chamar a API em seu nome.

  Essa ferramenta substituiu o APIs Explorer nas páginas em que ele está disponível. Cada página mostra um link para que você também tenha a opção de carregar a solicitação em que está trabalhando no APIs Explorer.

• A ferramenta Snippets de código da API Data também foi atualizada com uma nova interface que oferece todos os recursos descritos acima. Os principais novos recursos disponíveis nesta página são:

  • Suporte a solicitações de API que gravam dados.
  • Suporte a exemplos de Java.
  • Código boilerplate mais flexível e abrangente para autorizar usuários e criar solicitações de API.

27 de abril de 2017

Esta atualização contém as seguintes alterações:

• Os novos guias de início rápido explicam como configurar um aplicativo simples que faz solicitações da API Data do YouTube. No momento, os guias estão disponíveis para Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python e Ruby.

30 de março de 2017

Esta atualização contém as seguintes alterações:

• A nova propriedade topicDetails.topicCategories[] do recurso channel contém uma lista de URLs da Wikipedia que descrevem o conteúdo do canal. Os URLs correspondem aos IDs de tópicos retornados na propriedade topicDetails.topicIds[] do recurso.
• A nova propriedade contentDetails.videoPublishedAt do recurso playlistItem identifica o momento em que o vídeo foi publicado no YouTube. O recurso já contém a propriedade snippet.publishedAt, que identifica o momento em que o item foi adicionado à playlist.
• Assim como o recurso channel, o recurso video agora retorna a propriedade topicDetails.topicCategories[], que contém uma lista de URLs do Wikipedia que descrevem o conteúdo do vídeo. Para recursos video, os URLs correspondem aos IDs de tópicos retornados na propriedade topicDetails.relevantTopicIds[] do recurso.
• A nova propriedade contentDetails.contentRating.mpaatRating do recurso video identifica a classificação que a Motion Picture Association of America deu a um trailer ou prévia de filme.

27 de fevereiro de 2017

Como anunciado em 11 de agosto de 2016, o YouTube mudou a lista de IDs de temas compatíveis para uma lista selecionada. A lista completa de IDs de tópicos compatíveis está incluída nas propriedades topicDetails dos recursos channel e video, bem como no parâmetro topicId do método search.list.

Há várias mudanças na lista selecionada:

• Os seguintes tópicos foram adicionados como subtópicos de Society:

  Nome	ID do tópico
  Negócios	/m/09s1f
  Saúde	/m/0kt51
  Militar	/m/01h6rj
  Política	/m/05qt0
  Religião	/m/06bvp

• O tópico Animated cartoon, anteriormente filho de Entertainment, foi removido.
• O tópico Children's music, anteriormente filho de Music, foi removido.

Como resultado dessa mudança, os temas relacionados a um vídeo agora são sempre retornados no valor da propriedade topicDetails.relevantTopicIds[] do recurso video.

29 de novembro de 2016

Esta atualização contém as seguintes alterações:

• Há três pequenas mudanças na lista de IDs de tópicos que serão aceitos a partir de 10 de fevereiro de 2017:

  • A categoria Professional wrestling, que antes era filha da categoria Sports, agora é filha de Entertainment.
  • A categoria TV shows, que é filha de Entertainment, é nova.
  • A categoria Health, anteriormente filha de Lifestyle, foi removida.

  Além disso, há algumas categorias principais (Entertainment, Gaming, Lifestyle, Music e Sports). Qualquer vídeo associado a uma categoria secundária, como Tennis, também será associado à categoria principal (Sports).

10 de novembro de 2016

Esta atualização contém as seguintes alterações:

• Como anunciado pela primeira vez em 11 de agosto de 2016, a descontinuação do Freebase e da API Freebase exige várias mudanças relacionadas aos IDs de tópico. Os IDs de tópico identificam tópicos associados aos recursos channel e video. Você também pode usar o parâmetro de pesquisa topicId para encontrar canais ou vídeos relacionados a um tópico específico.

  Em 10 de fevereiro de 2017, o YouTube vai começar a retornar um pequeno conjunto de IDs de tópicos em vez do conjunto muito mais granular de IDs retornados até agora. Além disso, não há garantia de que os canais e vídeos sejam associados a algum tema, o que é consistente com o comportamento atual da API.

  Para que você possa preparar seus clientes de API para essas mudanças, as definições dos parâmetros e das propriedades a seguir foram atualizadas para listar os IDs de tópico que serão aceitos após esse período. A lista de categorias é a mesma para todas as propriedades.

  • A propriedade topicDetails.topicIds[] do recurso channel.
  • A propriedade topicDetails.relevantTopicIds[] do recurso video.
  • O parâmetro topicId do método search.list.

• Observação:este é um anúncio de descontinuação.

  As seguintes propriedades estão sendo descontinuadas:

  • A propriedade topicDetails.topicIds[] do recurso channel. Essa propriedade vai ser compatível até 10 de novembro de 2017.
  • A propriedade topicDetails.relevantTopicIds[] do recurso video. Essa propriedade vai ser compatível até 10 de novembro de 2017.
  • A propriedade topicDetails.topicIds[] do recurso video. Essa propriedade não vai conter valores após 10 de fevereiro de 2017. Depois dessa data, o valor da propriedade topicDetails.relevantTopicIds[] vai identificar todos os temas associados a um vídeo.

• Como o Freebase já foi descontinuado, o guia Pesquisa com tópicos do Freebase foi removido da documentação. Esse guia forneceu exemplos de código para mostrar como um aplicativo funcionaria com a API Freebase.

  Além disso, vários exemplos de código relacionados a IDs de tópicos foram removidos da documentação do método search.list.

2 de novembro de 2016

Esta atualização contém as seguintes alterações:

• Novas propriedades e parâmetros

  • O recurso video contém várias novas propriedades:

    • A propriedade player.embedHtml contém uma tag <iframe> que pode ser usada para incorporar um player que reproduz o vídeo. As novas propriedades player.embedHeight e player.embedWidth identificam as dimensões do player incorporado. Essas propriedades só são retornadas se a solicitação de API especificar um valor para pelo menos um dos parâmetros maxHeight ou maxWidth. Esses dois novos parâmetros são explicados mais adiante nesta entrada do histórico de revisões.

    • A nova propriedade hasCustomThumbnail indica se o usuário que fez o envio do vídeo forneceu uma imagem de miniatura personalizada. Essa propriedade só fica visível para o usuário que fez o envio do vídeo.

    • O novo fpbRatingReasons[] identifica os motivos pelos quais o vídeo recebeu a classificação FPB (África do Sul).

    • O novo mcstRating identifica a classificação que o vídeo recebeu no Vietnã.

  • O método videos.list oferece suporte a dois novos parâmetros, maxHeight e maxWidth. É possível usar um ou ambos os parâmetros ao recuperar a parte player nos recursos video.

    Por padrão, a altura do <iframe> retornado na propriedade player.embedHtml é de 360 px. A largura é ajustada para corresponder à proporção do vídeo, garantindo que o player incorporado não tenha barras pretas em volta do vídeo. Por exemplo, se a proporção de um vídeo for 16:9, a largura do player será de 640 pixels.

    Com os novos parâmetros, é possível especificar que, em vez das dimensões padrão, o código de incorporação deve usar uma altura e/ou largura adequadas para o layout do aplicativo. O servidor da API dimensiona as dimensões do player de acordo com o necessário para garantir que o player incorporado não tenha barras pretas em volta do vídeo. Ambos os parâmetros especificam as dimensões máximas do player incorporado. Portanto, se ambos os parâmetros forem especificados, uma dimensão ainda poderá ser menor que o valor máximo permitido para ela.

    Por exemplo, suponha que um vídeo tenha uma proporção de 16:9. Assim, a tag player.embedHtml conteria um player de 640 x 360 se o parâmetro maxHeight ou maxWidth não estiver definido.

    • Se o parâmetro maxHeight for definido como 720 e o parâmetro maxWidth não for definido, a API vai retornar um player de 1280x720.
    • Se o parâmetro maxWidth for definido como 960 e o parâmetro maxHeight não for definido, a API vai retornar um player de 960x540.
    • Se o parâmetro maxWidth for definido como 960 e o parâmetro maxHeight for definido como 450, a API vai retornar um player de 800x450.

    As novas propriedades player.embedHeight e player.embedWidth, descritas acima, identificam as dimensões do player.

• Atualizações de métodos, propriedades e parâmetros existentes

  • A descrição do recurso channelSection foi atualizada para informar que um canal pode criar no máximo 10 prateleiras sem definir dados de segmentação e um máximo de 100 prateleiras com dados de segmentação.

    Além disso, a propriedade targeting do recurso channelSection foi atualizada para refletir o fato de que as opções de segmentação só podem ser definidas usando a API. As opções de segmentação são excluídas se a seção do canal for modificada usando a interface do usuário no site do YouTube.

  • A definição da propriedade snippet.name do recurso i18nLanguage foi corrigida para refletir que o valor representa o nome de um idioma, conforme escrito no idioma especificado pelo parâmetro hl do método i18nLanguage.list.

  • A propriedade contentDetails.note do recurso playlistItem foi atualizada para informar que o comprimento máximo do valor da propriedade é de 280 caracteres.

  • As propriedades contentDetails.startAt e contentDetails.endAt do recurso playlistItem foram descontinuadas. Esses campos são ignorados se forem definidos em solicitações playlistItems.insert ou playlistItems.update.

  • Os métodos playlistItems.delete e playlistItems.update agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos. As solicitações que usam esse método também precisam ser autorizadas com um token que ofereça acesso ao escopo https://www.googleapis.com/auth/youtubepartner.

  • Os parâmetros publishedBefore e publishedAfter do método search.list foram atualizados para indicar que os valores do parâmetro são inclusivos. Por exemplo, se o parâmetro publishedBefore estiver definido, a API vai retornar os recursos criados antes ou no horário especificado.

  • A propriedade contentDetails.contentRating.grfilmRating do recurso video aceita três valores adicionais: grfilmK12, grfilmK15 e grfilmK18.

  • A descrição do método videos.insert foi atualizada para informar que o tamanho máximo do arquivo de vídeos enviados aumentou de 64 GB para 128 GB.

• Erros novos e atualizados

  • A API oferece suporte aos seguintes novos erros:

    Tipo de erro	Detalhe do erro	Descrição
    forbidden (403)	homeParameterDeprecated	O método activities.list retorna esse erro para indicar que os dados de atividade da página inicial do usuário não estão disponíveis nessa API. Esse erro pode ocorrer se você definir o parâmetro home como true em uma solicitação não autorizada.
    invalidValue (400)	invalidContentDetails	O método playlistItems.insert retorna esse erro para indicar que o objeto contentDetails na solicitação é inválido. Uma das razões para esse erro é que o campo contentDetails.note tem mais de 280 caracteres.
    forbidden (403)	watchHistoryNotAccessible	O método playlistItems.list retorna esse erro para indicar que a solicitação tentou recuperar itens da playlist "Histórico de exibição", mas eles não podem ser recuperados usando a API.
    forbidden (403)	watchLaterNotAccessible	O método playlistItems.list retorna esse erro para indicar que a solicitação tentou recuperar itens da playlist "Assistir mais tarde", mas eles não podem ser recuperados usando a API.
    badRequest (400)	uploadLimitExceeded	O método videos.insert retorna esse erro para indicar que o canal excedeu o número de vídeos que pode enviar.
    forbidden (403)	forbiddenEmbedSetting	O método videos.update retorna esse erro para indicar que a solicitação da API tenta definir uma configuração de incorporação inválida para o vídeo. Alguns canais não têm permissão para oferecer players incorporados para transmissões ao vivo. Confira mais informações na Central de Ajuda do YouTube.

  • O método playlistItems.insert não retorna mais um erro se você inserir um vídeo duplicado em uma playlist. Esse erro ocorria em algumas playlists, como vídeos favoritos, que não permitiam duplicações, mas não são mais compatíveis. Em geral, as playlists permitem vídeos duplicados.

• Outras atualizações

  • A entrada do histórico de revisões de 15 de setembro de 2016 foi atualizada para esclarecer que, sempre que as propriedades contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel forem incluídas em uma resposta, elas sempre vão conter os valores HL e WL, respectivamente. Além disso, essas propriedades só são incluídas se um usuário autorizado estiver recuperando dados sobre o próprio canal.

15 de setembro de 2016

Esta atualização contém as seguintes alterações:

• A atualização do histórico de revisões de 11 de agosto de 2016 discutiu várias mudanças relacionadas aos IDs de tópicos, incluindo o fato de que o conjunto de IDs de tópicos com suporte vai mudar a partir de 10 de fevereiro de 2017. A lista de tópicos com suporte será publicada até 10 de novembro de 2016.

• As seguintes mudanças estão em vigor. Essas mudanças foram notificadas na atualização do histórico de revisões em 11 de agosto de 2016:

  • Se o método activities.list for chamado com o parâmetro home definido como true, a resposta da API vai conter itens semelhantes aos que um usuário do YouTube desconectado veria na página inicial.

    Essa é uma pequena mudança que tem como objetivo oferecer uma experiência do usuário melhor do que o comportamento descrito na atualização do histórico de revisões em 11 de agosto de 2016. Essa atualização indicava que as solicitações que usavam o parâmetro home retornariam uma lista vazia.

  • As propriedades contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel agora contêm valores de HL e WL, respectivamente, para todos os canais.

    Para deixar claro, essas propriedades só ficam visíveis para um usuário autorizado que extrai dados sobre o próprio canal. As propriedades sempre contêm os valores HL e WL, mesmo para um usuário autorizado que extrai dados sobre o próprio canal. Portanto, os IDs do histórico de exibição e da playlist "Assistir mais tarde" não podem ser recuperados pela API.

    Além disso, as solicitações para recuperar detalhes (playlists.list) ou itens (playlistItems.list) de uma playlist do histórico de exibição ou da playlist "Assistir mais tarde" de um canal agora retornam listas vazias. Esse comportamento é válido para os novos valores, HL e WL, bem como para qualquer histórico de exibição ou ID de playlist "Assistir mais tarde" que o cliente da API já tenha armazenado.

• O objeto fileDetails.recordingLocation do recurso video e as propriedades filhas dele não são mais retornados. Antes, esses dados (como o objeto fileDetails pai) só podiam ser recuperados pelo proprietário de um vídeo.

11 de agosto de 2016

Esta atualização contém as seguintes alterações:

• Os Termos de Serviço dos serviços de API do YouTube recém-publicados ("os Termos atualizados"), discutidos em detalhes no blog de engenharia e desenvolvedores do YouTube, oferecem um conjunto de atualizações dos Termos de Serviço atuais. Além dos termos atualizados, que vão entrar em vigor em 10 de fevereiro de 2017, essa atualização inclui vários documentos de apoio para explicar as políticas que os desenvolvedores precisam seguir.

  O conjunto completo de novos documentos está descrito no histórico de revisões dos Termos atualizados. Além disso, as mudanças futuras nos Termos Atualizados ou nos documentos de apoio também serão explicadas nesse histórico de revisões. Você pode se inscrever em um feed RSS que lista as mudanças no histórico de revisões usando um link no documento.

• A descontinuação do Freebase e da API Freebase está causando várias mudanças relacionadas aos IDs de tópicos. Os IDs de tópico são usados nos seguintes recursos e métodos de API:

  • A parte topicDetails do recurso channel identifica os tópicos associados ao canal.
  • A parte topicDetails do recurso video identifica os temas associados ao vídeo.
  • O parâmetro topicId do método search.list permite pesquisar vídeos ou canais relacionados a um determinado tema.

  As mudanças nesses recursos são:

  • A partir de 10 de fevereiro de 2017, o YouTube vai começar a retornar um pequeno conjunto de IDs de tópico em vez do conjunto muito mais granular de IDs retornados até agora. Esse conjunto de tópicos compatíveis vai identificar categorizações de alto nível, como Esportes ou Basquete, mas não vai identificar equipes ou jogadores específicos. Vamos anunciar o conjunto de temas compatíveis para que você tenha tempo de preparar seu aplicativo para essa mudança.

  • Os IDs de tópicos do Freebase que você já extraiu podem ser usados para pesquisar conteúdo até 10 de fevereiro de 2017. No entanto, após esse período, você só poderá usar o conjunto menor de tópicos identificados no item anterior para recuperar os resultados da pesquisa por tópico.

  • Depois de 10 de fevereiro de 2017, se você tentar pesquisar resultados usando um ID de tópico que não está no conjunto menor de IDs de tópico com suporte, a API vai retornar um conjunto de resultados vazio.

• Vários campos e parâmetros de API foram descontinuados em 12 de setembro de 2016:

  • O parâmetro home do método activities.list permitiu que um usuário autorizado extraísse o feed de atividades que seria exibido na página inicial do YouTube para esse usuário. As solicitações que usam esse parâmetro após 12 de setembro de 2016 vão retornar uma lista vazia.

  • As propriedades contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel só ficam visíveis para um usuário autorizado que extrai dados sobre o próprio canal. Depois de 12 de setembro de 2016, o contentDetails.relatedPlaylists.watchHistory vai retornar um valor de HL, e a propriedade contentDetails.relatedPlaylists.watchLater vai retornar um valor de WL para todos os canais.

    As solicitações para recuperar detalhes de playlist (playlists.list) do histórico de exibição ou da playlist "Assistir mais tarde" de um canal vão retornar uma lista vazia após 12 de setembro de 2016. As solicitações para recuperar itens de playlist (playlistItems.list) em qualquer uma dessas playlists também vão retornar uma lista vazia após esse período. Isso vale para os novos valores, HL e WL, bem como para todos os IDs de histórico de exibição ou playlist "Assistir mais tarde" que o cliente da API já armazenou.

  • O objeto fileDetails.recordingLocation do recurso video ou qualquer uma das propriedades filhas dele não será mais retornado após 12 de setembro de 2016. Esses dados só podem ser recuperados pelo proprietário de um vídeo, já que o objeto fileDetails pai só pode ser recuperado por um proprietário de vídeo.

13 de junho de 2016

Esta atualização contém as seguintes alterações:

• A propriedade contentDetails.googlePlusUserId do recurso channel foi descontinuada. Antes, a propriedade só aparecia se o canal estivesse associado a um perfil do Google+. Após a descontinuação, a propriedade não será mais incluída em nenhum recurso channel.

• A propriedade snippet.authorGoogleplusProfileUrl do recurso comment foi descontinuada. Antes, a propriedade só aparecia se o canal estivesse associado a um perfil do Google+. Após a descontinuação, a propriedade não será mais incluída em nenhum recurso comment.

Como nenhuma dessas propriedades será retornada após a descontinuação, elas foram removidas da documentação de recursos correspondente.

31 de maio de 2016

Esta atualização contém as seguintes alterações:

• O novo parâmetro myRecentSubscribers do método subscriptions.list recupera uma lista dos inscritos do canal do usuário autenticado na ordem cronológica inversa do momento em que eles se inscreveram no canal.

  O novo parâmetro só aceita a recuperação dos mil inscritos mais recentes do canal do usuário autenticado. Para recuperar uma lista completa de assinantes, use o parâmetro mySubscribers. Esse parâmetro, que não retorna assinantes em uma ordem específica, não limita o número de assinantes que podem ser recuperados.

• A definição da propriedade snippet.thumbnails.(key) foi atualizada para os recursos activity, playlistItem, playlist, search result, thumbnail e video para informar que outros tamanhos de imagem em miniatura estão disponíveis para alguns vídeos.

  • A imagem standard tem 640 px de largura e 480 px de altura.
  • A imagem maxres tem 1.280 pixels de largura e 720 pixels de altura.

• A definição do parâmetro part do método channelSection.list foi atualizada para informar que a parte targeting pode ser recuperada a um custo de 2 unidades de cota.

• O método videos.list agora retorna um erro proibido (403) quando uma solicitação autorizada incorretamente tenta recuperar as partes fileDetails, processingDetails ou suggestions de um recurso video. Essas partes só estão disponíveis para o proprietário do vídeo.

17 de maio de 2016

A nova ferramenta Snippets de código da API Data oferece snippets de código curtos para casos de uso comuns da API Data do YouTube. No momento, os snippets de código estão disponíveis para todos os métodos de API somente leitura no Apps Script, Go, JavaScript, PHP, Python e Ruby.

Para cada método, a ferramenta mostra exemplos de código para um ou mais casos de uso. Por exemplo, ele fornece cinco snippets de código para o método search.list:

• Listar vídeos por palavra-chave
• Listar vídeos por local
• Listar eventos ao vivo
• Pesquisar os vídeos do usuário autenticado
• Listar vídeos relacionados

Para cada caso de uso, a ferramenta mostra os parâmetros usados na solicitação da API. Você pode modificar os valores dos parâmetros. Nesse caso, a ferramenta atualiza os snippets de código para refletir os valores de parâmetro fornecidos.

Por fim, a ferramenta mostra a resposta da API para cada solicitação. Se você tiver modificado os parâmetros da solicitação, a resposta da API vai ser baseada nos valores de parâmetro fornecidos. Você precisa autorizar a ferramenta a enviar solicitações em seu nome para que as respostas da API sejam mostradas.

28 de abril de 2016

Esta atualização contém as seguintes alterações:

• A nova propriedade contentDetails.projection do recurso video especifica o formato de projeção do vídeo. Os valores de propriedade válidos são 360 e rectangular.

• As propriedades recordingDetails.location e fileDetails.recordingLocation do recurso video foram atualizadas para explicar a diferença entre as duas:

  • A propriedade recordingDetails.location identifica o local que o proprietário do vídeo quer associar ao conteúdo. Esse local pode ser editado, pesquisado em vídeos públicos e pode ser exibido para os usuários.
  • O valor da propriedade fileDetails.recordingLocation é imutável e representa o local associado ao arquivo de vídeo original enviado. O valor só é visível para o proprietário do vídeo.

• A definição da propriedade contentDetails.relatedPlaylists.favorites do recurso channel foi atualizada para indicar que o valor da propriedade pode conter um ID de playlist que se refere a uma playlist vazia e não pode ser buscado. Isso ocorre porque a funcionalidade de vídeos favoritos foi descontinuada. Essa propriedade não está sujeita à política de descontinuação da API.

• A definição do erro ineligibleAccount, que pode ser retornado pelo método comments.insert, comments.update, commentThreads.insert ou commentThreads.update, foi atualizada para refletir que o erro ocorre quando a conta do YouTube usada para autorizar a solicitação da API não foi mesclada à conta do Google do usuário.

20 de abril de 2016

Esta atualização contém as seguintes alterações:

• A definição do parâmetro part do método channels.update foi atualizada para indicar que localizations também é um valor válido para esse parâmetro.

• A seção Uso da cota do guia "Comece agora" foi atualizada para incluir um link para o Play Console, onde você pode conferir sua cota e o uso dela.

16 de março de 2016

Esta atualização contém as seguintes alterações:

• Atualizações de recursos e métodos atuais

  • A documentação do recurso channelBanner foi atualizada para informar que o tamanho recomendado para a imagem do banner do canal enviada é de 2.560 x 1.440 pixels. O tamanho mínimo (2.048 x 1.152 pixels) não mudou.

  • A nova propriedade snippet.customUrl do recurso channel identifica o URL personalizado associado ao canal. Nem todos os canais têm URLs personalizados. A Central de Ajuda do YouTube explica os requisitos de qualificação para receber um URL personalizado e como configurar o URL.

  • O objeto brandingSettings.watch do recurso channel e todas as propriedades filhas dele foram descontinuados.

  • A resposta da API a uma solicitação search.list agora contém uma propriedade regionCode. A propriedade identifica o código da região usada para a consulta de pesquisa. O código da região instrui a API a retornar os resultados da pesquisa para o país especificado.

    O valor da propriedade é um código ISO de país de duas letras que identifica a região. O método i18nRegions.list retorna uma lista de regiões compatíveis. O valor padrão é US. Se uma região sem suporte for especificada, o YouTube ainda poderá selecionar outra região, em vez do valor padrão, para processar a consulta.

  • As definições das propriedades snippet.label e snippet.secondaryReasons[].label do recurso videoAbuseReportReason foram atualizadas para indicar que as propriedades contêm texto de rótulo localizado para os motivos do relatório de abuso.

    Além disso, o método videoAbuseReportReasons.list agora oferece suporte ao parâmetro hl, que especifica o idioma que deve ser usado para o texto do rótulo na resposta da API. O valor padrão do parâmetro é en_US.

  • A nova propriedade contentDetails.contentRating.ecbmctRating do recurso video identifica a classificação de um vídeo do Conselho de Avaliação e Classificação do Ministério da Cultura e Turismo da Turquia.

    Além disso, as propriedades de API para outros sistemas de classificação oferecem suporte aos seguintes novos valores de propriedade:

    • contentDetails.contentRating.fpbRating (África do Sul)
      Nota: 10; valor da propriedade: fpb10
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificação: R-12; valor da propriedade: moctwR12
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificação: R-15; valor da propriedade: moctwR15

  • A propriedade liveStreamingDetails.activeLiveChatId do recurso video contém o ID do chat ao vivo ativo associado ao vídeo. O valor da propriedade só aparece se o vídeo for uma transmissão ao vivo atual com o chat ativado. Depois que a transmissão e o chat ao vivo terminam, a propriedade não é mais retornada para o vídeo.

  • A propriedade status.rejectionReason do recurso video é compatível com o novo valor de propriedade legal.

• A API oferece suporte aos seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	notEditable	Os métodos channelSections.insert, channelSections.update e channelSections.delete retornam esse erro para indicar que a seção de canal especificada não pode ser criada, atualizada ou excluída.
  badRequest (400)	styleRequired	Os métodos channelSections.insert e channelSections.update retornam esse erro para indicar que o recurso channelSection enviado na solicitação da API precisa especificar um valor para a propriedade snippet.style.
  badRequest (400)	typeRequired	Os métodos channelSections.insert e channelSections.update retornam esse erro para indicar que o recurso channelSection enviado na solicitação da API precisa especificar um valor para a propriedade snippet.type.
  badRequest (400)	processingFailure	O método commentThreads.list retorna esse erro para indicar que o servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele seja válido.
  forbidden (403)	commentsDisabled	O método commentThreads.list retorna esse erro para indicar que o vídeo identificado pelo parâmetro videoId desativou os comentários.
  badRequest (400)	commentTextTooLong	O método commentThreads.insert retorna esse erro para indicar que o recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	O método playlistItems.insert retorna esse erro para indicar que o vídeo que você está tentando adicionar à playlist já está em outra playlist em série. Acesse a Central de Ajuda do YouTube para mais informações sobre as playlists de séries.
  badRequest (400)	subscriptionForbidden	O método subscriptions.insert retorna esse erro para indicar que você atingiu o número máximo de assinaturas ou criou muitas assinaturas recentes. Nesse último caso, tente novamente a solicitação após algumas horas.
  badRequest (400)	invalidCategoryId	O método videos.update retorna esse erro para indicar que a propriedade snippet.categoryId no recurso video enviado por upload especificou um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias compatíveis.
  badRequest (400)	invalidDescription	O método videos.update retorna esse erro para indicar que a propriedade snippet.description no recurso video enviado por upload especificou um valor inválido.
  badRequest (400)	invalidPublishAt	O método videos.update retorna esse erro para indicar que a propriedade status.publishAt no recurso video enviado por upload especificou um horário de publicação programado inválido.
  badRequest (400)	invalidRecordingDetails	O método videos.update retorna esse erro para indicar que o objeto recordingDetails no recurso video enviado por upload especificou detalhes de gravação inválidos.
  badRequest (400)	invalidTags	O método videos.update retorna esse erro para indicar que a propriedade snippet.tags no recurso video enviado por upload especificou um valor inválido.
  badRequest (400)	invalidTitle	O método videos.update retorna esse erro para indicar que a propriedade snippet.title no recurso video enviado especifica um título de vídeo inválido ou vazio.
  badRequest (400)	invalidVideoMetadata	O método videos.update retorna esse erro para indicar que os metadados da solicitação são inválidos. Esse erro ocorre se a solicitação atualizar a parte snippet de um recurso video, mas não definir um valor para as propriedades snippet.title e snippet.categoryId.

18 de dezembro de 2015

As leis da União Europeia (UE) exigem que determinadas divulgações sejam feitas e consentimentos sejam obtidos dos usuários finais na UE. Portanto, para usuários finais na União Europeia, você precisa obedecer à Política de consentimento para usuários da União Europeia. Adicionamos um aviso sobre esse requisito nos Termos de Serviço da API do YouTube.

19 de novembro de 2015

Agora, a API oferece suporte à capacidade de definir e extrair texto localizado para as propriedades snippet.title e snippet.description dos recursos playlist e video, a propriedade snippet.title do recurso channelSection e a propriedade snippet.description do recurso channel.

• Como definir títulos e descrições localizados

  É possível definir valores localizados para um recurso ao chamar o método insert ou update para esse recurso. Para definir valores localizados para um recurso, faça o seguinte:

  • Verifique se um valor foi definido para a propriedade snippet.defaultLanguage do recurso. Essa propriedade identifica o idioma das propriedades snippet.title e snippet.description do recurso. O valor pode ser qualquer linguagem de aplicativo com suporte ou a maioria dos outros códigos de idioma ISO 639-1:2002. Por exemplo, se você enviar um vídeo com título e descrição em inglês, defina a propriedade snippet.defaultLanguage como en.

    Observação para atualizar recursos channel:para definir a propriedade snippet.defaultLanguage de um recurso channel, é necessário atualizar a propriedade brandingSettings.channel.defaultLanguage.

  • Adicione o objeto localizations ao recurso que você está atualizando. Cada chave de objeto é uma string que identifica um idioma de aplicativo ou um código de idioma ISO 639-1:2002, e cada chave é mapeada para um objeto que contém o título (e a descrição) localizado do recurso.

    O snippet de exemplo abaixo define o idioma padrão do recurso como inglês. Ele também adiciona títulos e descrições em alemão e espanhol localizados a um vídeo:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Importante:ao atualizar os dados localizados de um recurso, a solicitação da API precisa incluir todas as versões localizadas dos dados. Por exemplo, se você enviou uma solicitação posterior para adicionar dados em português ao vídeo no exemplo acima, a solicitação precisa incluir os dados localizados em alemão, espanhol e português.

• Como recuperar valores localizados

  A API oferece duas maneiras de extrair valores localizados de um recurso:

  • Adicione o parâmetro hl à sua solicitação channels.list, channelSections.list, playlists.list ou videos.list para extrair dados localizados de uma língua de aplicativo específica com suporte do site do YouTube. Se os detalhes do recurso localizado estiverem disponíveis nesse idioma, o objeto snippet.localized do recurso vai conter os valores localizados. No entanto, se os detalhes localizados não estiverem disponíveis, o objeto snippet.localized vai conter detalhes do recurso no idioma padrão dele.

    Por exemplo, suponha que uma solicitação videos.list tenha recuperado dados do vídeo descrito acima com dados localizados em alemão e espanhol. Se o parâmetro hl fosse definido como de, o recurso teria os seguintes dados:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    No entanto, se o parâmetro hl for definido como fr, o objeto snippet.localized vai conter o título e a descrição em inglês, porque esse é o idioma padrão do recurso, e os detalhes em francês não estão disponíveis.

    Importante:o parâmetro hl só aceita valores que identificam idiomas de aplicativos compatíveis com o site do YouTube. Para determinar se o texto localizado está disponível para outros idiomas, você precisa recuperar a parte localizations do recurso e filtrar para determinar se o texto localizado existe.
    
    Por exemplo, você precisa recuperar a lista completa de localizações para determinar se o texto localizado está disponível em inglês dos Apalaches.
    
    

  • Ao recuperar um recurso, inclua localizations no valor do parâmetro part para recuperar todos os detalhes localizados desse recurso. Se você estiver extraindo dados localizados para um idioma que não é um idioma de aplicativo atual do YouTube, use essa abordagem para extrair todas as localizações e filtrar para determinar se os dados localizados desejados existem.

• Erros relacionados a valores de texto localizados

  A API também oferece suporte aos seguintes novos erros para valores de texto localizados:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	defaultLanguageNotSetError	Esse erro indica que uma solicitação que tenta inserir ou atualizar o objeto localizations de um recurso está falhando porque a propriedade snippet.defaultLanguage não está definida para esse recurso. Os métodos channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert e videos.update são compatíveis com esse erro.
  badRequest (400)	localizationValidationError	Esse erro indica que não foi possível validar um dos valores no objeto localizations de um recurso. Por exemplo, esse erro pode ocorrer se o objeto tiver um código de idioma inválido. Os métodos channels.update, channelSections.insert, channelSections.update, playlists.insert e playlists.update oferecem suporte a esse erro.

4 de novembro de 2015

Esta atualização contém as seguintes alterações:

• Atualizações de recursos e métodos atuais

  • O parâmetro order do método search.list foi atualizado para informar que, se você classificar as transmissões ao vivo por viewCount, os resultados da API serão classificados pelo número de espectadores simultâneos enquanto as transmissões ainda estiverem em andamento.

  • O parâmetro relatedToVideoId do método search.list foi atualizado para informar que, se o parâmetro for definido, os únicos outros parâmetros compatíveis serão part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (que precisa ser definido como video) e fields. Essa atualização não reflete uma mudança no comportamento da API.

  • A definição da propriedade snippet.publishedAt do recurso video foi atualizada para informar que o valor da propriedade, que especifica a data e a hora em que o vídeo foi publicado, pode ser diferente do horário em que o vídeo foi enviado. Por exemplo, se um vídeo for enviado como privado e depois for tornado público, o valor da propriedade vai especificar o momento em que o vídeo foi tornado público. A definição atualizada também explica como o valor é preenchido para vídeos privados e não listados.

    Essa mudança não reflete uma mudança no comportamento da API.

  • A definição da propriedade status.publishAt do recurso video foi atualizada para informar:

    • Se você definir o valor dessa propriedade ao chamar o método videos.update, também precisará definir o valor da propriedade status.privacyStatus como private, mesmo que o vídeo já esteja privado.
    • Se a solicitação programar a publicação de um vídeo para algum momento no passado, ele será publicado imediatamente. Assim, o efeito de definir a propriedade status.publishAt para uma data e hora anteriores é o mesmo que mudar o privacyStatus do vídeo de private para public.

  • A propriedade contentDetails.contentRating.cncRating do recurso video especifica a classificação do vídeo da Commission de classification cinématographique da França. Essa propriedade substitui a propriedade contentDetails.contentRating.fmocRating, que foi descontinuada.

  • A definição de brandingSettings.channel.keywords do recurso channel foi atualizada para refletir corretamente que o valor da propriedade contém uma lista de strings separada por espaços, e não uma lista separada por vírgulas, como documentado anteriormente. Essa atualização não reflete uma mudança no comportamento da API.

  • A documentação do método thumbnails.set foi atualizada para refletir com precisão que o corpo da solicitação contém a imagem de miniatura que você está enviando e associando a um vídeo. O corpo da solicitação não contém um recurso thumbnail. Antes, a documentação dizia que você não deveria fornecer um corpo de solicitação ao chamar esse método. Essa atualização não reflete uma mudança no comportamento da API.

  • A descrição do recurso activity foi atualizada para refletir o fato de que o método activities.list não inclui recursos relacionados a novos comentários de vídeo. O snippet.type e o contentDetails.comment do recurso também foram atualizados.

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Detalhes do erro
    activities.insert	Código de resposta HTTP badRequest (400) Motivo invalidMetadata Descrição A propriedade kind não corresponde ao tipo de ID fornecido.
    commentThreads.update comments.insert comments.update	Código de resposta HTTP badRequest (400) Motivo commentTextTooLong Descrição O recurso comment que está sendo inserido ou atualizado contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Código de resposta HTTP forbidden (403) Motivo playlistItemsNotAccessible Descrição A solicitação não está autorizada corretamente para inserir, atualizar ou excluir o item de playlist especificado.
    playlists.delete playlists.insert playlists.update	Código de resposta HTTP badRequest (400) Motivo playlistForbidden Descrição Essa operação é proibida ou a solicitação não está autorizada corretamente.
    search.list	Código de resposta HTTP badRequest (400) Motivo invalidLocation Descrição O valor do parâmetro location e/ou locationRadius foi formatado incorretamente.
    search.list	Código de resposta HTTP badRequest (400) Motivo invalidRelevanceLanguage Descrição O valor do parâmetro relevanceLanguage foi formatado incorretamente.
    subscriptions.insert	Código de resposta HTTP badRequest (400) Motivo subscriptionForbidden Descrição Esse erro ocorre quando uma das seguintes condições é verdadeira: A assinatura que você está tentando criar já existe Você já atingiu o número máximo de assinaturas Você está tentando se inscrever no seu próprio canal, o que não é possível. Você criou muitas assinaturas recentemente e precisa aguardar algumas horas antes de tentar novamente.
    videos.update	Código de resposta HTTP badRequest (400) Motivo invalidDefaultBroadcastPrivacySetting Descrição A solicitação tenta definir uma configuração de privacidade inválida para a transmissão padrão.

28 de agosto de 2015

Esta atualização contém as seguintes alterações:

• Atualizações de recursos e métodos atuais

  • A propriedade statistics.favoriteCount do recurso video foi descontinuada.

    De acordo com nossa política de descontinuação, essa propriedade vai continuar sendo incluída nos recursos video por pelo menos um ano após este anúncio. No entanto, o valor da propriedade agora é sempre definido como 0.

7 de agosto de 2015

Esta atualização contém as seguintes alterações:

• Atualizações de recursos e métodos atuais

  • A definição da propriedade snippet.tags[] do recurso video foi atualizada para fornecer mais informações sobre como o servidor da API calcula o comprimento do valor da propriedade. Essa atualização não reflete uma mudança no comportamento da API.

    Especificamente, a definição agora explica que, se uma tag contém um espaço, o servidor da API processa o valor da tag como se estivesse entre aspas e as aspas contam para o limite de caracteres. Portanto, para fins de limite de caracteres, a tag Foo-Baz tem sete caracteres, mas a tag Foo Baz tem nove.

  • O método commentThreads.insert não oferece mais suporte ao parâmetro shareOnGooglePlus, que indicava se um comentário e as respostas a ele também precisavam ser postados no perfil do Google+ do autor. Se uma solicitação enviar o parâmetro, o servidor da API vai ignorá-lo, mas processará a solicitação.

18 de junho de 2015

Esta atualização contém as seguintes alterações:

• Atualizações de recursos e métodos atuais

  • O novo parâmetro order do método commentThreads.list especifica a ordem em que a resposta da API deve listar as linhas de comentários. As linhas de execução podem ser ordenadas por tempo ou relevância. O comportamento padrão é ordenar por tempo.

  • A nova propriedade snippet.defaultAudioLanguage do recurso video especifica o idioma falado na faixa de áudio padrão do vídeo.

  • A definição da propriedade contentDetails.licensedContent do recurso video foi atualizada para esclarecer que o conteúdo precisa ter sido enviado originalmente para um canal vinculado a um parceiro de conteúdo do YouTube e reivindicado por esse parceiro. Isso não representa uma mudança no comportamento real da API.

  • Os métodos captions.delete, captions.download, captions.insert, captions.list e captions.update agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos. As solicitações que usam esse método também precisam ser autorizadas com um token que ofereça acesso ao escopo https://www.googleapis.com/auth/youtubepartner.

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Detalhes do erro
    videos.rate	Código de resposta HTTP badRequest (400) Motivo emailNotVerified Descrição O usuário precisa verificar o endereço de e-mail antes de classificar o vídeo.
    videos.rate	Código de resposta HTTP badRequest (400) Motivo videoPurchaseRequired Descrição Os vídeos de aluguel só podem ser avaliados pelos usuários que os alugaram.

  • Os métodos subscriptions.delete e subscriptions.insert não oferecem mais suporte aos erros accountClosed e accountSuspended.

27 de abril de 2015

Esta atualização contém as seguintes alterações:

• Novos recursos e métodos

  • O novo recurso videoAbuseReportReason contém informações sobre o motivo pelo qual um vídeo foi sinalizado por conter conteúdo abusivo. O método videoAbuseReportReasons.list permite recuperar uma lista de todos os motivos pelos quais os vídeos podem ser sinalizados.

  • O novo método videos.reportAbuse oferece uma maneira de sinalizar um vídeo que contenha conteúdo abusivo. O corpo da solicitação contém um objeto JSON que especifica o vídeo sinalizado e o motivo pelo qual ele foi considerado abusivo. É possível receber motivos válidos do método videoAbuseReportReason.list descrito acima.

    O guia de migração também foi atualizado com um exemplo de como denunciar um vídeo abusivo. Com essa mudança, a API v3 agora oferece suporte a todos os recursos da API v2 que estão programados para oferecer suporte. Esses recursos também são explicados no guia de migração.

• Atualizações de recursos e métodos atuais

  • O novo parâmetro de filtro forDeveloper do método search.list restringe uma pesquisa para recuperar apenas vídeos enviados pelo aplicativo ou site do desenvolvedor. O parâmetro forDeveloper pode ser usado com parâmetros de pesquisa opcionais, como q.

    Para esse recurso, cada vídeo enviado é marcado automaticamente com o número de projeto associado ao aplicativo do desenvolvedor no Console do Desenvolvedor do Google.

    Quando uma solicitação de pesquisa define o parâmetro forDeveloper como true, o servidor da API usa as credenciais de autorização da solicitação para identificar o desenvolvedor. Portanto, um desenvolvedor pode restringir os resultados a vídeos enviados pelo próprio app ou site, mas não a vídeos enviados por outros apps ou sites.

    O novo recurso oferece uma funcionalidade semelhante, embora não idêntica, às tags de desenvolvedor com suporte da API v2.

  • A nova propriedade snippet.country do recurso channel permite que os proprietários associem os canais a um país específico.

    Observação:para definir a propriedade snippet.country de um recurso channel, é necessário atualizar a propriedade brandingSettings.channel.country.

  • A API agora oferece suporte ao direcionamento para recursos channelSection. A segmentação por seção de canal é uma forma de restringir a visibilidade de uma seção de conteúdo para usuários que correspondem a critérios específicos.

    A API expõe três opções de segmentação. O usuário precisa atender a todas as configurações de segmentação para que uma seção do canal fique visível.

    • targeting.languages[]: uma lista de línguas de programação do YouTube. Os usuários que escolheram um desses idiomas podem acessar a seção correspondente do canal.

    • targeting.regions[]: uma lista de regiões de conteúdo preferencial do YouTube. A seção do canal fica visível para os usuários que selecionaram uma dessas regiões e para aqueles que têm uma delas selecionada automaticamente.

    • targeting.countries[]: uma lista de países em que a seção do canal está visível. Cada valor na lista é um código de país ISO 3166-1 alfa-2.

  • A definição da propriedade contentDetails.duration do recurso video foi corrigida para refletir que o valor pode refletir horas, dias e assim por diante.

  • A documentação dos métodos channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete e videos.delete foi corrigida para refletir que, quando bem-sucedidos, todos esses métodos retornam um código de resposta HTTP 204 (No Content).

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Tipo de erro	Detalhe do erro	Descrição
    badRequest (400)	targetInvalidCountry	Os métodos channelSections.insert e channelSections.update vão retornar esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Os métodos channelSections.insert e channelSections.update vão retornar esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.languages[].
    badRequest (400)	targetInvalidRegion	Os métodos channelSections.insert e channelSections.update retornam esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.regions[].
    badRequest (400)	operationNotSupported	O método comments.insert retorna esse erro se o usuário da API não conseguir inserir um comentário em resposta ao comentário de nível superior identificado pela propriedade snippet.parentId. Em um recurso commentThread, a propriedade snippet.canReply indica se o espectador atual pode responder à conversa.
    badRequest (400)	invalidChannelId	O método search.list vai retornar esse erro se o parâmetro channelId na solicitação especificar um ID de canal inválido.
    badRequest (400)	subscriptionForbidden	O método subscriptions.insert retorna esse erro se o usuário da API tentar se inscrever no próprio canal.

  • O método captions.update não oferece mais suporte aos erros invalidMetadata e videoNotFound.

16 de abril de 2015

Esta atualização contém as seguintes alterações:

• O guia de migração foi atualizado para explicar como migrar aplicativos que ainda usam a funcionalidade de comentários da API v2.

  O guia também destaca vários recursos de comentários que a API v2 não tinha, mas que são compatíveis com a API v3. São eles:

  • Como recuperar comentários sobre um canal
  • Recuperar todas as conversas relacionadas a um canal, o que significa que a resposta da API pode conter comentários sobre o canal ou qualquer um dos vídeos.
  • Como atualizar o texto de um comentário
  • Marcar um comentário como spam
  • Como definir o status de moderação de um comentário

• O guia Como se inscrever para receber notificações push foi atualizado para refletir o fato de que as notificações são enviadas apenas para o hub do Google PubSubHubBub, e não para o hub do Superfeedr, como indicado anteriormente.

9 de abril de 2015

Esta atualização contém as seguintes alterações:

• Os novos recursos commentThread e comment da API permitem que você recupere, insira, atualize, exclua e modere comentários.

  • Um recurso commentThread contém informações sobre uma conversa de comentários do YouTube, que compreende um comentário de nível superior e as respostas, se houver, a esse comentário. Um recurso commentThread pode representar comentários sobre um vídeo ou um canal.

    O comentário de nível superior e as respostas são recursos comment aninhados dentro do recurso commentThread. É importante observar que o recurso commentThread não contém necessariamente todas as respostas a um comentário. Você precisa usar o método comments.list se quiser recuperar todas as respostas de um comentário específico. Além disso, alguns comentários não têm respostas.

    A API oferece suporte aos seguintes métodos para recursos commentThread:

    • commentThreads.list: extrai uma lista de conversas de comentários. Use esse método para recuperar comentários associados a um vídeo ou canal específico.
    • commentThreads.insert: cria um novo comentário de nível superior. Use o método comments.insert para responder a um comentário.
    • commentThreads.update: modifica um comentário de nível superior.

  • Um recurso comment contém informações sobre um único comentário do YouTube. Um recurso comment pode representar um comentário sobre um vídeo ou canal. Além disso, o comentário pode ser de nível superior ou uma resposta a um comentário de nível superior.

    A API oferece suporte aos seguintes métodos para recursos comment:

    • comments.list: recupera uma lista de comentários. Use esse método para recuperar todas as respostas a um comentário específico.
    • comments.insert: criar uma resposta a um comentário.
    • comments.update: modifica um comentário.
    • comments.markAsSpam: sinalizar um ou mais comentários como spam.
    • comments.setModerationStatus: define o status de moderação de um ou mais comentários. Por exemplo, limpar um comentário para exibição pública ou rejeitar um comentário como inadequado para exibição. A solicitação da API precisa ser autorizada pelo proprietário do canal ou do vídeo associado aos comentários.
    • comments.delete: excluir um comentário.

  O novo escopo https://www.googleapis.com/auth/youtube.force-ssl da API, descrito no histórico de revisões de 2 de abril de 2015, é necessário para chamadas aos métodos comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert e commentThreads.update.

• O novo guia Como assinar notificações push explica o novo suporte da API para notificações push pelo PubSubHubBub, um protocolo de publicação/assinatura de servidor para servidor para recursos acessíveis pela Web. Seu servidor de callback do PubSubHubBub pode receber notificações do feed Atom quando um canal realiza uma das seguintes atividades:

  • envia um vídeo
  • atualiza o título de um vídeo
  • atualiza a descrição de um vídeo

• O guia de migração também foi atualizado para incluir o novo suporte a notificações push. No entanto, como a API v2 oferece suporte a vários outros tipos de notificações push que não são compatíveis com a API v3, a menção do suporte ao PubSubHubBub ainda está listada na seção Descontinuado desse guia.

• O novo escopo https://www.googleapis.com/auth/youtube.force-ssl da API agora é um escopo válido para qualquer método de API que antes aceitava o escopo https://www.googleapis.com/auth/youtube.

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	invalidRating	O método videos.rate vai retornar esse erro se a solicitação contiver um valor inesperado para o parâmetro rating.

• O método subscriptions.insert não oferece mais suporte ao erro subscriptionLimitExceeded, que indicava que o assinante identificado com a solicitação havia excedido o limite de taxa de assinatura.

2 de abril de 2015

Esta atualização contém as seguintes alterações:

• O novo recurso captions representa uma faixa de legenda do YouTube. Uma faixa de legenda é associada a exatamente um vídeo do YouTube.

  A API oferece suporte a métodos para listar, inserir, atualizar, fazer o download e excluir faixas de legenda.

• O guia de migração também foi atualizado para explicar como migrar aplicativos que ainda usam a funcionalidade de legendas na API v2.

• O novo escopo https://www.googleapis.com/auth/youtube.force-ssl da API exige que a comunicação com o servidor da API ocorra por uma conexão SSL.

  Esse novo escopo concede o mesmo acesso do escopo https://www.googleapis.com/auth/youtube. Na verdade, esses dois escopos são funcionalmente idênticos porque o servidor da API do YouTube só está disponível por um endpoint HTTPS. Como resultado, embora o escopo https://www.googleapis.com/auth/youtube não exija uma conexão SSL, não há outra maneira de fazer uma solicitação de API.

  O novo escopo é necessário para chamadas a todos os métodos do recurso caption.

11 de março de 2015

Esta atualização contém as seguintes alterações:

• O guia de migração da API YouTube Data v3 contém uma nova guia, chamada Novidades na API v3, que lista os recursos compatíveis com a v3 e que não eram compatíveis com a v2. Os mesmos recursos já estavam listados em outras guias do guia. Por exemplo, o novo recurso que explica como atualizar os dados da campanha promocional em vídeo de um canal também está listado na guia Canais (perfis).

• O guia de migração da API YouTube Data v3 foi atualizado para informar que a API v3 vai oferecer suporte ao seguinte recurso da API v2:

  • Como sinalizar um vídeo

• O guia de migração da API Data (v3) do YouTube foi atualizado para informar que os seguintes recursos da API v2 não serão compatíveis com a v3:

  • Recuperar recomendações de vídeo: a API v3 não recupera uma lista que contém apenas vídeos recomendados para o usuário atual da API. No entanto, é possível usar a API v3 para encontrar vídeos recomendados chamando o método activities.list e definindo o valor do parâmetro home como true.

    Na resposta da API, um recurso corresponde a um vídeo recomendado se o valor da propriedade snippet.type for recommendation. Nesse caso, as propriedades contentDetails.recommendation.reason e contentDetails.recommendation.seedResourceId vão conter informações sobre por que o vídeo foi recomendado. Não há garantia de que a resposta vai conter um número específico de vídeos recomendados.

  • Recuperar sugestões de canais

  • Recuperar novos vídeos de inscrição: a API v3 não recupera uma lista que contém apenas vídeos enviados recentemente para canais em que o usuário da API está inscrito. No entanto, você pode usar a API v3 para encontrar novos vídeos de inscrição chamando o método activities.list e definindo o valor do parâmetro home como true.

    Na resposta da API, um recurso corresponde a um novo vídeo de assinatura se o valor da propriedade snippet.type for upload. Não há garantia de que a resposta vai conter um número específico de novos vídeos de inscrição.

  • Suporte a feeds RSS

  • Notificações push para atualizações de feed: a API v2 oferece suporte a notificações push usando o Simple Update Protocol (SUP) ou o PubSubHubbub para monitorar feeds de atividade do usuário no YouTube. As notificações eram enviadas quando alguém se inscrevia em um canal e quando os vídeos eram avaliados, compartilhados, marcados como favoritos, comentados ou enviados.

    A API v3 vai oferecer suporte a notificações push usando o protocolo PubSubHubbub, mas as notificações vão abranger apenas uploads de vídeo e atualizações de títulos ou descrições de vídeo.

  • Localização do canal: a API v2 usava a tag <yt:location> para identificar o local do usuário conforme inserido no perfil público do canal no YouTube. Embora alguns desenvolvedores tenham usado esse campo para associar um canal a um país específico, os dados do campo não podiam ser usados de forma consistente para essa finalidade.

  • Definir ou recuperar tags de desenvolvedor: a API v2 oferecia suporte à capacidade de associar palavras-chave ou tags de desenvolvedor a um vídeo no momento do upload. As tags de desenvolvedor não seriam mostradas para os usuários do YouTube, mas os proprietários de conteúdo poderiam recuperar vídeos que correspondem a uma tag específica.

    A API v3 vai oferecer um recurso semelhante, mas não idêntico. Especificamente, um desenvolvedor poderá pesquisar vídeos enviados pelo próprio aplicativo. Para esse recurso, cada vídeo enviado é marcado automaticamente com o número de projeto associado ao aplicativo do desenvolvedor no Console do Desenvolvedor do Google. O desenvolvedor usa o mesmo número de projeto para pesquisar vídeos.

  • Listar vídeos por data de publicação, contagem de visualizações ou classificação: na API v2, o parâmetro orderby permite classificar vídeos em uma playlist por posição, duração, data de publicação, título e vários outros valores. Na API v3, os itens de playlist geralmente são classificados por posição em ordem crescente, e outras opções de classificação não estão disponíveis.

    Existem algumas exceções. Um novo envio, vídeo favorito, vídeo curtido ou vídeo assistido recentemente é adicionado automaticamente como o primeiro item (snippet.position=0) para os seguintes tipos de playlist. Portanto, cada uma dessas listas é classificada em ordem do item mais recente ao mais antigo com base nos horários em que os itens foram adicionados à lista.

    • uploads do usuário
    • vídeos favoritos
    • vídeos marcados como "Gostei"
    • histórico de visualização

    No entanto, um novo item adicionado à playlist "Assistir mais tarde" é adicionado como o último item dessa lista, então ela é classificada do mais antigo para o mais recente.

  • Processamento em lote: a API v3 oferece suporte a um dos casos de uso de processamento em lote da API v2. Os métodos channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list e videos.list da API v3 oferecem suporte a um parâmetro id, que pode ser usado para especificar uma lista de IDs delimitada por vírgulas (IDs de vídeo, IDs de canal etc.). Com esses métodos, é possível recuperar uma lista de vários recursos com uma única solicitação.

  Com essas mudanças, o guia agora identifica todas as funcionalidades que eram compatíveis com a API antiga (v2) e que serão descontinuadas na versão atual (v3).

4 de março de 2015

Esta atualização contém as seguintes alterações:

• Os métodos channelSections.delete e channelSections.update agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos.

• As seguintes propriedades e propriedades filhas foram descontinuadas:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Observação:nenhuma dessas propriedades estava sujeita à política de descontinuação da API.

• A nova propriedade contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons do recurso video identifica os motivos que explicam por que o vídeo recebeu a classificação do DJCQT (Brasil).

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  notFound (404)	channelNotFound	O método channels.update retorna esse erro se o parâmetro id da solicitação especificar um canal que não pode ser encontrado.
  badRequest (400)	manualSortRequiredinvalidValue	Os métodos playlistItems.insert e playlistItems.update retornam esse erro se a solicitação tentar definir a posição do item da playlist, mas a playlist não usar a classificação manual. Por exemplo, os itens da playlist podem ser classificados por data ou popularidade. Para resolver esse erro, remova o elemento snippet.position do recurso enviado no corpo da solicitação. Se você quiser que o item da playlist tenha uma posição específica na lista, primeiro atualize a configuração de ordenação da playlist para Manual. Essa configuração pode ser ajustada no Gerenciador de vídeos do YouTube.
  forbidden (403)	channelClosed	O método playlists.list retorna esse erro se o parâmetro channelId da solicitação especificar um canal que foi fechado.
  forbidden (403)	channelSuspended	O método playlists.list vai retornar esse erro se o parâmetro channelId da solicitação especificar um canal suspenso.
  forbidden (403)	playlistForbidden	O método playlists.list vai retornar esse erro se o parâmetro id da solicitação não for compatível com ela ou não for autorizado corretamente.
  notFound (404)	channelNotFound	O método playlists.list retorna esse erro se o parâmetro channelId da solicitação especificar um canal que não pode ser encontrado.
  notFound (404)	playlistNotFound	O método playlists.list retorna esse erro se o parâmetro id da solicitação especificar uma playlist que não pode ser encontrada.
  notFound (404)	videoNotFound	O método videos.list vai retornar esse erro se o parâmetro id da solicitação especificar um vídeo que não pode ser encontrado.
  badRequest (400)	invalidRating	O método videos.rate retorna esse erro se a solicitação contiver um valor inesperado para o parâmetro rating.

2 de março de 2015

Esta atualização contém as seguintes alterações:

• O método search.list agora oferece suporte ao parâmetro relevanceLanguage, que permite solicitar os resultados mais relevantes para um idioma específico.

  O guia de migração da API YouTube Data (v3) também foi atualizado para explicar como usar esse novo parâmetro. O parâmetro aborda uma lacuna de recursos que existia entre a versão atual da API (v3) e a versão anterior (v2), que já foi descontinuada.

• O guia de migração da API Data do YouTube (v3) também foi atualizado para indicar a descontinuação dos campos de metadados e feeds especiais que a API v2 oferecia para descrever filmes, trailers, programas de TV, temporadas de TV e episódios de TV.

14 de janeiro de 2015

Esta atualização contém as seguintes alterações:

• O guia de migração da API YouTube Data (v3) foi atualizado para explicar como usar a API v3 para enviar vídeos usando JavaScript. Consulte a seção Enviar um vídeo para mais detalhes. Essa funcionalidade é semelhante ao envio de arquivos pelo navegador, que é aceito pela API v2. Essa mudança no guia de migração não reflete uma mudança real na API, mas sim a disponibilidade de um novo código de exemplo para fazer upload de vídeos com JavaScript do lado do cliente.

  Como há suporte para fazer upload de vídeos com a biblioteca de cliente JavaScript e o CORS, o guia de migração não lista mais o upload baseado em navegador como um recurso que pode ser descontinuado na API v3.

• A documentação do método videos.insert foi atualizada para incluir o novo exemplo de código JavaScript descrito acima. A lista de exemplos de código JavaScript para a API YouTube Data (v3) também foi atualizada.

11 de novembro de 2014

Esta atualização contém as seguintes alterações:

• O custo da cota para uma chamada ao método search.list foi alterado para 100 unidades.

  Importante:em muitos casos, é possível usar outros métodos de API para recuperar informações com um custo de cota menor. Por exemplo, considere estas duas maneiras de encontrar vídeos enviados para o canal GoogleDevelopers.

  • Custo da cota: 100 unidades

    Chame o método search.list e procure GoogleDevelopers.

  • Custo da cota: 6 unidades

    Chame o método channels.list para encontrar o ID correto do canal. Defina o parâmetro forUsername como GoogleDevelopers e o parâmetro part como contentDetails. Na resposta da API, a propriedade contentDetails.relatedPlaylists.uploads especifica o ID da playlist dos vídeos enviados do canal.

    Em seguida, chame o método playlistItems.list e defina o parâmetro playlistId como o ID capturado e o parâmetro part como snippet.

8 de outubro de 2014

Esta atualização contém as seguintes alterações:

• O recurso channel contém duas novas propriedades:

  • A propriedade status.longUploadsStatus indica se o canal está qualificado para enviar vídeos com mais de 15 minutos. Essa propriedade só é retornada se o proprietário do canal autorizou a solicitação da API. Os valores de propriedade válidos são:

    • allowed: o canal pode enviar vídeos com mais de 15 minutos.
    • eligible: o canal pode enviar vídeos com mais de 15 minutos, mas precisa ativar o recurso primeiro.
    • disallowed: o canal não pode enviar vídeos com mais de 15 minutos.

    Consulte a definição da propriedade para mais informações sobre esses valores. A Central de Ajuda do YouTube também tem informações mais detalhadas sobre esse recurso.

  • A propriedade invideoPromotion.useSmartTiming indica se a campanha promocional do canal usa o "cronômetro inteligente". Esse recurso tenta mostrar promoções em um ponto do vídeo em que elas têm mais chances de receber cliques e menos chances de atrapalhar a experiência de visualização. Esse recurso também seleciona uma única promoção para exibir em cada vídeo.

• As definições das propriedades snippet.title e snippet.categoryId do recurso video foram atualizadas para esclarecer a forma como a API processa chamadas para o método videos.update. Se você chamar esse método para atualizar a parte snippet de um recurso video, vai precisar definir um valor para as duas propriedades.

  Se você tentar atualizar a parte snippet de um recurso video e não definir um valor para as duas propriedades, a API vai retornar um erro invalidRequest. A descrição desse erro também foi atualizada.

• A propriedade contentDetails.contentRating.oflcRating do recurso video, que identifica a classificação de um vídeo do Escritório de Classificação de Filmes e Literatura da Nova Zelândia, agora oferece suporte a duas novas classificações: oflcRp13 e oflcRp16. Eles correspondem às classificações RP13 e RP16, respectivamente.

• O método channelBanners.insert agora oferece suporte ao seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	bannerAlbumFull	O álbum de arte do canal do YouTube do proprietário tem muitas imagens. O proprietário do canal deve acessar http://photos.google.com, navegar até a página de álbuns e remover algumas imagens desse álbum.

12 de setembro de 2014

Esta atualização contém as seguintes alterações:

• O custo da cota para uma chamada ao método search.list mudou de 1 para 2 unidades, além do custo das partes de recursos especificadas.

13 de agosto de 2014

Esta atualização contém as seguintes alterações:

• O método subscriptions.insert agora oferece suporte ao seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	subscriptionLimitExceeded	O assinante identificado com a solicitação excedeu o limite de taxa de assinatura. É possível tentar fazer mais assinaturas em algumas horas.

12 de agosto de 2014

Esta atualização contém as seguintes alterações:

• Um novo guia, intitulado Como migrar seu aplicativo para a API YouTube Data (v3), explica como usar a API YouTube Data (v3) para executar a funcionalidade disponível na API YouTube Data (v2). A API mais antiga foi oficialmente descontinuada em 4 de março de 2014. O objetivo do guia é ajudar você a migrar os aplicativos que ainda usam a API v2 para a versão mais recente.

8 de julho de 2014

Esta atualização contém as seguintes alterações:

• O método playlists.insert agora oferece suporte ao seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	maxPlaylistExceeded	Esse erro ocorre quando não é possível criar uma playlist porque o canal já tem o número máximo permitido.

18 de junho de 2014

Esta atualização contém as seguintes alterações:

• A descrição de cada método de API foi atualizada para incluir o custo de cota incorrido por uma chamada para esse método. Da mesma forma, as definições dos parâmetros part foram atualizadas para especificar o custo da cota de cada parte que pode ser recuperada em uma chamada de API. Por exemplo, uma chamada para o método subscriptions.insert tem um custo de cota de aproximadamente 50 unidades. O recurso subscription também contém três partes (snippet, contentDetails e subscriberSnippet), e cada uma delas tem um custo de duas unidades.

  Os custos de cota podem mudar sem aviso prévio.

• O recurso video agora oferece suporte a 43 novos sistemas de classificação de conteúdo, que identificam as classificações recebidas por vídeos de várias agências nacionais. Os novos sistemas de classificação aceitos são os da Argentina, Áustria, Bélgica, Bulgária, Chile (televisão), Chile (filme), República Tcheca, Colômbia, Dinamarca, Egito, Estônia, Finlândia, França, Grécia, Hong Kong, Islândia, Indonésia, Irlanda, Israel, Itália, Quênia, Letônia, Luxemburgo, Malásia, Maldivas, Malta, Holanda, Nigéria, Noruega, Peru, Filipinas, Portugal, Romênia, Singapura, Eslováquia, África do Sul, Suécia, Suíça, Taiwan, Tailândia e Venezuela.

28 de maio de 2014

Esta atualização contém as seguintes alterações:

• O método search.list agora oferece suporte aos parâmetros location e locationRadius, que permitem pesquisar vídeos associados a um local geográfico. Uma solicitação precisa especificar um valor para ambos os parâmetros para recuperar resultados com base na localização. A API vai retornar um erro se uma solicitação incluir apenas um dos dois parâmetros.

  • O parâmetro location especifica as coordenadas de latitude/longitude no centro da área geográfica circular.

  • O parâmetro locationRadius especifica a distância máxima que o local associado a um vídeo pode estar do centro da área para que o vídeo ainda seja incluído nos resultados da pesquisa.

13 de maio de 2014

Esta atualização contém as seguintes alterações:

• A propriedade invideoPromotion.items[] do recurso channel foi atualizada para informar que normalmente é possível definir apenas um item promovido para seu canal. Se você tentar inserir muitos itens promovidos, a API vai retornar um erro tooManyPromotedItems, que tem um código de status HTTP 400.

• O recurso channelSection agora pode conter informações sobre alguns novos tipos de conteúdo em destaque. A propriedade snippet.type do recurso channelSection agora aceita os seguintes valores:

  • postedPlaylists: playlists que o proprietário do canal postou no feed de atividades
  • postedVideos: vídeos que o proprietário do canal postou no feed de atividades
  • subscriptions: canais em que o proprietário do canal está inscrito

• A nova propriedade contentDetails.contentRating.ifcoRating do recurso video identifica a classificação que um vídeo recebeu do Escritório de Classificação de Filmes da Irlanda.

• A definição da propriedade position.cornerPosition do recurso watermark foi atualizada para informar que a marca d'água sempre aparece no canto superior direito do player.

• A definição do parâmetro q para o método search.list foi atualizada para informar que o termo da consulta pode usar o operador booleano NÂO (-) para excluir vídeos associados a um termo de pesquisa específico. O valor também pode usar o operador booleano OR (|) para encontrar vídeos associados a um dos vários termos de pesquisa.

• A definição da propriedade pageInfo.totalResults retornada em uma resposta da API para uma chamada search.list foi atualizada para indicar que o valor é uma aproximação e pode não representar um valor exato. Além disso, o valor máximo é 1.000.000. Você não deve usar esse valor para criar links de paginação. Em vez disso, use os valores das propriedades nextPageToken e prevPageToken para determinar se os links de paginação serão mostrados.

• Os métodos watermarks.set e watermarks.unset foram atualizados para refletir que a API retorna um código de resposta HTTP 204 para solicitações bem-sucedidas a esses métodos.

2 de maio de 2014

Esta atualização contém as seguintes alterações:

• O novo recurso i18nLanguage identifica um idioma de aplicativo compatível com o site do YouTube. A linguagem do aplicativo também pode ser chamada de linguagem da interface. No site do YouTube, um idioma de aplicativo podia ser selecionado automaticamente com base nas configurações da Conta do Google, no idioma do navegador ou no local do IP. Além disso, o usuário também podia selecionar manualmente o idioma da interface desejado no rodapé do site do YouTube.

  A API oferece suporte a um método para listar os idiomas de aplicativos compatíveis. Os idiomas com suporte podem ser usados como o valor do parâmetro hl ao chamar métodos de API como videoCategories.list e guideCategories.list.

• O novo recurso i18nRegion identifica uma área geográfica que um usuário do YouTube pode selecionar como a região de conteúdo preferida. A região de conteúdo também pode ser chamada de localidade de conteúdo. No site do YouTube, uma região de conteúdo pode ser selecionada automaticamente com base em heurísticas, como o domínio do YouTube ou o local do IP do usuário. O usuário também pode selecionar manualmente a região de conteúdo desejada no rodapé do site do YouTube.

  A API oferece suporte a um método para listar as regiões de conteúdo compatíveis. Os códigos de região com suporte podem ser usados como o valor do parâmetro regionCode ao chamar métodos de API como search.list, videos.list, activities.list e videoCategories.list.

7 de abril de 2014

Esta atualização contém as seguintes alterações:

• O novo recurso channelSection contém informações sobre um conjunto de vídeos que um canal escolheu para destacar. Por exemplo, uma seção pode mostrar os envios mais recentes ou mais populares de um canal, ou vídeos de uma ou mais playlists.

  A API oferece suporte a métodos para listar, inserir, atualizar ou excluir seções de canal. É possível recuperar uma lista de seções do canal do usuário autenticado especificando um ID de canal específico ou uma lista de IDs de seção de canal exclusivos.

  A documentação de erros também foi atualizada para descrever as mensagens de erro que a API aceita especificamente para esses novos métodos.

• A definição do objeto fileDetails do recurso video foi atualizada para explicar que esse objeto só será retornado se a propriedade processingDetails.fileDetailsAvailability do vídeo tiver um valor de available.

  Da mesma forma, a definição do objeto suggestions do recurso video foi atualizada para explicar que esse objeto só será retornado se a propriedade processingDetails.tagSuggestionsAvailability do vídeo ou a propriedade processingDetails.editorSuggestionsAvailability tiver um valor de available.

• A documentação dos métodos videos.insert e videos.update foi atualizada para refletir que a propriedade status.publishAt pode ser definida ao chamar esses métodos.

• A definição do objeto invideoPromotion do recurso channel foi atualizada para explicar que o objeto só pode ser recuperado pelo proprietário do canal.

• A lista de parâmetros do método videos.rate foi atualizada para refletir que esse método não oferece suporte ao parâmetro onBehalfOfContentOwner. Isso foi um erro de documentação, porque as solicitações videos.rate que definem esse parâmetro retornam um erro 500.

31 de março de 2014

Esta atualização contém as seguintes alterações:

• A nova propriedade status.publishAt do recurso video permite especificar a data e a hora em que um vídeo privado será publicado. Essa propriedade só pode ser definida se o status de privacidade do vídeo for private e ele nunca tiver sido publicado. Essa nova propriedade não está sujeita à política de descontinuação.

13 de março de 2014

Esta atualização contém as seguintes alterações:

• A API agora oferece suporte à parte contentOwnerDetails para recursos channel. A nova parte contém dados relevantes para os parceiros do YouTube vinculados ao canal, incluindo o ID do proprietário do conteúdo vinculado ao canal e a data e a hora em que o proprietário do conteúdo e o canal foram vinculados. Essa nova parte não está sujeita à política de descontinuação.

• A documentação agora lista o comprimento máximo de caracteres aceito para as seguintes propriedades:

  Recurso	Propriedade	Tamanho máximo
  channel	invideoPromotion.items[].customMessage	40 caracteres
  video	snippet.title	100 caracteres
  video	snippet.description	5.000 bytes
  video	snippet.tags	500 caracteres. O valor da propriedade é uma lista, e as vírgulas entre os itens da lista contam para o limite.

• A propriedade brandingSettings.watch.featuredPlaylistId do recurso channel foi descontinuada. A API vai retornar um erro se você tentar definir o valor dela.

• As propriedades de recurso video a seguir foram adicionadas à lista de valores que podem ser definidos ao inserir ou atualizar um vídeo:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• A documentação de erros agora especifica o código de resposta HTTP para cada tipo de erro.

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	invalidCriteria	O método channels.list retorna esse erro se a solicitação especificar parâmetros de filtro que não podem ser usados em conjunto.
  badRequest (400)	channelTitleUpdateForbidden	O método channels.update vai retornar esse erro se você tentar atualizar a parte brandingSettings de um canal e mudar o valor da propriedade brandingSettings.channel.title. A API não vai retornar o erro se você omitir a propriedade.
  badRequest (400)	invalidRecentlyUploadedBy	O método channels.update vai retornar esse erro se a propriedade invideoPromotion.items[].id.recentlyUploadedBy especificar um ID de canal inválido.
  badRequest (400)	invalidTimingOffset	O método channels.update vai retornar esse erro se a parte invideoPromotion especificar um deslocamento de tempo inválido.
  badRequest (400)	tooManyPromotedItems	O método channels.update vai retornar esse erro se a parte invideoPromotion especificar mais do que o número permitido de itens promovidos.
  forbidden (403)	promotedVideoNotAllowed	O método channels.update vai retornar esse erro se a propriedade invideoPromotion.items[].id.videoId especificar um ID de vídeo que não pode ser encontrado ou usado como um item promovido.
  forbidden (403)	websiteLinkNotAllowed	O método channels.update vai retornar esse erro se a propriedade invideoPromotion.items[].id.websiteUrl especificar um URL que não é permitido.
  required (400)	requiredTimingType	O método channels.update retorna esse erro se uma solicitação não especificar as configurações de tempo padrão para quando o YouTube deve mostrar um item promovido.
  required (400)	requiredTiming	O método channels.update precisa especificar um objeto invideoPromotion.items[].timing para cada item promovido.
  required (400)	requiredWebsiteUrl	O método channels.update precisa especificar uma propriedade invideoPromotion.items[].id.websiteUrl para cada item promovido.
  badRequest (400)	invalidPublishAt	O método videos.insert vai retornar esse erro se os metadados da solicitação especificarem um horário de publicação programado inválido.

4 de março de 2014

Esta atualização contém as seguintes alterações:

• A API YouTube Data v3 agora está sujeita à política de descontinuação descrita nos Termos de Serviço das APIs do YouTube. A página que lista as APIs sujeitas à política de descontinuação exclui especificamente algumas funcionalidades da API v3.

5 de dezembro de 2013

Esta atualização contém as seguintes alterações:

• A documentação do método search.list foi atualizada para refletir corretamente que você não precisa especificar um valor para exatamente um parâmetro de filtro ao enviar uma solicitação de pesquisa. Em vez disso, defina um valor para zero parâmetros de filtro ou para um parâmetro de filtro.

• As definições dos parâmetros do método search.list foram atualizadas para informar que você precisa definir o valor do parâmetro type como video se também especificar um valor para qualquer um dos seguintes parâmetros:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• O tamanho mínimo das imagens do banner do canal enviadas foi reduzido para 2.048 x 1.152 pixels. Antes, o tamanho mínimo era de 2.120 x 1.192 pixels. Além disso, a documentação do recurso channel especifica os tamanhos máximos de todas as imagens de banner veiculadas pela API. Por exemplo, o tamanho máximo da imagem brandingSettings.image.bannerTvImageUrl para aplicativos de TV é 2.120 x 1.192 pixels, mas a imagem real pode ter 2.048 x 1.152 pixels. A Central de Ajuda do YouTube oferece mais orientações para otimizar a arte do canal para exibição em diferentes tipos de dispositivos.

• Várias definições de propriedade de recurso channel foram atualizadas para refletir as seguintes informações:

  • O valor da propriedade brandingSettings.channel.description tem um comprimento máximo de 1.000 caracteres.
  • A propriedade brandingSettings.channel.featuredChannelsTitle tem um comprimento máximo de 30 caracteres.
  • A propriedade brandingSettings.channel.featuredChannelsUrls[] agora pode listar até 100 canais.
  • O valor da propriedade brandingSettings.channel.unsubscribedTrailer, se definido, precisa especificar o ID do vídeo do YouTube de um vídeo público ou não listado que pertence ao proprietário do canal.

• O método channels.update agora oferece suporte a atualizações na propriedade invideoPromotion.items[].promotedByContentOwner. Essa propriedade indica se o nome do proprietário do conteúdo vai ser mostrado ao exibir a promoção. Ele só pode ser definido se a solicitação da API que define o valor da propriedade estiver sendo feita em nome do proprietário do conteúdo usando o parâmetro onBehalfOfContentOwner.

• Os métodos playlistItems.list e playlistItems.insert agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos.

• A propriedade contentDetails.contentRating.acbRating agora pode especificar uma classificação do Australian Classification Board (ACB, na sigla em inglês) para filmes ou da Australian Communications and Media Authority (ACMA, na sigla em inglês) para programas de TV infantis.

• As novas propriedades contentDetails.contentRating.catvRating e contentDetails.contentRating.catvfrRating identificam as classificações que um vídeo recebeu no sistema canadense de classificação de TV e no sistema de classificação Régie du cinéma, usado em Quebec, respectivamente.

• A nova propriedade snippet.assignable do recurso videoCategory indica se vídeos atualizados ou recém-enviados podem ser associados a essa categoria.

• Foram adicionados exemplos de código para os seguintes métodos:

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (Go)
  • thumbnails.set (Java)
  • videos.insert (Go)

24 de outubro de 2013

Esta atualização contém as seguintes alterações:

• A API inclui dois recursos adicionais projetados para ajudar a encontrar e exibir conteúdo de transmissão ao vivo:

  A nova propriedade snippet.liveBroadcastContent nos resultados da pesquisa indica se um recurso de vídeo ou canal tem conteúdo de transmissão ao vivo. Os valores de propriedade válidos são upcoming, active e none.

  • A nova propriedade snippet.liveBroadcastContent do recurso video indica se o vídeo é uma transmissão ao vivo ativa ou futura. A lista abaixo explica os valores possíveis da propriedade:

    • upcoming: o vídeo é uma transmissão ao vivo que ainda não começou.
    • active: o vídeo é uma transmissão ao vivo em andamento.
    • none: o vídeo não é uma transmissão ao vivo ativa ou futura. Esse será o valor da propriedade para transmissões concluídas que ainda podem ser visualizadas no YouTube.

  • A nova propriedade liveStreamingDetails do recurso video é um objeto que contém metadados sobre uma transmissão de vídeo ao vivo. Para recuperar esses metadados, inclua liveStreamingDetails na lista de partes de recursos do valor do parâmetro part. Os metadados incluem as seguintes novas propriedades:

    • liveStreamingDetails.actualStartTime: a hora em que a transmissão realmente começou. Esse valor vai estar presente quando o estado da transmissão for active.
    • liveStreamingDetails.actualEndTime: o horário em que a transmissão realmente terminou. Esse valor vai estar presente quando a transmissão terminar.
    • liveStreamingDetails.scheduledStartTime: o horário em que a transmissão está programada para começar.
    • liveStreamingDetails.scheduledEndTime: a hora em que a transmissão está programada para terminar. Se o valor da propriedade estiver vazio ou a propriedade não estiver presente, a transmissão será programada para continuar indefinidamente.
    • liveStreamingDetails.concurrentViewers: o número de pessoas assistindo a transmissão ao vivo.

    Para extrair esses metadados, inclua liveStreamingDetails no valor do parâmetro part ao chamar o método videos.list, videos.insert ou videos.update.

  Dois outros recursos para identificar conteúdo de transmissão ao vivo foram lançados em 1º de outubro de 2013: o parâmetro eventType do método search.list e a propriedade snippet.liveBroadcastContent do resultado da pesquisa.

• O método videos.insert agora oferece suporte ao parâmetro notifySubscribers, que indica se o YouTube precisa enviar uma notificação sobre o novo vídeo para os usuários inscritos no canal do vídeo. O valor padrão do parâmetro é True, que indica que os inscritos vão receber uma notificação sobre os vídeos recém-enviados. No entanto, um proprietário de canal que está enviando muitos vídeos pode preferir definir o valor como False para evitar enviar uma notificação sobre cada novo vídeo aos inscritos do canal.

• A lista de propriedades que podem ser modificadas ao chamar o método channels.update foi atualizada para incluir as propriedades invideoPromotion.items[].customMessage e invideoPromotion.items[].websiteUrl. Além disso, a lista foi modificada para identificar as propriedades brandingSettings que podem ser modificadas. Essas propriedades brandingSettings já eram modificáveis, então a mudança na documentação não reflete uma mudança na funcionalidade atual da API.

• Os métodos playlists.insert, playlists.update e playlists.delete agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é compatível com vários outros métodos.

• O método playlists.insert agora oferece suporte ao parâmetro onBehalfOfContentOwnerChannel, que já é aceito em vários outros métodos.

• A propriedade contentDetails.contentRating.tvpgRating do recurso video agora aceita o valor pg14, que corresponde a uma classificação TV-14.

• A definição da propriedade snippet.liveBroadcastContent, que faz parte dos resultados da pesquisa, foi corrigida para refletir que live é um valor de propriedade válido, mas active não é.

• A propriedade contentDetails.contentRating.mibacRating do recurso video agora oferece suporte a duas classificações adicionais:

  • mibacVap (VAP): as crianças precisam estar acompanhadas de um adulto.
  • mibacVm6 (V.M.6) – Restrito a maiores de 6 anos.
  • mibacVm12 (V.M.12) – Restrito a maiores de 12 anos.

• A nova propriedade invideoPromotion.items[].promotedByContentOwner do recurso channel indica se o nome do proprietário do conteúdo vai ser mostrado ao exibir a promoção. Esse campo só pode ser definido se a solicitação de API que define o valor estiver sendo feita em nome do proprietário do conteúdo. Consulte o parâmetro onBehalfOfContentOwner para mais informações.

1º de outubro de 2013

Esta atualização contém as seguintes alterações:

• O novo objeto auditDetails do recurso channel contém dados de canal que uma rede multicanal (RM) avaliaria ao determinar se aceita ou rejeita um canal específico. Qualquer solicitação de API que extraia essa parte do recurso precisa fornecer um token de autorização que contenha o escopo https://www.googleapis.com/auth/youtubepartner-channel-audit. Além disso, qualquer token que use esse escopo precisa ser revogado quando a MCN decidir aceitar ou rejeitar o canal ou em até duas semanas após a emissão do token.

• A propriedade invideoPromotion.items[].id.type do recurso channel agora aceita o valor recentUpload, que indica que o item promovido é o vídeo mais recente enviado de um canal específico.

  Por padrão, o canal é o mesmo para o qual os dados da promoção no vídeo estão definidos. No entanto, você pode promover o vídeo mais recente de outro canal definindo o valor da nova propriedade invideoPromotion.items[].id.recentlyUploadedBy como o ID do canal.

• O recurso channel contém três novas propriedades: brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl e brandingSettings.image.bannerTvHighImageUrl, que especificam os URLs das imagens de banner exibidas nas páginas do canal nos aplicativos de TV.

• A nova propriedade snippet.liveBroadcastContent nos resultados da pesquisa indica se um recurso de vídeo ou canal tem conteúdo de transmissão ao vivo. Os valores de propriedade válidos são upcoming, active e none.

  • Para um recurso video, um valor de upcoming indica que o vídeo é uma transmissão ao vivo que ainda não começou, enquanto um valor de active indica que o vídeo é uma transmissão ao vivo em andamento.
  • Para um recurso channel, um valor de upcoming indica que o canal tem uma transmissão programada que ainda não começou, enquanto um valor de acive indica que o canal tem uma transmissão ao vivo em andamento.

• No recurso watermark, a propriedade targetChannelId mudou de um objeto para uma string. Em vez de conter uma propriedade secundária que especifica o ID do canal do YouTube vinculado à imagem da marca d'água, a propriedade targetChannelId agora especifica esse valor. Por isso, a propriedade targetChannelId.value do recurso foi removida.

• O método thumbnails.set agora oferece suporte ao parâmetro onBehalfOfContentOwner, que já é aceito em vários outros métodos.

• O método search.list agora é compatível com o parâmetro eventType, que restringe uma pesquisa para retornar apenas eventos de transmissão ativos, futuros ou concluídos.

• A nova propriedade contentDetails.contentRating.mibacRating identifica a classificação que um vídeo recebeu do Ministério da Cultura e Turismo da Itália.

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidImage	O método thumbnails.set vai retornar esse erro se o conteúdo da imagem fornecido for inválido.
  forbidden	videoRatingDisabled	O método videos.rate vai retornar esse erro se o proprietário do vídeo que está sendo avaliado tiver desativado as classificações para esse vídeo.

27 de agosto de 2013

Esta atualização contém as seguintes alterações:

• O novo recurso watermark identifica uma imagem que aparece durante a reprodução dos vídeos de um canal específico. Você também pode especificar um canal de destino ao qual a imagem será vinculada, além dos detalhes de sincronismo que determinam quando uma marca d'água aparece durante reproduções de vídeo e o período em que ela estará visível.

  O método watermarks.set faz upload e define a imagem da marca-d'água de um canal. O método watermarks.unset exclui a imagem de marca-d'água de um canal.

  A documentação de erros descreve as mensagens de erro que a API aceita especificamente para os métodos watermarks.set e watermarks.unset.

• A nova propriedade statistics.hiddenSubscriberCount do recurso channel contém um valor booleano que indica se o número de inscritos do canal está oculto. Nesse caso, o valor da propriedade é false se a contagem de inscritos do canal estiver visível publicamente.

• O método playlists.list agora oferece suporte aos parâmetros onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Ambos os parâmetros já são aceitos em vários outros métodos.

• O método videos.list agora oferece suporte ao parâmetro regionCode, que identifica a região de conteúdo para a qual um gráfico precisa ser recuperado. Esse parâmetro só pode ser usado com o parâmetro chart. O valor do parâmetro é um código de país ISO 3166-1 Alfa 2.

• O error documentation descreve o seguinte novo erro de solicitação comum, que pode ocorrer em vários métodos de API:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	insufficientPermissions	Os escopos associados ao token OAuth 2.0 fornecido para a solicitação não são suficientes para acessar os dados solicitados.

15 de agosto de 2013

Esta atualização contém as seguintes alterações:

• O objeto invideoPromotion do recurso channel tem as seguintes propriedades novas e atualizadas:

  • Agora a API oferece suporte à capacidade de especificar um site como um item promovido. Para fazer isso, defina o valor da propriedade invideoPromotion.items[].id.type como website e use a nova propriedade invideoPromotion.items[].id.websiteUrl para especificar o URL. Use também a nova propriedade invideoPromotion.items[].customMessage para definir uma mensagem personalizada a ser exibida para a promoção.

    Os links podem ser associados a websites, sites comerciais ou sites de redes sociais. Consulte as instruções da Central de Ajuda do YouTube para sites associados e sites de comerciantes para mais informações sobre como ativar links para seu conteúdo.

    Ao adicionar links promocionais, você concorda que eles não serão usados para redirecionar o tráfego para sites não autorizados e que eles obedecerão às políticas do Google AdSense, às políticas de anúncios do YouTube, às diretrizes da comunidade do YouTube e aos Termos de Serviço do YouTube.

  • As propriedades relacionadas às configurações de tempo para exibir itens promovidos durante a reprodução de vídeo foram reestruturadas:

    • O objeto invideoPromotion.timing foi movido para invideoPromotion.items[].timing. Agora, esse objeto permite personalizar os dados de tempo de cada item promovido na lista invideoPromotion.items[].

    • O novo objeto invideoPromotion.defaultTiming especifica as configurações de tempo padrão da sua promoção. Essas configurações definem quando um item promovido vai aparecer durante a reprodução de um dos vídeos do seu canal. É possível substituir o tempo padrão de qualquer item promovido usando o objeto invideoPromotion.items[].timing.

    • A nova propriedade invideoPromotion.items[].timing.durationMs especifica o tempo, em milissegundos, em que a promoção vai aparecer. O objeto invideoPromotion.defaultTiming também contém um campo durationMs que especifica o tempo padrão de exibição do item promovido.

  • As propriedades invideoPromotion.items[].type e invideoPromotion.items[].videoId foram movidas para o objeto invideoPromotion.items[].id.

• O método subscriptions.list agora oferece suporte aos parâmetros onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Ambos os parâmetros já são aceitos em vários outros métodos.

• Na resposta da API a uma solicitação thumbnails.set, o valor da propriedade kind mudou de youtube#thumbnailListResponse para youtube#thumbnailSetResponse.

• Foram adicionados exemplos de código para os seguintes métodos:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  O exemplo em Python para o método playlistItems.insert também foi removido, já que a funcionalidade demonstrada agora é processada pelo método videos.rate.

• O error documentation descreve o seguinte novo erro de contexto de solicitação, que pode ocorrer em qualquer método de API compatível com o parâmetro de solicitação mine:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidMine	O parâmetro mine não pode ser usado em solicitações em que o usuário autenticado é um parceiro do YouTube. Remova o parâmetro mine, faça a autenticação como um usuário do YouTube removendo o parâmetro onBehalfOfContentOwner ou aja como um dos canais do parceiro fornecendo o parâmetro onBehalfOfContentOwnerChannel, se disponível para o método chamado.

8 de agosto de 2013

Esta atualização contém as seguintes alterações:

• A seção Uso da cota do guia Primeiros passos com a API YouTube Data foi atualizada para refletir uma mudança no custo da cota de um envio de vídeo de aproximadamente 16.000 para aproximadamente 1.600 unidades.

30 de julho de 2013

Esta atualização contém as seguintes alterações:

• Em um recurso channelBanner, o valor da propriedade kind mudou de youtube#channelBannerInsertResponse para youtube#channelBannerResource. Esse recurso é retornado em resposta a uma solicitação channelBanners.insert.

• A nova propriedade brandingSettings.channel.profileColor do recurso channel especifica uma cor de destaque que complementa o conteúdo do canal. O valor da propriedade é um sinal de cerquilha (#) (#) seguido por uma string hexadecimal de seis caracteres, como #2793e6.

• Agora, a API oferece suporte para especificar se uma assinatura é para todas as atividades de um canal ou apenas para novos uploads. A nova propriedade contentDetails.activityType do recurso subscription identifica os tipos de atividades sobre os quais o assinante vai receber notificações. Os valores de propriedade válidos são all e uploads.

• O método videos.list oferece suporte a novos parâmetros para recuperar um gráfico dos vídeos mais populares do YouTube:

  • O parâmetro chart identifica o gráfico que você quer recuperar. No momento, o único valor aceito é mostPopular. O parâmetro chart é um parâmetro de filtro, o que significa que ele não pode ser usado na mesma solicitação que outros parâmetros de filtro (id e myRating).
  • O parâmetro videoCategoryId identifica a categoria de vídeo para a qual o gráfico será extraído. Esse parâmetro só pode ser usado com o parâmetro chart. Por padrão, os gráficos não são restritos a determinada categoria.

• A nova propriedade topicDetails.relevantTopicIds[] do recurso video fornece uma lista de IDs de tópicos do Freebase relevantes para o vídeo ou o conteúdo. Os assuntos desses vídeos podem ser mencionados ou aparecer no vídeo.

• A propriedade recordingDetails.location.elevation do recurso video foi renomeada como recordingDetails.location.altitude, e a propriedade fileDetails.recordingLocation.location.elevation foi renomeada como fileDetails.recordingLocation.location.altitude.

• O objeto contentDetails.contentRating do recurso video especifica as classificações que um vídeo recebeu em vários esquemas de classificação, incluindo classificações da MPAA, TVPG e assim por diante. Para cada sistema de classificação, a API agora oferece suporte a um valor de classificação que indica que o vídeo não foi classificado. Para classificações da MPAA, uma classificação "sem classificação" é usada com frequência para identificar versões não cortadas de filmes que receberam uma classificação oficial.

• A nova propriedade contentDetails.contentRating.ytRating do recurso video identifica o conteúdo com restrição de idade. O valor da propriedade será ytAgeRestricted se o YouTube identificar que o vídeo contém conteúdo inadequado para usuários com menos de 18 anos. Se a propriedade estiver ausente ou se o valor da propriedade estiver vazio, o conteúdo não terá sido identificado como restrito a maiores de idade.

• O parâmetro mySubscribers do método channels.list foi descontinuado. Use o método subscriptions.list e o parâmetro mySubscribers para recuperar uma lista de inscritos no canal do usuário autenticado.

• Os métodos channelBanners.insert, channels.update, videos.getRating e videos.rate agora oferecem suporte ao parâmetro onBehalfOfContentOwner. Esse parâmetro indica que o usuário autenticado está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro.

• A documentação do método channels.update foi atualizada para refletir o fato de que esse método pode ser usado para atualizar o objeto brandingSettings do recurso channel e as propriedades filhas dele. A documentação também lista a lista atualizada de propriedades que podem ser definidas para o objeto invideoPromotion do recurso channel.

• O error documentation descreve os seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	accountDelegationForbidden	Esse erro não é específico de um método de API específico. Ele indica que o usuário autenticado não está autorizado a agir em nome da Conta do Google especificada.
  forbidden	authenticatedUserAccountClosed	Esse erro não é específico de um método de API específico. Ele indica que a conta do YouTube do usuário autenticado foi encerrada. Se o usuário estiver agindo em nome de outra Conta do Google, esse erro indicará que a outra conta está encerrada.
  forbidden	authenticatedUserAccountSuspended	Esse erro não é específico de um método de API específico. Ele indica que a conta do YouTube do usuário autenticado está suspensa. Se o usuário estiver agindo em nome de outra Conta do Google, esse erro indicará que a outra conta está suspensa.
  forbidden	authenticatedUserNotChannel	Esse erro não é específico de um método de API específico. Ele indica que o servidor da API não consegue identificar o canal associado à solicitação da API. Se a solicitação for autorizada e usar o parâmetro onBehalfOfContentOwner, também será necessário definir o parâmetro onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Esse erro não é específico de um método de API específico. O usuário do CMS não está autorizado a agir em nome do proprietário do conteúdo especificado.
  notFound	contentOwnerAccountNotFound	Esse erro não é específico de um método de API específico. Não foi possível encontrar a conta do proprietário do conteúdo especificada.
  badRequest	invalidPart	Esse erro não é específico de um método de API específico. O parâmetro part da solicitação especifica partes que não podem ser gravadas ao mesmo tempo.
  badRequest	videoChartNotFound	O método videos.list retorna esse erro quando a solicitação especifica um gráfico de vídeo indisponível ou não compatível.
  notFound	videoNotFound	O método videos.update retorna esse erro para indicar que não foi possível encontrar o vídeo que você está tentando atualizar. Verifique o valor da propriedade id no corpo da solicitação para garantir que ele está correto.

10 de junho de 2013

Esta atualização contém as seguintes alterações:

• O novo parâmetro forUsername do método channels.list permite que você recupere informações sobre um canal especificando o nome de usuário dele no YouTube.

• O método activities.list agora oferece suporte ao parâmetro regionCode, que instrui a API a retornar resultados relevantes para o país especificado. O YouTube usa esse valor quando a atividade anterior do usuário autorizado no YouTube não fornece informações suficientes para gerar o feed de atividade.

• Os recursos de playlist agora contêm a propriedade snippet.tags. A propriedade só será retornada para usuários autorizados que estão recuperando dados sobre as próprias playlists. Os usuários autorizados também podem definir tags de playlist ao chamar os métodos playlists.insert ou playlists.update.

• O parâmetro onBehalfOfContentOwner, que antes era aceito nos métodos channels.list e search.list, agora também é aceito nos métodos videos.insert, videos.update e videos.delete. Quando esse parâmetro é usado em uma chamada para o método videos.insert, a solicitação também precisa especificar um valor para o novo parâmetro onBehalfOfContentOwnerChannel, que identifica o canal em que o vídeo será adicionado. O canal precisa estar vinculado ao proprietário do conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

  O parâmetro indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado.

  Esse parâmetro é destinado a parceiros de conteúdo que possuem e gerenciam vários canais do YouTube. Com esse parâmetro, os parceiros podem fazer a autenticação uma vez e ter acesso a todos os dados de vídeos e canais sem precisar fornecer credenciais de autenticação para cada canal.

  Especificamente em relação a essa versão, o parâmetro agora permite que um parceiro de conteúdo insira, atualize ou exclua vídeos em qualquer um dos canais do YouTube que ele possui.

• O error documentation descreve os seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	insufficientCapabilities	Esse erro não é específico de um método de API específico. Indica que o usuário do CMS que chama a API não tem permissões suficientes para realizar a operação solicitada. Esse erro está associado ao uso do parâmetro onBehalfOfContentOwner, que é aceito em vários métodos de API.
  unauthorized	authorizationRequired	O método activities.list retorna esse erro quando a solicitação usa o parâmetro home, mas não está autorizado corretamente.

• No recurso channels, a propriedade invideoPromotion.channelId foi removida porque o ID do canal já está especificado usando a propriedade id do recurso.

• O novo guia Como trabalhar com IDs de canal explica como a API usa esses IDs. O guia pode ser especialmente útil para desenvolvedores que estão migrando da versão anterior da API e que têm aplicativos que solicitam conteúdo para o usuário default ou que dependem da noção de que cada canal do YouTube tem um nome de usuário exclusivo, o que não é mais o caso.

22 de maio de 2013

Esta atualização contém as seguintes alterações:

• O novo método channelBanners.insert permite fazer upload de uma imagem de banner que pode ser definida como a imagem de banner de um canal usando a nova propriedade brandingSettings.image.bannerExternalUrl do recurso channel.

• A documentação do método channels.update foi atualizada para listar as propriedades que podem ser modificadas ao chamar o método.

• A documentação do recurso video não lista mais unspecified como um valor de propriedade válido para as propriedades suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] e suggestions.editorSuggestions[].

• O parâmetro maxResults do método videos.list agora tem um valor padrão de 5.

• O error documentation agora lista erros para os métodos channelBanners.insert e subscriptions.list. Ele também lista vários novos erros para o método channels.update.

14 de maio de 2013

Esta atualização contém as seguintes alterações:

• As páginas independentes agora listam exemplos de código para Java, .NET, PHP e Ruby.

• A página que lista exemplos de código do Python agora inclui exemplos para adicionar uma assinatura, criar uma playlist e atualizar um vídeo.

10 de maio de 2013

Esta atualização contém as seguintes alterações:

• O YouTube não identifica mais os recursos e serviços experimentais da API. Em vez disso, agora fornecemos uma lista de APIs do YouTube sujeitas à política de suspensão de uso.

8 de maio de 2013

Esta atualização contém as seguintes alterações:

• Os recursos do canal agora são compatíveis com o objeto inVideoPromotion, que encapsula informações sobre uma campanha promocional associada ao canal. Um canal pode usar uma campanha promocional no vídeo para mostrar imagens de miniatura de um vídeo promovido no player durante a reprodução dos vídeos do canal.

  Para recuperar esses dados, inclua invideoPromotion no valor do parâmetro part em uma solicitação channels.list.

• O novo método channels.update pode ser usado para atualizar os dados da campanha promocional no vídeo de um canal. O método só oferece suporte a atualizações na parte invideoPromotion do recurso channel e ainda não oferece suporte a atualizações em outras partes desse recurso.

2 de maio de 2013

Esta atualização contém as seguintes alterações:

• Os recursos do canal agora oferecem suporte à propriedade status.isLinked, que indica se os dados do canal identificam um usuário já vinculado a um nome de usuário do YouTube ou a uma conta do Google+. Um usuário que tenha um desses links já tem uma identidade pública do YouTube, que é um pré-requisito para várias ações, como enviar vídeos.

• Os recursos de assinatura agora oferecem suporte à parte subscriberSnippet. Esse objeto encapsula dados de snippet para o canal do assinante.

• Agora, a API oferece suporte ao método videos.getRating, que recupera as classificações que o usuário autenticado deu a uma lista de um ou mais vídeos.

• O novo parâmetro myRating do método videos.list permite que você recupere uma lista de vídeos que o usuário autenticado avaliou com like ou dislike.

  Os parâmetros myRating e id agora são considerados parâmetros de filtro, o que significa que uma solicitação de API precisa especificar exatamente um dos parâmetros. Antes, o parâmetro id era obrigatório para esse método.

  O método retorna um erro forbidden para solicitações que tentam recuperar informações de classificação de vídeo, mas não estão devidamente autorizadas a fazer isso.

• Com a introdução do parâmetro myRating, o método videos.list também foi atualizado para oferecer suporte à paginação. No entanto, os parâmetros de paginação têm suporte apenas para solicitações que usam o parâmetro myRating. Os parâmetros e as informações de paginação não são compatíveis com solicitações que usam o parâmetro id.

  • O parâmetro maxResults especifica o número máximo de vídeos que a API pode retornar no conjunto de resultados, e o parâmetro pageToken identifica uma página específica no conjunto de resultados que você quer recuperar.

  • O recurso youtube#videoListResponse, que é retornado em resposta a uma solicitação videos.list, agora contém o objeto pageInfo, que contém detalhes como o número total de resultados e o número de resultados incluídos no conjunto de resultados atual. O recurso youtube#videoListResponse também pode incluir as propriedades nextPageToken e prevPageToken, cada uma delas fornece um token que pode ser usado para recuperar uma página específica no conjunto de resultados.

• O método videos.insert oferece suporte aos seguintes novos parâmetros:

  • autoLevels: defina o valor desse parâmetro como true para instruir o YouTube a melhorar automaticamente a iluminação e a cor do vídeo.
  • stabilize: defina esse valor de parâmetro como true para instruir o YouTube a ajustar o vídeo removendo a tremulação resultante dos movimentos da câmera.

• A propriedade channelTitle foi adicionada ao snippet para os seguintes recursos:

  • playlistItem: a propriedade especifica o nome do canal que adicionou o item da playlist.
  • playlist: a propriedade especifica o nome do canal que criou a playlist.
  • subscription: a propriedade especifica o nome do canal a que você está inscrito.

• Foram adicionados exemplos de código para os seguintes métodos:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• O novo parâmetro mySubscribers do método subscriptions.list permite recuperar uma lista dos assinantes do usuário autenticado. Esse parâmetro só pode ser usado em uma solicitação devidamente autorizada.

  Observação:essa funcionalidade tem como objetivo substituir o parâmetro mySubscribers, que é compatível com o método channels.list. Esse parâmetro será descontinuado.

• Em um recurso video, o valor da propriedade unspecified não é mais um valor possível para nenhuma das seguintes propriedades:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• As solicitações de API que contêm um parâmetro inesperado agora retornam um erro badRequest, e o motivo informado para o erro é unexpectedParameter.

• O erro que o método playlistItems.insert retorna quando a playlist já contém o número máximo de itens permitidos foi atualizado. Agora, o erro é informado como forbidden, e o motivo é playlistContainsMaximumNumberOfVideos.

19 de abril de 2013

Esta atualização contém as seguintes alterações:

• O novo método videos.rate permite que um usuário defina uma classificação like ou dislike em um vídeo ou remova uma classificação de um vídeo.

  A documentação de erros também foi atualizada para listar os erros que a API pode retornar em resposta a uma chamada de método videos.rate.

• As imagens de miniatura agora são identificadas na documentação da API como um recurso separado, e o novo método thumbnails.set permite que você faça upload de uma miniatura personalizada do vídeo no YouTube e a defina para um vídeo.

  A documentação de erros também foi atualizada para listar os erros que a API pode retornar em resposta a uma chamada de método thumbnails.set.

  Essa mudança não afeta os recursos que retornam imagens de miniatura. As imagens de miniatura são retornadas nesses recursos da mesma forma que antes, embora a documentação agora liste os nomes dos diferentes tamanhos de miniatura que a API pode retornar.

• A nova parte brandingSettings do recurso channel identifica as configurações, o texto e as imagens da página do canal e das páginas de exibição de vídeo.

• O recurso playlistItem contém as seguintes novas propriedades:

  • O novo objeto status encapsula informações de status sobre o item da playlist, e a propriedade status.privacyStatus identifica o status de privacidade do item.

• O recurso video contém as seguintes novas propriedades:

  • A propriedade status.publicStatsViewable indica se as estatísticas de vídeo estendidas na página de exibição podem ser visualizadas publicamente. Por padrão, essas estatísticas são visíveis, e estatísticas como a contagem de visualizações e as classificações de um vídeo ainda vão aparecer publicamente, mesmo que o valor dessa propriedade seja definido como false. É possível definir o valor dessa propriedade ao chamar o método videos.insert ou videos.update.

  • O objeto contentDetails.contentRating encapsula as classificações que o vídeo recebeu em vários esquemas de classificação. A lista abaixo identifica os sistemas de classificação aceitos e fornece um link para a propriedade associada a cada sistema de classificação. As definições de propriedade identificam os valores de classificação compatíveis para cada sistema.

    País	Sistema de classificação	Propriedade
    Estados Unidos	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    Estados Unidos	Orientação dos pais para a televisão	contentDetails.contentRating.tvpgRating
    Austrália	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brasil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canadá	Canadian Home Video Rating System (CHVRS)	contentDetails.contentRating.chvrsRating
    França	Centre national du cinéma et de l'image animée (Ministério da Cultura da França)	contentDetails.contentRating.fmocRating
    Alemanha	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Grã-Bretanha	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    Índia	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japão	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Coreia	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    México	Diretoria Geral de Rádio, Televisão e Cinematografia (RTC)	contentDetails.contentRating.rtcRating
    Nova Zelândia	Escritório de classificação de filmes e literatura	contentDetails.contentRating.oflcRating
    Rússia	Registro Nacional de Filmes da Federação Russa	contentDetails.contentRating.russiaRating
    Espanha	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• A documentação do método playlistItems.update foi atualizada para refletir o fato de que a propriedade snippet.resourceId precisa ser especificada no recurso enviado como o corpo da solicitação.

• O método search.list agora oferece suporte às seguintes funcionalidades:

  • O novo parâmetro forMine restringe uma pesquisa para recuperar apenas os vídeos do usuário autenticado.

  • Agora o parâmetro order oferece suporte à capacidade de classificar os resultados alfabeticamente por título (order=title) ou por contagem de vídeos em ordem decrescente (order=videoCount).

  • O novo parâmetro safeSearch indica se os resultados da pesquisa precisam incluir conteúdo restrito.

• O método videos.insert é compatível com vários novos erros, que estão listados na tabela abaixo:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidCategoryId	A propriedade snippet.categoryId especifica um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias compatíveis.
  badRequest	invalidRecordingDetails	O metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	Os metadados da solicitação especificam uma classificação de video game inv.
  badRequest	invalidVideoMetadata	Os metadados da solicitação são inválidos.

• O parâmetro onBehalfOfContentOwner foi removido da lista de parâmetros compatíveis com os métodos videos.update e videos.delete.

12 de março de 2013

Esta atualização contém as seguintes alterações:

• A propriedade channelTitle foi adicionada ao snippet para os seguintes recursos:

  • activity: a propriedade especifica o nome do canal responsável pela atividade.
  • search: a propriedade especifica o nome do canal associado ao recurso identificado pelo resultado da pesquisa.
  • video: a propriedade especifica o nome do canal que enviou o vídeo.

• O método search.list oferece suporte aos seguintes novos parâmetros:

  • O parâmetro channelType permite restringir uma pesquisa de canais para recuperar todos os canais ou apenas programas.

  • O parâmetro videoType permite restringir uma pesquisa de vídeos para recuperar todos os vídeos ou apenas filmes ou episódios de programas.

• A definição da parte recordingDetails do recurso video foi atualizada para indicar que o objeto só será retornado para um vídeo se os dados de geolocalização ou o tempo de gravação do vídeo tiverem sido definidos.

• O método playlistItems.update agora retorna um erro invalidSnippet, que é retornado se a solicitação da API não especificar um snippet válido.

• Vários métodos de API são compatíveis com novos parâmetros destinados exclusivamente a parceiros de conteúdo do YouTube. Os parceiros de conteúdo do YouTube incluem estúdios de cinema e TV, gravadoras e outros criadores de conteúdo que disponibilizam conteúdo no YouTube.

  • O parâmetro onBehalfOfContentOwner indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado.

    Esse parâmetro é destinado a parceiros de conteúdo que possuem e gerenciam vários canais do YouTube. Com esse parâmetro, os parceiros podem fazer a autenticação uma vez e ter acesso a todos os dados de vídeos e canais sem precisar fornecer credenciais de autenticação para cada canal.

    Os métodos channels.list, search.list, videos.delete, videos.list e videos.update oferecem suporte a esse parâmetro.

  • O parâmetro managedByMe, que é aceito pelo método channels.list, instrui a API a retornar todos os canais pertencentes ao proprietário do conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

  • O parâmetro forContentOwner, que é aceito pelo método search.list, instrui a API a restringir os resultados da pesquisa para incluir apenas recursos que pertencem ao proprietário de conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

25 de fevereiro de 2013

Esta atualização contém as seguintes alterações:

• A API oferece suporte a várias partes e propriedades novas para recursos video:

  • As novas partes fileDetails, processingDetails e suggestions fornecem informações aos proprietários sobre os vídeos enviados. Esses dados são muito úteis em apps que permitem uploads de vídeo e incluem o seguinte:

    • status e andamento do processamento
    • erros ou outros problemas encontrados durante o processamento de um vídeo
    • disponibilidade de imagens em miniatura
    • sugestões para melhorar a qualidade do vídeo ou dos metadados
    • detalhes sobre o arquivo original enviado ao YouTube

    Todas essas partes só podem ser recuperadas pelo proprietário do vídeo. A lista abaixo descreve brevemente as novas partes, e a documentação do recurso video define todas as propriedades que cada parte contém.

    • O objeto fileDetails contém informações sobre o arquivo de vídeo enviado para o YouTube, incluindo a resolução, a duração, os codecs de áudio e vídeo, os bitrates de streaming e muito mais.

    • O objeto processingProgress contém informações sobre o progresso do YouTube no processamento do arquivo de vídeo enviado. As propriedades do objeto identificam o status atual do processamento e estimam o tempo restante até que o YouTube termine de processar o vídeo. Esta parte também indica se os diferentes tipos de dados ou de conteúdo, como detalhes do arquivo ou imagens em miniatura, estão disponíveis para o vídeo.

      Esse objeto foi criado para ser consultado, para que o usuário que enviou o vídeo possa acompanhar o progresso do processamento do arquivo enviado.

    • O objeto suggestions contém sugestões que identificam oportunidades para melhorar a qualidade ou os metadados do vídeo enviado.

  • A parte contentDetails contém quatro novas propriedades. Essas propriedades podem ser recuperadas com solicitações não autenticadas.

    • dimension: indica se o vídeo está disponível em 2D ou 3D.
    • definition: indica se o vídeo está disponível em definição padrão ou alta.
    • caption: indica se há legendas disponíveis para o vídeo.
    • licensedContent: indica se o vídeo contém conteúdo reivindicado por um parceiro de conteúdo do YouTube.

  • A parte status contém duas novas propriedades. Os proprietários de vídeos podem definir valores para as duas propriedades ao inserir ou atualizar um vídeo. Essas propriedades também podem ser recuperadas com solicitações não autenticadas.

    • embeddable: indica se o vídeo pode ser incorporado em outro site.
    • license: especifica a licença do vídeo. Os valores válidos são creativeCommon e youtube.

• A definição do parâmetro part foi atualizada para os métodos videos.list, videos.insert e videos.update para listar as partes recém-adicionadas descritas acima, bem como a parte recordingDetails, que foi omitida acidentalmente.

• A nova propriedade contentDetails.googlePlusUserId do recurso channel especifica o ID do perfil do Google+ associado ao canal. Esse valor pode ser usado para gerar um link para o perfil do Google+.

• Cada objeto de imagem de miniatura agora especifica a largura e a altura da imagem. No momento, as imagens de miniatura são retornadas nos recursos activity, channel, playlist, playlistItem, search result, subscription e video.

• Agora, o playlistItems.list oferece suporte ao parâmetro videoId, que pode ser usado com o parâmetro playlistId para recuperar apenas o item da playlist que representa o vídeo especificado.

  A API vai retornar um erro notFound se o vídeo identificado pelo parâmetro não for encontrado na playlist.

• A documentação de erros descreve um novo erro forbidden, que indica que uma solicitação não está autorizada corretamente para a ação solicitada.

• A propriedade snippet.channelId do recurso channel foi removida. A propriedade id do recurso fornece o mesmo valor.

30 de janeiro de 2013

Esta atualização contém as seguintes alterações:

• A nova página error lista os erros que a API pode retornar. A página inclui erros gerais, que podem ocorrer em vários métodos de API diferentes, e erros específicos de método.

16 de janeiro de 2013

Esta atualização contém as seguintes alterações:

• Os exemplos de código agora estão disponíveis para os métodos e idiomas mostrados na lista abaixo:

  • activities.insert: Java
  • playlistItems.insert: Python
  • playlistItems.list: Java, JavaScript, PHP, Python, Ruby
  • playlists.insert: Java, JavaScript, Python
  • search.list: Java, JavaScript, Python, Ruby
  • videos.insert: Java

• Agora, um recurso activity pode informar uma ação channelItem, que ocorre quando o YouTube adiciona um vídeo a um canal do YouTube gerado automaticamente. O YouTube identifica algoritmos que têm uma presença significativa no site e gera canais automaticamente para esses temas.

• Os seguintes parâmetros search.list foram atualizados:

  • O parâmetro q não é mais designado como um filtro, o que significa que...
  • O parâmetro relatedToVideo foi renomeado como relatedToVideoId.
  • O parâmetro published foi substituído por dois novos parâmetros, publishedAfter e publishedBefore, que são descritos abaixo.

• O método search.list oferece suporte aos seguintes novos parâmetros:

  Nome do parâmetro	Valor	Descrição
  channelId	string	Retorna os recursos criados pelo canal especificado.
  publishedAfter	datetime	Retorna os recursos criados após o horário especificado.
  publishedBefore	datetime	Retorna os recursos criados antes do horário especificado.
  regionCode	string	Retorna recursos para o país especificado.
  videoCategoryId	string	Filtrar os resultados da pesquisa de vídeo para incluir apenas vídeos associados à categoria de vídeo especificada.
  videoEmbeddable	string	Filtrar os resultados da pesquisa de vídeo para incluir apenas vídeos que podem ser reproduzidos em um player incorporado em uma página da Web. Defina o valor do parâmetro como true para recuperar apenas vídeos que podem ser incorporados.
  videoSyndicated	string	Filtre os resultados da pesquisa de vídeo para incluir apenas vídeos que podem ser reproduzidos fora do YouTube.com. Defina o valor do parâmetro como true para recuperar apenas vídeos distribuídos.

• Vários recursos de API são compatíveis com novas propriedades. A tabela abaixo identifica os recursos e as novas propriedades:

  Recurso	Nome da propriedade	Valor	Descrição
  activity	contentDetails.playlistItem.playlistItemId	string	O ID do item da playlist que o YouTube atribuiu para identificar o item de forma exclusiva.
  activity	contentDetails.channelItem	object	Um objeto que contém informações sobre um recurso adicionado a um canal. Essa propriedade só estará presente se snippet.type for channelItem.
  activity	contentDetails.channelItem.resourceId	object	Um objeto que identifica o recurso adicionado ao canal. Como outras propriedades resourceId, ela contém uma propriedade kind que especifica o tipo de recurso, como vídeo ou playlist. Ele também contém exatamente uma das várias propriedades (videoId, playlistId etc.) que especificam o ID que identifica exclusivamente esse recurso.
  channel	status	object	Esse objeto encapsula informações sobre o status de privacidade do canal.
  channel	status.privacyStatus	string	O status de privacidade do canal. Os valores válidos são: private e public.
  playlist	contentDetails	object	Esse objeto contém metadados sobre o conteúdo da playlist.
  playlist	contentDetails.itemCount	unsigned integer	O número de vídeos na playlist.
  playlist	player	object	Esse objeto contém informações que você usaria para reproduzir a playlist em um player incorporado.
  playlist	player.embedHtml	string	Uma tag <iframe> que incorpora um player de vídeo que reproduz a playlist.
  video	recordingDetails	object	Esse objeto encapsula informações que identificam ou descrevem o local e a hora em que o vídeo foi gravado.
  video	recordingDetails.location	object	Esse objeto contém informações de geolocalização associadas ao vídeo.
  video	recordingDetails.location.latitude	double	Latitude em graus.
  video	recordingDetails.location.longitude	double	Longitude em graus.
  video	recordingDetails.location.elevation	double	Altitude acima da Terra, em metros.
  video	recordingDetails.locationDescription	string	Uma descrição em texto do local onde o vídeo foi gravado.
  video	recordingDetails.recordingDate	datetime	A data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• A documentação de vários métodos de API agora identifica propriedades que precisam ser especificadas no corpo da solicitação ou que são atualizadas com base nos valores no corpo da solicitação. A tabela abaixo lista esses métodos, além das propriedades obrigatórias ou modificáveis.

  Observação:a documentação de outros métodos pode já listar propriedades obrigatórias e modificáveis.

  Método	Propriedades
  activities.insert	Propriedades obrigatórias: snippet.description Propriedades modificáveis: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Propriedades obrigatórias: id
  playlistItems.update	Propriedades obrigatórias: id
  videos.update	Propriedades obrigatórias: id

• A API não vai mais informar um erro playlistAlreadyExists se você tentar create ou atualizar uma playlist com o mesmo título de uma que já existe no mesmo canal.

• Vários métodos de API são compatíveis com novos tipos de erro. A tabela abaixo identifica o método e os erros com suporte recente:

  Método	Tipo de erro	Detalhe do erro	Descrição
  guideCategories.list	notFound	notFound	Não foi possível encontrar a categoria de guia identificada pelo parâmetro id. Use o método guideCategories.list para recuperar uma lista de valores válidos.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	A solicitação não está devidamente autorizada a excluir o item da playlist especificado.
  videoCategories.list	notFound	videoCategoryNotFound	Não foi possível encontrar a categoria de vídeo identificada pelo parâmetro id. Use o método videoCategories.list para recuperar uma lista de valores válidos.