Histórico de revisões

Esta página lista as alterações da API YouTube Data (v3) e as 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 A/S.

Exemplos de conteúdo 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
• Gerar uma cena realista que não ocorreu de fato

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 definido, 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 legendas. Caso contrário, o upload 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 mostrar que o tamanho máximo permitido do campo snippet.name é de 150 caracteres. A API retornará um erro nameTooLong se o nome da faixa for maior que isso.

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 não vai mais 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 dele.

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 já não é 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 YouTube Data 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.

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.

Entre hoje e 1o de dezembro de 2022, os métodos captions.list, captions.update, captions.download e captions.delete serão compatíveis com os IDs antigos e novos das faixas de legenda. No entanto, a partir de 1o de dezembro de 2022, o YouTube não vai mais oferecer suporte aos IDs antigos das faixas de legenda. 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 faixa de legenda, exclua os dados armazenados no momento e chame o método captions.list para recuperar o conjunto atual de faixas de legenda para o vídeo e armazenar os dados na resposta da API, como faria normalmente.

12 de julho de 2022

Os Termos de Serviço das APIs do YouTube foram atualizados. Para mais informações, consulte os Termos de Serviço dos serviços de API do YouTube - Histórico de revisõ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âmetros 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 alteração representa uma correção da 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, junto com mudanças para tornar as contagens de marcações "Não gostei" de vídeos privadas em toda a plataforma do YouTube, a propriedade statistics.dislikeCount do recurso video agora é particular.

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 de 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 exibem a contagem de "Não gostei" publicamente e ainda precisam da contagem de "Não gostei" do cliente da API podem se inscrever para serem colocados em uma lista de permissões para receber uma isenção. 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 recebe mais suporte. Esse endpoint duplicou a funcionalidade disponível por meio de outros endpoints da API. Em vez disso, chame comments.update.

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 conformidade 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 o preenchimento deles:

• Formulário de solicitações de desenvolvedor auditado: os desenvolvedores que já foram aprovados em uma auditoria de conformidade 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 foram reprovados em uma auditoria de conformidade ou tiveram um aumento de unidade de cota negado podem preencher e enviar esse 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 vai nos informar sobre o uso pretendido da API do YouTube e nos ajudar da melhor forma possível.

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 na 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 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 compatíveis com a interface do YouTube Studio e no 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 delas 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 valores a seguir foram descontinuados. Esses valores já não são aceitos nas páginas de canais 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 é compatível com o YouTube e, por isso, não é mais aceita pela API.

9 de fevereiro de 2021

O recurso playlistItem é compatível com 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 executar 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 disso, adicionamos um lembrete à documentação do parâmetro do player incorporado para explicar que, se você ativar a reprodução automática, a reprodução ocorrerá sem qualquer interação do usuário com o player. Portanto, a coleta e o compartilhamento de dados de reprodução ocorrerá após o 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 em 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 apenas 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, identificadas na propriedade brandingSettings.channel.keywords, poderão ser truncadas se excederem o tamanho máximo permitido de 500 caracteres ou se contiverem aspas sem escape ("). O limite de 500 caracteres não é um limite por palavra-chave, mas sim um limite 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 na API. Todas as mudanças entrarão em vigor a partir de 9 de setembro de 2020, na 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. A compatibilidade dos métodos playlistItems.insert e playlistItems.delete com essas playlists também foi totalmente descontinuada, e as duas propriedades foram removidas da documentação.
• O parâmetro mySubscribers do método channels.list, 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 o processo de cobrança de cotas para solicitações de API removendo o custo adicional associado ao parâmetro part. A partir de agora, só vamos cobrar o custo básico do método chamado. Veja mais informações sobre a cota simplificada aqui.

Com essa mudança, a maioria das chamadas de API terá um custo de cota ligeiramente menor, enquanto algumas chamadas de API continuarão com o mesmo custo. Essa mudança não aumenta o custo das chamadas de API. No geral, o impacto provável é que sua cota alocada, que pode ser vista no console do Google Cloud, vai ser um pouco maior.

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 remover 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 serão afetados por essa mudança. 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 alteração de cota ainda não está em vigor. Por isso, a documentação foi revertida para fins de precisão. Para evitar confusão, a entrada do histórico de revisões explicando 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 os clientes da API sigam partes específicas dos Termos e políticas (TOS) dos serviços de API do YouTube.

Essas orientações oferecem insights sobre como o YouTube aplica determinados aspectos dos TOS da API, mas não substituem os documentos existentes. Ele aborda algumas das perguntas mais comuns que os desenvolvedores fazem durante auditorias de conformidade com a API. Esperamos que isso simplifique seu processo de desenvolvimento de recursos ao ajudar 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 de canais. Para mais detalhes, acesse a Central de Ajuda do YouTube.

17 de abril de 2020

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

O YouTube vai descontinuar o recurso de boletim de canais. Consequentemente, o método activities.insert será descontinuado e o método activities.list deixará de retornar boletins de canais. Essas mudanças entrarão 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 monetário recorrente a um criador de conteúdo e recebe benefícios especiais. Por exemplo, os membros podem participar de chats quando o criador de conteúdo 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 de API. O método membershipsLevels.list recupera uma lista de todos os níveis de assinatura do criador.

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 são compatíveis com duas novas propriedades para permitir que criadores 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ó será incluída nas respostas da API que contenham recursos channel ou video se o proprietário do canal tiver autorizado a solicitação de 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 e nas Políticas de Desenvolvedor dos serviços de API do YouTube 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 alteração 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 de dados sobre o próprio canal. Os proprietários dos canais ainda podem ver as contagens de inscritos exatas no YouTube Studio.

Por exemplo, se um canal tiver 123.456 inscritos, a propriedade statistics.subscriberCount terá 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 do usuário do YouTube visíveis publicamente:

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, é possível selecionar escopos de autorização, inserir exemplos de valores de parâmetros e propriedades, enviar solicitações de API reais e ver as respostas reais da API. 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, você pode chamar o método channels.list para recuperar dados sobre um canal específico ou sobre o canal do usuário atual.

    Você pode usar links nessa seção para preencher o APIs Explorer com exemplos de valores para seu caso de uso ou abrir o APIs Explorer em tela cheia com esses valores já preenchidos. Essas mudanças têm como objetivo facilitar a visualização de exemplos de código diretamente aplicáveis ao caso de uso que você está tentando implementar no próprio aplicativo.

  No momento, os exemplos de código são compatíveis com Java, JavaScript, PHP, Python e curl.

• A ferramenta de exemplos de código também foi atualizada com uma nova interface que oferece os mesmos recursos descritos acima. Com essa ferramenta, você pode explorar casos de uso para diferentes métodos, carregar valores no APIs Explorer e abrir o APIs Explorer em tela cheia para obter 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 observar que, ao exibir miniaturas no aplicativo, seu código precisa usar os URLs de imagem exatamente como são retornados nas respostas da API. Por exemplo, seu aplicativo não deve 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 de canais só estarão 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 retornarão valores para essa propriedade. Da mesma forma, mesmo se as solicitações da API tentarem definir um valor para essa propriedade, é possível que os dados de entrada 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 de invideoPromotion ao chamar channels.list retornarão um invideoPromotion vazio ou não retornarão nenhum dado de 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 utilitárias que não aparecem no guia de 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 amostras de código completas 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 ver os exemplos completos (e essa alteração):

  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 vai mostrar 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 vincula a uma amostra de aplicativo de servidor da Web.
  5. Clique no link para acessar o exemplo do servidor da Web. Esse exemplo usa o framework de aplicativo 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 as amostras, consulte as instruções para executar amostras de código completas 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 novos do YouTube também são mostrados nessa página, e você pode fazer o download deles no Site da marca 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 de dados 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
  • Alternar entre snippets de código 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. As propriedades serão compatíveis até 1o de dezembro de 2017, mas não há garantia de que os vídeos continuarão 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 os métodos da API, como channels.list ou videos.rate, agora apresentam 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:

  • Se você modificar os valores de parâmetros e propriedades, os snippets de código serão atualizados dinamicamente para refletir os valores fornecidos.

  • Alterne entre snippets de código e amostras completas. Um snippet de código mostra a parte do código que chama o método da API. Uma amostra completa contém esse snippet, bem como um código boilerplate para autorização e envio de 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 estava 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 recursos novos disponíveis nessa 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 YouTube Data. 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 a hora em que o vídeo foi publicado no YouTube. O recurso já contém a propriedade snippet.publishedAt, que identifica a hora 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.

  Observe também que existem algumas categorias principais (Entertainment, Gaming, Lifestyle, Music e Sports). Qualquer vídeo associado a uma categoria filha, como Tennis, também será associado à categoria principal (Sports).

10 de novembro de 2016

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

• Conforme anunciado pela primeira vez em 11 de agosto de 2016, a descontinuação do Freebase e da API Freebase requer várias mudanças relacionadas aos IDs de tópicos. 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 começará a retornar um pequeno conjunto de IDs de tópicos em vez de um conjunto muito mais granular de IDs retornados até o momento. 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. Esta propriedade 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 terá valores após 10 de fevereiro de 2017. Após essa data, o valor da propriedade topicDetails.relevantTopicIds[] 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 propriedades novas:

    • 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 posteriormente 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ó é 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 é compatível com dois novos parâmetros, maxHeight e maxWidth. É possível usar um dos parâmetros ou ambos 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 enquadrando o 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, você pode especificar que, em vez das dimensões padrão, o código de incorporação deve usar uma altura e/ou largura adequada para o layout do seu aplicativo. O servidor da API dimensiona as dimensões do player de acordo com a necessidade 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 estiver definido, a API vai retornar um player de 960 x 540.
    • Se o parâmetro maxWidth for definido como 960 e o parâmetro maxHeight estiver definido como 450, a API vai retornar um player de 800 x 450.

    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 atuais

  • 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 serão excluídas se a seção do canal for modificada na 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 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 serão ignorados se forem definidos em solicitações playlistItems.insert ou playlistItems.update.

  • Os métodos playlistItems.delete e playlistItems.update agora aceitam o 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 são inclusivos. Por exemplo, se o parâmetro publishedBefore estiver definido, a API vai retornar recursos criados antes ou no momento 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 de arquivo para 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 na página inicial do usuário não estão disponíveis por essa 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. Esse erro ocorre porque 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 ser enviado.
    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 podem não ter permissão para oferecer players incorporados para transmissões ao vivo. Acesse a Central de Ajuda do YouTube para mais informações.

  • O método playlistItems.insert não retorna mais um erro se você inserir um vídeo duplicado em uma playlist. Esse erro ocorreu anteriormente para algumas playlists, como vídeos favoritos, que não permitiam cópias, mas não são mais compatíveis. Em geral, as playlists permitem cópias de vídeos.

• 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 que serão compatíveis será publicada até 10 de novembro de 2016.

• As seguintes mudanças estão em vigor. Um aviso sobre essas alterações foi enviado 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 agora conterá itens semelhantes aos que um usuário do YouTube desconectado veria na página inicial.

    Esta é uma pequena alteração destinada a proporcionar uma melhor experiência do usuário 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 recupera dados sobre o próprio canal do usuário. 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, assim como para qualquer ID do histórico de exibição ou da playlist "Assistir mais tarde" que seu 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, assim 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 dos novos documentos está descrito no histórico de revisões dos Termos atualizados. Além disso, alterações futuras nos Termos atualizados ou nos documentos de comprovação também serão explicadas no 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ópicos são usados nos seguintes recursos e métodos da 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 tópico específico.

  Estas são as mudanças nesses recursos:

  • A partir de 10 de fevereiro de 2017, o YouTube começará a retornar um pequeno conjunto de IDs de tópicos em vez de um conjunto muito mais granular de IDs retornados até o momento. Esse conjunto de temas aceitos vai identificar categorizações gerais, como Esportes ou Basquete, mas, por exemplo, não vai identificar times ou jogadores específicos. Anunciaremos o conjunto de tópicos compatíveis para que você tenha tempo de preparar sua inscrição 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 esteja no conjunto menor de IDs de tópico compatíveis, a API retornará um conjunto de resultados vazio.

• Vários campos e parâmetros de API serão suspensos a partir de 12 de setembro de 2016:

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

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

    As solicitações para recuperar detalhes da playlist (playlists.list) referentes ao histórico de exibição ou à playlist "Assistir mais tarde" de um canal retornarão uma lista vazia após 12 de setembro de 2016. As solicitações para recuperar itens da playlist (playlistItems.list) em uma dessas playlists também vão retornar uma lista vazia após esse período. Isso é válido 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 depois de 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ó estava presente 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 em ordem cronológica inversa da data de inscrição.

  O novo parâmetro só oferece suporte à recuperação dos últimos mil inscritos no 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 estão disponíveis apenas 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 atualizará os snippets de código para refletir os valores de parâmetros 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 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 exibidas.

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 propriedades:

  • 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ó fica visível para o proprietário do vídeo.

• A definição da propriedade contentDetails.relatedPlaylists.favorites do recurso channel foi atualizada para informar 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 já foi descontinuada. Essa propriedade não está sujeita à política de descontinuação de APIs.

• A definição do erro ineligibleAccount, que pode ser retornado pelos métodos 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 de API não foi mesclada com a 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 de primeiros passos foi atualizada para vincular ao Google Developer's Console, onde você pode ver sua cota real e seu uso de cota.

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 de banner do canal enviada é de 2560 x 1440 pixels. O tamanho mínimo (2.048 px por 1.152 px) 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 com suporte. 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 termina e o chat ao vivo termina, 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 é 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á se encontra em outra playlist em série. Acesse a Central de Ajuda do YouTube para mais informações sobre playlists em série.
  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 especificou um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias disponíveis.
  badRequest (400)	invalidDescription	O método videos.update retorna esse erro para indicar que a propriedade snippet.description no recurso video enviado 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 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 especificou 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 ocorrerá 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, os usuários finais na União Europeia precisam obedecer à Política de consentimento de 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

A API agora oferece suporte à capacidade de definir e recuperar texto localizado para as propriedades snippet.title e snippet.description dos recursos playlist e video, as propriedades snippet.title do recurso channelSection e 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 está 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, você precisa 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 do aplicativo ou o 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:quando você atualiza os dados localizados de um recurso, sua solicitação de API precisa incluir todas as versões localizadas dos dados. Por exemplo, se você enviou um pedido subsequente para adicionar dados em português ao vídeo no exemplo acima, a solicitação precisaria incluir os dados localizados para alemão, espanhol e português.

• Como recuperar valores localizados

  A API oferece suporte a duas maneiras de recuperar valores localizados para um recurso:

  • Adicione o parâmetro hl à solicitação channels.list, channelSections.list, playlists.list ou videos.list para recuperar dados localizados de um idioma de aplicativo específico compatível com o site do YouTube. Se os detalhes do recurso localizados estiverem disponíveis nesse idioma, o objeto snippet.localized do recurso vai ter 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 conteria 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 do aplicativo com suporte do site do YouTube. Para determinar se o texto localizado está disponível para outros idiomas, é necessário 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 extrair um recurso, inclua localizations no valor do parâmetro part para extrair 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 oferecem suporte a esse erro.
  badRequest (400)	localizationValidationError	Esse erro indica que ocorreu uma falha ao validar um dos valores no objeto localizations de um recurso. Por exemplo, esse erro poderá 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 definido, os únicos outros parâmetros compatíveis sã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 mostrar estas informações:

    • Se você definir o valor dessa propriedade ao chamar o método videos.update, também deverá configurar o valor da propriedade status.privacyStatus como private, mesmo que o vídeo já seja privado.
    • Se a solicitação programar a publicação de um vídeo em algum momento no passado, ele será publicado imediatamente. Dessa forma, o efeito de definir a propriedade status.publishAt como uma data e hora no passado é 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 miniatura que você está enviando e associando a um vídeo. O corpo da solicitação não contém um recurso thumbnail. Anteriormente, 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 atualmente não inclui recursos relacionados a novos comentários do 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 Esta operação é proibida ou a solicitação não está devidamente autorizada.
    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 do video por pelo menos um ano após esse 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 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 é mais compatível com o parâmetro shareOnGooglePlus, que indicava se um comentário e as respostas a esse comentário também deveriam 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 conversas 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 confirmar o endereço de e-mail antes de avaliar o vídeo.
    videos.rate	Código de resposta HTTP badRequest (400) Motivo videoPurchaseRequired Descrição Vídeos alugados só podem ser avaliados por usuários que os alugaram.

  • Os métodos subscriptions.delete e subscriptions.insert não são mais compatíveis com os 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 de um vídeo ser sinalizado por incluir conteúdo abusivo. O método videoAbuseReportReasons.list permite que você recupere uma lista de todos os motivos pelos quais os vídeos podem ser sinalizados.

  • O novo método videos.reportAbuse é uma forma de sinalizar vídeos que apresentam 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 para denunciar um vídeo abusivo. Com essa alteração, a API v3 agora oferece suporte a todos os recursos da API da v2 para os quais está programado. 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 os vídeos enviados por meio do 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 funcionalidade semelhante, embora não idêntica, à funcionalidade das tags do desenvolvedor compatível com a API v2.

  • A nova propriedade snippet.country do recurso channel permite que os proprietários de canais 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 do canal é uma forma de restringir a visibilidade de uma seção de conteúdo aos 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 idiomas do aplicativo 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 onde 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 retornarão 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 retornarão 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 visualizador atual pode responder à linha de execução.
    badRequest (400)	invalidChannelId	O método search.list 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 retornará 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:

  • 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.
  • 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 em 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 também 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 sequência de comentários do YouTube, que compreende um comentário de nível superior e 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 é compatível com os seguintes métodos para recursos commentThread:

    • commentThreads.list: extrai uma lista de conversas de comentários. Use este 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 – Recuperar uma lista de comentários. Use esse método para recuperar todas as respostas a um comentário específico.
    • comments.insert – Cria uma resposta para um comentário existente.
    • 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, é obrigató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 é válido para qualquer método de API que oferecia suporte ao 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 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. Esses dois escopos são funcionalmente idênticos, porque o servidor da API do YouTube só está disponível por meio de um endpoint HTTPS. Como resultado, mesmo que 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 foram listados anteriormente e ainda estão 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 será compatível com o 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 corresponderá 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 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 que foram enviados recentemente aos canais nos quais o usuário da API se inscreve. 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 corresponderá 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 Protocolo de Atualização Simples (SUP) ou o PubSubHubbub para monitorar feeds de atividade dos usuários do YouTube. Notificações eram fornecidas para novas inscrições em canais e quando os vídeos eram avaliados, compartilhados, marcados como favoritos, comentados ou enviados.

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

  • 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 maneira consistente para essa finalidade.

  • Definir ou recuperar tags de desenvolvedor – A API v2 era compatível com o recurso de associação de palavras-chave, ou tags de desenvolvedor, a um vídeo no momento em que o vídeo foi enviado. As tags de desenvolvedor não são exibidas para os usuários do YouTube, mas os proprietários de vídeos podem recuperar os vídeos que correspondem a uma tag de desenvolvedor 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. Assim, cada uma dessas listas é classificada na ordem do item mais recente para o 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

    Observe, no entanto, que um novo item adicionado à playlist "Assistir mais tarde" é o último da lista, para que a lista seja 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 alterações, o guia agora identifica todas as funcionalidades suportadas na API antiga (v2) que terão seu uso suspenso na versão atual da API (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 aceitam o 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 de APIs.

• 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 retornará esse erro se o parâmetro id da solicitação especificar um canal não 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 de uma 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 vai retornar 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 retornará esse erro se o parâmetro channelId da solicitação especificar um canal não 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 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 resolve uma lacuna de recursos que existia anteriormente 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 YouTube Data (v3) também foi atualizado para indicar a descontinuação dos campos de feeds e metadados especiais fornecidos pela API v2 para descrever filmes, trailers, programas de televisão, temporadas e episódios de televisão.

14 de janeiro de 2015

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

• O guia de migração da API de dados do YouTube (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 é comparável à funcionalidade de upload com base no navegador compatível com a API v2. Essa alteração no guia de migração não reflete uma alteração real da API, mas sim a disponibilidade de um novo exemplo de código 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 do 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 ao canal GoogleDevelopers.

  • Custo da cota: 100 unidades

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

  • Custo de 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 "tempo 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 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, precisará definir um valor para ambas as 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 da Agência de Classificação de Filmes e Literatura da Nova Zelândia, agora é compatível com duas novas classificações: oflcRp13 e oflcRp16. Elas correspondem às classificações RP13 e RP16, respectivamente.

• O método channelBanners.insert agora é compatível com o seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	bannerAlbumFull	O álbum de arte do canal do YouTube do proprietário do canal 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 de cota de uma chamada para o método search.list mudou de uma para duas unidades, além do custo das partes dos recursos especificadas.

13 de agosto de 2014

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

• O método subscriptions.insert agora é compatível com o 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 é compatível com o 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 de 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.

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 deve especificar um valor para ambos os parâmetros para recuperar resultados com base no local, e a API retornará um erro se uma solicitação incluir somente 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 mostrar 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 do canal
  • subscriptions: canais em que o proprietário do canal se inscreveu

• 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 de consulta pode usar o operador booleano NOT (-) 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 que é 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 de propriedade nextPageToken e prevPageToken para determinar se os links de paginação serão exibidos.

• 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 para 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. O idioma do aplicativo também pode ser chamado de idioma 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 suporta um método para listar os idiomas de aplicativo compatíveis. Os idiomas compatíveis 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 apresentar os envios mais recentes de um canal, os envios mais populares 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 de canais do usuário autenticado especificando um ID de canal específico ou uma lista de IDs de seções de canais exclusivos.

  A documentação de erros também foi atualizada para descrever as mensagens de erro que a API suporta 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 ele 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. Esta propriedade só poderá ser definida se o status de privacidade do vídeo for private e se 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 tamanho máximo de caracteres permitido 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 retornará 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 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 retornará esse erro se a parte invideoPromotion especificar um número de itens promovidos acima do permitido.
  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 retornará esse erro se uma solicitação não especificar as configurações de tempo padrão para quando o YouTube deve exibir 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 retornará esse erro se os metadados da solicitação especificarem um horário de publicação programada 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 da política.

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 indicar 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, você pode definir um valor para um parâmetro de filtro ou para zero.

• 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. Anteriormente, o tamanho mínimo era de 2.120 px por 1.192 px. 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 televisão é de 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 outras 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 de 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 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) para filmes ou da Australian Communications and Media Authority (ACMA) para a programação de televisão infantil.

• As novas propriedades contentDetails.contentRating.catvRating e contentDetails.contentRating.catvfrRating identificam as classificações que um vídeo recebeu de acordo com o sistema de classificação de TV canadense e o sistema de classificação Régie du cinéma, em francês, que é usado no 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.

• Exemplos de código foram adicionados para os seguintes métodos:

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Ir)
  • 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 outros recursos projetados para ajudar a encontrar e apresentar 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 possíveis valores 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: o horário em que a transmissão 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: o horário 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 recuperar esses metadados, inclua liveStreamingDetails no valor do parâmetro part ao chamar os métodos 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 aos usuários que se inscreverem 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, o proprietário de um canal que envia muitos vídeos pode preferir definir o valor como False para evitar o envio de 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 por vários outros métodos.

• A propriedade contentDetails.contentRating.tvpgRating do recurso video agora aceita um valor de 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 por 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 será mostrado ao mostrar a promoção. Esse campo só pode ser definido se a solicitação de API que define o valor for 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 precisará ser revogado quando a RM decidir aceitar ou rejeitar o canal ou em até duas semanas após a data de emissão.

• A propriedade invideoPromotion.items[].id.type do recurso channel agora é compatível com o valor recentUpload, que indica que o item promovido é o vídeo enviado mais recentemente de um canal especificado.

  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 enviado mais recentemente de outro canal definindo o valor da nova propriedade invideoPromotion.items[].id.recentlyUploadedBy como o ID desse canal.

• O recurso channel contém três novas propriedades: brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl e brandingSettings.image.bannerTvHighImageUrl. Elas especificam os URLs das imagens de banner que aparecem 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, o valor upcoming indica que o vídeo é uma transmissão ao vivo que ainda não começou, enquanto o valor active indica que o vídeo é uma transmissão ao vivo em andamento.
  • Para um recurso channel, o valor upcoming indica que o canal tem uma transmissão programada que ainda não foi iniciada, enquanto o valor 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 filha que especifica o ID do canal do YouTube ao qual a imagem de marca d'água está vinculada, a propriedade targetChannelId agora especifica esse próprio valor. Portanto, a propriedade targetChannelId.value do recurso foi removida.

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

• O método search.list agora oferece suporte ao 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 Ministero dei Beni e delle Attivita Culturali e del 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 retornará esse erro se o conteúdo da imagem fornecida 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 de 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 erro descreve as mensagens de erro compatíveis com a API 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. Dessa forma, o valor da propriedade será false se a contagem de inscritos do canal for 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. Saiba como ativar links no seu conteúdo nas instruções da Central de Ajuda do YouTube sobre sites associados e sites de comerciantes.

    Ao adicionar links promocionais, você concorda que esses links não serão usados para redirecionar tráfego para sites não autorizados e que esses links obedecerão às políticas do Google AdWords, às políticas de anúncios do YouTube, às diretrizes da comunidade 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. Este objeto agora permite que você personalize os dados de tempo para cada item promovido na lista invideoPromotion.items[].

    • O novo objeto invideoPromotion.defaultTiming especifica as configurações de tempo padrão para sua promoção. Essas configurações definem quando um item promovido será exibido 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 por quanto tempo, em milissegundos, a promoção será exibida. 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. Os dois parâmetros já são aceitos por 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, autentique-se como um usuário do YouTube removendo o parâmetro onBehalfOfContentOwner ou atue 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 envios. 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 é compatível com novos parâmetros para recuperar um gráfico dos vídeos mais populares no YouTube:

  • O parâmetro chart identifica o gráfico que você quer recuperar. Atualmente, 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 que são relevantes para o vídeo ou seu 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, como fileDetails.recordingLocation.location.altitude.

• O objeto contentDetails.contentRating do recurso video especifica as classificações recebidas por um vídeo em vários esquemas, incluindo classificações da MPAA, TVPG e assim por diante. Para cada sistema de classificação, a API agora oferece suporte a um valor que indica que o vídeo não foi avaliado. Para as 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 conteúdo com restrição de idade. O valor da propriedade será ytAgeRestricted se o YouTube tiver identificado o vídeo como tendo conteúdo impróprio para usuários menores de 18 anos. Se a propriedade estiver ausente ou o valor dela estiver vazio, significa que o conteúdo não foi identificado como uma restrição 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 agora 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 a 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. 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 indicaria que essa outra conta foi 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 vai indicar que essa outra conta está suspensa.
  forbidden	authenticatedUserNotChannel	Esse erro não é específico a um método de API específico. Ela indica que o servidor da API não consegue identificar o canal associado à solicitação de 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. A conta do proprietário de conteúdo especificada não foi encontrada.
  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 o vídeo que você está tentando atualizar não pode ser encontrado. 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 recuperar informações sobre um canal especificando seu nome de usuário do 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 aos usuários autorizados que estiverem 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 compatível com os métodos channels.list e search.list, agora também é compatível com os 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 muitos canais diferentes do YouTube. O parâmetro permite que esses parceiros se autentiquem uma vez e tenham acesso a todos os dados de vídeo e de canal, sem precisar fornecer credenciais de autenticação para cada canal.

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

• O error documentation descreve os seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	insufficientCapabilities	Esse erro não é específico a 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á devidamente autorizada.

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

• O novo guia Trabalhar com IDs de canais explica como a API usa IDs de canais. 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 posteriormente como a imagem do 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. Ela 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 os exemplos de código Python agora inclui exemplos de como 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 oferecem suporte ao objeto inVideoPromotion, que encapsula informações sobre uma campanha promocional associada ao canal. Um canal pode usar uma campanha promocional em vídeo para exibir imagens em miniatura para um vídeo promovido no player de vídeo durante as reproduções 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 de uma campanha promocional em 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 os dados de snippets do canal do inscrito.

• A API agora oferece suporte ao método videos.getRating, que recupera as avaliaçõ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 recuperar uma lista de vídeos que o usuário autenticado classificou com like ou dislike.

  Os parâmetros myRating e id agora são considerados parâmetros de filtro. Isso 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 para 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 são compatíveis apenas com 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 fornecendo um token que pode ser usado para recuperar uma página específica do 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 instabilidade 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 a pessoa está inscrita.

• 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 substitui 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 é 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. O erro agora é relatado 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ê envie uma miniatura personalizada para o YouTube e a configure 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 configurações, texto e imagens para a página do canal e para as páginas de exibição de vídeos.

• 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 recebidas pelo vídeo 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 aceitos 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á	Sistema canadense de classificação de vídeos caseiros (CHVRS, na sigla em inglês)	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	Conselho Central de Certificação de Filmes (CBFC, na sigla em inglês)	contentDetails.contentRating.cbfcRating
    Japão	映倫管理委員分 (EIRIN)	contentDetails.contentRating.eirinRating
    Coreia	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    México	Direção 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 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.

  • O parâmetro order agora permite classificar os resultados em ordem alfabética 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 disponí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 é compatível com os 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 informar que o objeto só será retornado para um vídeo se os dados de geolocalização ou o tempo de gravação tiverem sido definidos.

• O método playlistItems.update agora retorna um erro invalidSnippet, que vai ser retornado se a solicitação de 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 televisão, gravadoras e outros criadores de conteúdo que disponibilizam seu 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 são de propriedade do proprietário do conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

25 de fevereiro de 2013

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

• A API é compatível com várias partes e propriedades novas para os recursos video:

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

    • 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 podem ser recuperadas somente 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, as taxas de bits do stream 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 as legendas estão 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 nos 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 em miniatura agora especifica a largura e a altura da imagem. No momento, as imagens em miniatura são retornadas nos recursos activity, channel, playlist, playlistItem, search result, subscription e video.

• O playlistItems.list agora 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 para vários métodos de API diferentes, bem como erros específicos do 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

• Um recurso activity agora pode informar uma ação channelItem, que ocorre quando o YouTube adiciona um vídeo a um canal gerado automaticamente. (O YouTube identifica algoritmicamente os tópicos que têm uma presença significativa no site do YouTube e gera canais automaticamente para esses tópicos.)

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

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

• O método search.list é compatível com os 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	Filtre os resultados da pesquisa de vídeo para incluir apenas vídeos que possam 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	Este 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 as 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 informará mais um erro playlistAlreadyExists se você tentar create ou atualizar uma playlist que tenha o mesmo título de uma playlist 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.