Histórico de revisões

Esta página lista as mudanças na API e as atualizações da documentação para a API YouTube Reporting e a API YouTube Analytics. As duas APIs permitem que os desenvolvedores acessem os dados do YouTube Analytics, mas de maneiras diferentes.

30 de outubro de 2026

A API YouTube Reporting agora é compatível com os seguintes relatórios gerenciados pelo sistema para proprietários de conteúdo:

Categoria Nome do relatório ID do tipo de relatório
Resumos financeiros Resumo mensal dos ajustes do canal content_owner_channel_adjustments_summary_a1
Resumos financeiros Receita mensal de transações de recursos pagos content_owner_transactions_paid_features_revenue_a1
Resumos financeiros Receita mensal de transações de TVOD por título e país tvod_content_owner_country_title_tvod_revenue_a1
Resumos financeiros Receita mensal de transações de TVOD por país tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Criações mensais de recursos dos Shorts da gravadora music_content_owner_shorts_asset_creations_a1
Shorts Visualizações mensais de recursos de Shorts da gravadora music_content_owner_shorts_asset_views_a1
Shorts Criações mensais de recursos dos Shorts da editora musical publisher_content_owner_shorts_asset_creations_a1
Shorts Visualizações mensais de recursos de Shorts da editora musical publisher_content_owner_shorts_asset_views_a1
Impostos Relatório mensal de resumo da restituição de imposto para afiliados de RMs content_owner_affiliate_tax_refund_summary_a1
Recursos Relatório semanal do SRMF publisher_content_owner_weekly_srmf
Recursos Relatório diário de status de solicitações de COA content_owner_oac_request_status_a1
Recursos Relatório diário de qualidade de pedidos de COA content_owner_oac_quality_status_a1

13 de setembro de 2026

A API YouTube Reporting agora é compatível com a versão 1.1 do relatório de referências semanais para proprietários de conteúdo (content_owner_active_references_a2).

A versão 1.1 apresenta as seguintes mudanças:

  • Adiciona o campo status_detail, que fornece mais detalhes ou o motivo do status do arquivo de referência.
  • Atualiza o campo asset_owners para usar nomes de exibição ou IDs externos do proprietário do conteúdo em vez de códigos de parceiro.

A versão anterior do relatório, Version 1.0 (content_owner_active_references_a1), continua disponível.

9 de setembro de 2026

A documentação da API YouTube Analytics e da API YouTube Reporting foi atualizada com as seguintes adições e esclarecimentos:

  • SLA de atualização de dados e latência: adicionamos uma seção dedicada ao modelo de dados explicando o atraso de 48 a 72 horas no tratamento de dados, o truncamento da data de término para o último dia totalmente processado e recomendando o método videos.list da API YouTube Data para estatísticas de vídeo em tempo real.

  • Métricas monetárias nos relatórios de canal: atualizamos a documentação de autorização dos relatórios de canal para esclarecer que as métricas de receita estimada e performance do anúncio são compatíveis com os relatórios de canal autorizados com o escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly quando o canal é membro do Programa de Parcerias do YouTube (YPP) e que os canais não monetizados retornam HTTP 403 Forbidden.

  • Restrições de consulta e compatibilidade de parâmetros: adicionamos uma nota informativa ao artigo Noções básicas sobre tabelas de relatórios esclarecendo que combinações inválidas ou mutuamente exclusivas de dimensões, métricas e filtros retornam o erro HTTP 400 badRequest ("The query is not supported.").

  • Valores de dimensão vazios em relatórios em massa: atualizamos as características do relatório da API YouTube Reporting para explicar que as colunas de dimensão, como video_id ou channel_id, contêm strings vazias para preservar as contagens de métricas agregadas de recursos excluídos e representar eventos no nível do canal.

27 de agosto de 2026

O YouTube vai alinhar a contagem de visualizações públicas para todos os formatos de vídeo: vídeos mais longos, transmissões ao vivo e Shorts. O YouTube vai contabilizar as visualizações públicas assim que o vídeo começar a ser reproduzido.

A qualificação para monetização e a maioria das principais métricas de performance não são afetadas, já que continuam ancoradas nas métricas de engajamento. Os ganhos dos criadores vão continuar baseados nas "Visualizações intencionais de Shorts" e nas "Horas intencionais de exibição", que podem ser conferidas no YouTube Analytics > Modo avançado.

A qualificação para o Programa de Parcerias do YouTube também não muda. Só atualizamos os nomes dos requisitos de entrada no programa: as "visualizações públicas válidas de Shorts" passam a se chamar "visualizações qualificadas de Shorts", e as "horas de exibição públicas válidas" agora se chamam "horas qualificadas de exibição".

Para saber mais, consulte Como funciona o desempenho do conteúdo no YouTube.

Métrica Status Gatilho Usado para
Ver Atualizado O vídeo é reproduzido a partir do primeiro frame (inclui reprodução automática, manter o ponteiro sobre o vídeo e clicar/tocar para reproduzir). Contagens de visualizações públicas padrão.
Visualização engajada Não alterado A reprodução continua após o primeiro frame ou o usuário clica/toca para reproduzir. Monetização pelo Programa de Parcerias do YouTube, a maioria das análises principais (taxa de cliques, duração média da visualização) e relatórios de engajamento.
Impressão de miniatura Não alterado A miniatura é exibida sem interação ou reprodução automática. Mede a exposição e o empacotamento no nível do feed.

Atualizações na documentação da API: atualizamos a definição da métrica engagedViews na documentação das métricas da API YouTube Analytics e das métricas da API YouTube Reporting.

25 de junho de 2026

A documentação da API YouTube Analytics (consultas segmentadas) foi atualizada para remover o relatório Atividade do usuário por cidade para proprietários de conteúdo. Este relatório não está disponível para proprietários de conteúdo. As consultas de proprietários de conteúdo sobre a atividade do usuário por cidade vão retornar resultados vazios.

9 de março de 2026

As dimensões ageGroup (API YouTube Analytics) e age_group (API YouTube Reporting) agora incluem usuários que o YouTube estima terem menos de 18 anos.

15 de janeiro de 2026

A API YouTube Reporting agora é compatível com relatórios de alcance para canais e proprietários de conteúdo. Os relatórios de alcance mostram estatísticas sobre as impressões e as taxas de cliques das miniaturas de vídeos.

  • Os relatórios channel_reach_basic_a1 e channel_reach_combined_a1 estão disponíveis para canais.
  • Os relatórios content_owner_reach_basic_a1 e content_owner_reach_combined_a1 estão disponíveis para proprietários de conteúdo.

Esses relatórios são compatíveis com as seguintes novas métricas:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 de setembro de 2025

A descontinuação de relatórios anunciada anteriormente foi adiada de 30 de setembro de 2025 para 31 de outubro de 2025. As versões anteriores dos relatórios atualizados para as mudanças na contagem de visualizações dos Shorts vão continuar disponíveis até lá, com exceção do relatório de reivindicações v1.0 (content_owner_active_claims_a1) e do relatório de reivindicações v1.1 (content_owner_active_claims_a2), que ainda serão descontinuados em 30 de setembro.

24 de junho de 2025

Conforme anunciado em 26 de março de 2025, a API de relatórios em massa será atualizada como parte da nova mudança na contagem de visualizações dos Shorts. As seguintes mudanças foram feitas:

  • Novas versões foram criadas para cada relatório que inclui visualizações, que é a maioria deles. A versão de cada relatório afetado foi incrementada em um, por exemplo, da versão a2 para a versão a3.
  • Para os Shorts, as visualizações agora vão contar quantas vezes um vídeo começa ou é repetido. Para vídeos, não há mudanças.
  • Os relatórios atualizados vão incluir uma nova coluna, engaged_views, que vai refletir a metodologia anterior de contagem de visualizações.

Essas mudanças entram em vigor em 30 de junho de 2025 para a API de relatórios em massa. Ajuste o processamento de relatórios de acordo com isso.

As versões anteriores dos relatórios vão ficar disponíveis até 30 de setembro de 2025. Depois de 30 de setembro de 2025, as versões anteriores serão descontinuadas. Migre para as versões mais recentes.

Por fim, siga as práticas recomendadas ao processar os relatórios para evitar que mudanças futuras neles interrompam seus pipelines de processamento.

As tabelas a seguir mostram as novas versões de cada tipo de relatório:

Relatórios de dados em massa para o YouTube Analytics

Relatórios de canais: relatórios de vídeos
Nome do relatório Versão anterior Versão mais recente
Atividade do usuário channel_basic_a2 channel_basic_a3
Atividade do usuário por província channel_province_a2 channel_province_a3
Locais de reprodução channel_playback_location_a2 channel_playback_location_a3
Origens de tráfego channel_traffic_source_a2 channel_traffic_source_a3
Tipo de dispositivo e sistema operacional channel_device_os_a2 channel_device_os_a3
Legendas channel_subtitles_a2 channel_subtitles_a3
Combinado channel_combined_a2 channel_combined_a3
Relatórios de canais: relatórios de playlists
Nome do relatório Versão anterior Versão mais recente
Atividade do usuário playlist_basic_a1 playlist_basic_a2
Atividade do usuário por província playlist_province_a1 playlist_province_a2
Locais de reprodução playlist_playback_location_a1 playlist_playback_location_a2
Origens de tráfego playlist_traffic_source_a1 playlist_traffic_source_a2
Tipo de dispositivo e sistema operacional playlist_device_os_a1 playlist_device_os_a2
Combinado playlist_combined_a1 playlist_combined_a2
Relatórios do proprietário do conteúdo: relatórios de vídeo
Nome do relatório Versão anterior Versão mais recente
Atividade do usuário content_owner_basic_a3 content_owner_basic_a4
Atividade do usuário por província content_owner_province_a2 content_owner_province_a3
Locais de reprodução content_owner_playback_location_a2 content_owner_playback_location_a3
Origens de tráfego content_owner_traffic_source_a2 content_owner_traffic_source_a3
Tipo de dispositivo e sistema operacional content_owner_device_os_a2 content_owner_device_os_a3
Legendas content_owner_subtitles_a2 content_owner_subtitles_a3
Combinado content_owner_combined_a2 content_owner_combined_a3
Relatórios do proprietário do conteúdo: relatórios de playlists
Nome do relatório Versão anterior Versão mais recente
Atividade do usuário content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Atividade do usuário por província content_owner_playlist_province_a1 content_owner_playlist_province_a2
Locais de reprodução content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Origens de tráfego content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Tipo de dispositivo e sistema operacional content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Combinado content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Relatórios do proprietário do conteúdo: relatórios de recursos
Nome do relatório Versão anterior Versão mais recente
Atividade do usuário content_owner_asset_basic_a2 content_owner_asset_basic_a3
Atividade do usuário por província content_owner_asset_province_a2 content_owner_asset_province_a3
Locais de reprodução do vídeo content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Origens de tráfego content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Tipo de dispositivo e sistema operacional content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Combinado content_owner_asset_combined_a2 content_owner_asset_combined_a3

Relatórios gerenciados pelo sistema: financeiros (não relacionados a música)

Relatórios do proprietário do conteúdo: Relatórios do YouTube Shorts (não relacionados a música)
Nome do relatório Versão anterior Versão mais recente
Resumo da receita de publicidade global content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Resumo diário da receita de publicidade content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Resumo da receita de publicidade por país content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Resumo da receita de publicidade content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Relatórios gerenciados pelo sistema: não financeiros

Relatórios do proprietário do conteúdo: relatórios de reivindicações
Nome do relatório Versão anterior Versão mais recente
Reivindicações ativas content_owner_active_claims_a2 content_owner_active_claims_a3
Relatórios de proprietários do conteúdo: relatórios de metadados de vídeo
Nome do relatório Versão anterior Versão mais recente
Metadados do vídeo content_owner_video_metadata_a3 content_owner_video_metadata_a4
Relatórios do proprietário do conteúdo: relatórios de recursos
Nome do relatório Versão anterior Versão mais recente
Recursos content_owner_asset_a2 content_owner_asset_a3
Conflitos de recurso content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 de abril de 2025

Como anunciado em 26 de março de 2025, a API de consultas segmentadas será atualizada como parte da nova mudança na contagem de visualizações dos Shorts:

  • Para os Shorts, as views agora vão contar quantas vezes um vídeo começa ou é repetido.
  • Uma nova métrica, engagedViews, vai refletir o método anterior de contagem de visualizações. engagedViews será disponibilizado em todos os relatórios junto com views.

Essas mudanças vão entrar em vigor em 30 de abril de 2025 para a API de consultas segmentadas. Ajuste suas consultas de acordo.

Confira este histórico de revisões para saber quais mudanças serão feitas na API de relatórios em massa e quando.

22 de abril de 2025

Conforme anunciado em 7 de abril de 2024, a dimensão isCurated foi descontinuada para relatórios de canais e de playlists de proprietários de conteúdo. A partir de 31 de dezembro de 2024, a dimensão não será mais aceita. A dimensão foi removida dos relatórios e da documentação.

26 de março de 2025

Esta atualização contém a seguinte mudança relacionada às APIs YouTube Analytics e Reporting:

A partir de 31 de março de 2025, o YouTube vai mudar a forma de contar as visualizações dos Shorts. No passado, uma visualização era contabilizada depois que o Shorts era exibido por alguns segundos. Agora, as visualizações vão contabilizar quantas vezes o Shorts começa a ser reproduzido ou reprisado, sem um tempo mínimo de exibição. Saiba mais

As APIs YouTube Analytics (consultas segmentadas) e YouTube Reporting (relatórios em massa) serão atualizadas com as seguintes mudanças:

  • Para os Shorts, as views contam o número de vezes que um vídeo começa ou é repetido.
  • Uma nova métrica, engagedViews, será disponibilizada e vai refletir a metodologia anterior de contagem de visualizações.
  • Se você tem um canal ou uma autorização para acessar os dados dele, poderá consultar as métricas atualizadas de visualizações e visualizações intencionais.

As consultas segmentadas serão atualizadas até 30 de abril, e os relatórios em massa, até 30 de junho. Até lá, as visualizações serão baseadas na metodologia antiga. As visualizações dos Shorts e do canal não vão corresponder ao Analytics no Studio.

Além disso, a descontinuação anunciada anteriormente do relatório de reivindicações diárias (versão 1.0) foi adiada.

Consulte este histórico de revisões para saber quando as mudanças são feitas nas APIs.

3 de março de 2025

Esta atualização contém a seguinte mudança relacionada à API YouTube Reporting:

Observação: este é um aviso de descontinuação.

O relatório Reivindicações diárias (versão 1.0) foi descontinuado para parceiros. Ele não será mais compatível a partir de 30 de abril de 2025. A definição desse relatório foi atualizada de acordo. Use o relatório de reivindicações diárias mais recente.

15 de novembro de 2024

Observação: a mudança a seguir entra em vigor em 18 de novembro de 2024.

A documentação da API YouTube Analytics (consultas segmentadas) foi atualizada para informar que, para relatórios de origem de tráfego, o método reports.query da API agora retorna um erro se o produto de nº de vídeos consultados X nº de dias no período exceder 50.000. Por exemplo, uma consulta que recupera dados de 500 IDs de vídeo pode solicitar dados de, no máximo, 100 dias.

Essa mudança afeta os relatórios de canais e proprietários de conteúdo.

Para reduzir o número de linhas que uma solicitação retorna, divida sua consulta em várias consultas que especifiquem menos vídeos ou definam períodos mais curtos. Como regra, os relatórios em massa são recomendados para grandes conjuntos de dados.

6 de maio de 2024

A API YouTube Analytics (consultas segmentadas) agora oferece suporte a três novos relatórios para canais:

Além disso, o relatório Retenção de público foi aprimorado para oferecer suporte a três novas métricas:

7 de abril de 2024

A API YouTube Analytics (consultas segmentadas) tem várias atualizações relacionadas aos relatórios de playlists do proprietário do conteúdo. As atualizações são as mesmas relacionadas aos relatórios de playlists do canal, que foram anunciadas em 19 de janeiro de 2024.

A entrada do histórico de revisões a seguir fornece quase as mesmas informações que a entrada de 19 de janeiro de 2024. No entanto, os relatórios de playlist do proprietário do conteúdo vão aceitar a dimensão isCurated até 31 de dezembro de 2024, enquanto a dimensão será aceita para relatórios de playlist do canal até 30 de junho de 2024.

  • Observação: este é um aviso de descontinuação.

    A dimensão isCurated foi descontinuada para relatórios de playlists do proprietário do conteúdo. Ele não será mais compatível a partir de 31 de dezembro de 2024. A definição dessa dimensão foi atualizada de acordo.

    Para preservar a compatibilidade com versões anteriores ao remover a dimensão isCurated, atualize também seu código para recuperar a métrica playlistViews em vez da métrica views apenas para relatórios de playlists. Como a métrica views ainda é compatível com relatórios de playlists, embora com um significado diferente, a API ainda vai retornar dados se você não atualizar o nome da métrica. É claro que você pode modificar o aplicativo para recuperar e exibir views e playlistViews.

    Além da dimensão isCurated, as seguintes funcionalidades da API não são mais compatíveis com os novos relatórios:

    • Os filtros de local, como continent e subcontinent, não são compatíveis com os novos relatórios de playlist do canal.
    • As métricas redViews e estimatedRedMinutesWatched não são mais compatíveis com os novos relatórios de playlists do canal. Essas métricas não estavam disponíveis no YouTube Studio, então essa mudança alinha a funcionalidade da API com a do aplicativo do Studio.
    • As dimensões subscribedStatus e youtubeProduct não são mais compatíveis como filtros para relatórios de playlists de canais. Esses filtros não estavam disponíveis no YouTube Studio, então essa mudança alinha a funcionalidade da API com a disponível no aplicativo do Studio.

  • A seção de relatórios de playlists da documentação de relatórios do proprietário do conteúdo foi atualizada para explicar melhor os tipos de métricas compatíveis com os relatórios de playlists:

    • As métricas de vídeo agregadas fornecem métricas de atividade do usuário e de impressões agregadas para todos os vídeos nas playlists do proprietário do conteúdo que também são de propriedade dele. As métricas de vídeo agregadas são compatíveis apenas com solicitações de API que não usam a dimensão isCurated.
    • As métricas na playlist refletem a atividade do usuário e o engajamento no contexto da página da playlist. Essas métricas incluem dados de visualizações de vídeos de terceiros na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
    • A seção métricas de playlist compatíveis identifica as métricas de vídeo agregadas e as métricas na playlist que são compatíveis com os relatórios de playlist.

  • As seguintes novas métricas na playlist são compatíveis com relatórios de playlists para proprietários de conteúdo. Essas métricas só serão compatíveis se a solicitação de API para recuperar os relatórios não usar a dimensão isCurated. Consulte a documentação de métricas para ver as definições de cada métrica:

  • O comportamento da métrica views agora depende se a solicitação de API que recuperou o relatório de playlist usou a dimensão isCurated:

    • Quando uma solicitação inclui a dimensão isCurated, a métrica views é uma métrica na playlist que indica o número de vezes que os vídeos foram assistidos no contexto das playlists do proprietário do conteúdo.
    • Quando uma solicitação não inclui a dimensão isCurated, a métrica views é uma métrica de vídeo agregada que especifica o número total de vezes que os vídeos nas playlists do proprietário do conteúdo foram assistidos, independentemente de essas visualizações terem ocorrido no contexto da playlist. O total agregado inclui apenas as visualizações de vídeos que pertencem ao proprietário do conteúdo associado ao canal que é dono da playlist.

      Nesses relatórios, que não usam a dimensão isCurated, a métrica playlistViews indica o número de vezes que os vídeos foram assistidos no contexto da playlist. Essa métrica conta as visualizações de todos os vídeos na playlist, independentemente do canal proprietário.

  • Para cada relatório de playlist, a documentação de relatórios do proprietário do conteúdo agora inclui tabelas que mostram as métricas compatíveis com esse relatório, dependendo se a solicitação de API inclui a dimensão isCurated. Consulte a seção que define relatórios de playlists baseados em tempo para ver um exemplo.

19 de janeiro de 2024

A API YouTube Analytics (consultas segmentadas) tem várias atualizações relacionadas aos relatórios de playlists de canais. As atualizações incluem uma dimensão descontinuada e várias métricas novas e atualizadas:

  • Observação: este é um aviso de descontinuação.

    A dimensão isCurated foi descontinuada para relatórios de canais. Ele não será mais compatível a partir de 30 de junho de 2024. A definição dessa dimensão foi atualizada de acordo.

    Para preservar a compatibilidade com versões anteriores ao remover a dimensão isCurated, atualize também seu código para recuperar a métrica playlistViews em vez da métrica views apenas para relatórios de playlists. Como a métrica views ainda é compatível com relatórios de playlists, embora com um significado diferente, a API ainda vai retornar dados se você não atualizar o nome da métrica. É claro que você pode modificar o aplicativo para recuperar e exibir views e playlistViews.

    Além da dimensão isCurated, as seguintes funcionalidades da API não são mais compatíveis com os novos relatórios:

    • Os filtros de local, como continent e subcontinent, não são compatíveis com os novos relatórios de playlist do canal.
    • As métricas redViews e estimatedRedMinutesWatched não são mais compatíveis com os novos relatórios de playlists do canal. Essas métricas não estavam disponíveis no YouTube Studio, então essa mudança alinha a funcionalidade da API com a do aplicativo do Studio.
    • As dimensões subscribedStatus e youtubeProduct não são mais compatíveis como filtros para relatórios de playlists de canais. Esses filtros não estavam disponíveis no YouTube Studio, então essa mudança alinha a funcionalidade da API com a disponível no aplicativo do Studio.

  • A seção de relatórios de playlists da documentação de relatórios de canais foi atualizada para explicar melhor os tipos de métricas compatíveis com os relatórios de playlists:

    • As métricas de vídeo agregadas fornecem métricas de atividade do usuário e de impressões agregadas para todos os vídeos nas playlists do canal que também são de propriedade desse canal. As métricas de vídeo agregadas são compatíveis apenas com solicitações de API que não usam a dimensão isCurated.
    • As métricas na playlist refletem a atividade do usuário e o engajamento no contexto da página da playlist. Essas métricas incluem dados de visualizações de vídeos de terceiros na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
    • A seção métricas de playlist compatíveis identifica as métricas de vídeo agregadas e as métricas na playlist que são compatíveis com os relatórios de playlist.

  • As seguintes novas métricas na playlist são compatíveis com os relatórios de playlists para canais. Essas métricas ainda não estão disponíveis para relatórios de proprietários de conteúdo. Essas métricas só serão compatíveis se a solicitação de API para recuperar os relatórios não usar a dimensão isCurated. Consulte a documentação de métricas para ver as definições de cada métrica:

  • O comportamento da métrica views agora depende se a solicitação de API que recuperou o relatório de playlist usou a dimensão isCurated:

    • Quando uma solicitação inclui a dimensão isCurated, a métrica views é uma métrica na playlist que indica o número de vezes que os vídeos foram visualizados no contexto das playlists do canal.
    • Quando uma solicitação não inclui a dimensão isCurated, a métrica views é uma métrica de vídeo agregada que especifica o número total de vezes que os vídeos nas playlists do canal foram assistidos, independentemente de essas visualizações terem ocorrido no contexto da playlist. O total agregado inclui apenas as visualizações de vídeos que pertencem ao canal proprietário da playlist.

      Nesses relatórios, que não usam a dimensão isCurated, a métrica playlistViews indica o número de vezes que os vídeos foram assistidos no contexto da playlist. Essa métrica conta as visualizações de todos os vídeos na playlist, independentemente do canal proprietário.

  • Para cada relatório de playlist, a documentação de relatórios de canal agora inclui tabelas que mostram as métricas compatíveis com esse relatório, dependendo de a solicitação de API incluir ou não a dimensão isCurated. Consulte a seção que define relatórios de playlists baseados em tempo para ver um exemplo.

4 de dezembro de 2023

A API YouTube Analytics (consultas segmentadas) foi atualizada para mesclar dois valores da dimensão insightTrafficSourceType. Antes, a dimensão diferenciava os vídeos reproduzidos como parte de uma playlist (PLAYLIST) e as visualizações originadas de uma página que lista todos os vídeos em uma playlist (YT_PLAYLIST_PAGE). No futuro, os dois tipos de visualizações serão associados ao valor da dimensão PLAYLIST.

15 de dezembro de 2022

A API YouTube Analytics (consultas segmentadas) agora é compatível com duas novas dimensões e um novo relatório:

  • Um novo relatório mostra a atividade do usuário por cidade. Esse relatório está disponível para canais e proprietários de conteúdo. Esse relatório contém a nova dimensão city, que identifica a estimativa do YouTube da cidade onde a atividade do usuário ocorreu.

  • A nova dimensão creatorContentType identifica o tipo de conteúdo do YouTube associado às métricas de atividade do usuário na linha de dados. Os valores compatíveis são LIVE_STREAM, SHORTS, STORY e VIDEO_ON_DEMAND.

    A dimensão creatorContentType é aceita como uma dimensão opcional para todos os relatórios de vídeo de canal e de proprietário do conteúdo.

  • O guia de exemplos de solicitações da API YouTube Analytics agora inclui exemplos para as duas novas dimensões.

  • As referências às dimensões 7DayTotals e 30DayTotals foram removidas da documentação. A descontinuação dessas dimensões foi anunciada em outubro de 2019.

26 de agosto de 2022

A API YouTube Analytics (consultas segmentadas) e a API YouTube Reporting (relatórios em massa) agora aceitam um novo valor de detalhe da origem de tráfego:

  • Na API YouTube Analytics (consultas segmentadas), se o valor da dimensão insightTrafficSourceType for SUBSCRIBER, o valor de insightTrafficSourceDetail poderá ser definido como podcasts, o que indica que o tráfego foi encaminhado da página de destino de podcasts.
  • Na API YouTube Reporting (relatórios em massa), se o valor da dimensão traffic_source_type for 3, o valor de traffic_source_detail poderá ser definido como podcasts, o que indica que o tráfego foi encaminhado da página de destino de podcasts.

11 de fevereiro de 2022

O conjunto de valores válidos para a dimensão gender vai mudar a partir de 11 de agosto de 2022. Essa pode ser uma mudança incompatível com versões anteriores na implementação da API. De acordo com a seção Mudanças Incompatíveis com Versões Anteriores dos serviços de APIs do YouTube, essa mudança está sendo anunciada seis meses antes de entrar em vigor. Atualize sua implementação da API antes de 11 de agosto de 2022 para garantir uma transição tranquila para o novo conjunto de valores.

As mudanças específicas são:

  • Na API YouTube Analytics (consultas segmentadas), a dimensão gender atualmente aceita dois valores: female e male. A partir de 11 de agosto de 2022, essa dimensão vai aceitar três valores: female, male e user_specified.
  • Na API YouTube Reporting (relatórios em massa), a dimensão gender atualmente aceita três valores: FEMALE, MALE e GENDER_OTHER. A partir de 11 de agosto de 2022, o conjunto de valores compatíveis vai mudar para FEMALE, MALE e USER_SPECIFIED.

9 de fevereiro de 2022

Duas métricas foram atualizadas para excluir o tráfego de clipes em loop a partir de 13 de dezembro de 2021. Essa mudança afeta as APIs YouTube Analytics (consultas segmentadas) e YouTube Reporting (relatórios em massa).

2 de fevereiro de 2022

A API YouTube Reporting (relatórios em massa) é compatível com um novo valor de dimensão da origem do tráfego que indica que as visualizações se originaram de redirecionamentos em tempo real:

  • Na API YouTube Reporting (relatórios em massa), a dimensão traffic_source_type é compatível com o valor 28.

Para esse tipo de origem de tráfego, a dimensão traffic_source_detail especifica o ID do canal de onde o espectador foi encaminhado.

23 de setembro de 2020

A API YouTube Analytics (consultas segmentadas) e a API YouTube Reporting (relatórios em massa) oferecem suporte a um novo valor de dimensão da origem do tráfego que indica que o espectador foi direcionado deslizando verticalmente na experiência de visualização do YouTube Shorts:

  • Na API YouTube Analytics (consultas segmentadas), a dimensão insightTrafficSourceType é compatível com o valor SHORTS.
  • Na API YouTube Reporting (relatórios em massa), a dimensão traffic_source_type é compatível com o valor 24.

A dimensão de detalhes da origem do tráfego (insightTrafficSourceDetail na API YouTube Analytics ou traffic_source_detail na API YouTube Reporting) não é preenchida para esse novo tipo de origem do tráfego.

20 de julho de 2020

Essa atualização abrange duas mudanças que afetam a API YouTube Analytics (consultas segmentadas):

  • O tamanho máximo de um grupo de relatórios do YouTube Analytics aumentou de 200 para 500 entidades.
  • O parâmetro filters do método reports.query identifica uma lista de filtros que devem ser aplicados ao recuperar dados do YouTube Analytics. O parâmetro permite especificar vários valores para os filtros video, playlist e channel, e o número máximo de IDs que podem ser especificados para esses filtros aumentou de 200 para 500.

13 de fevereiro de 2020

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (consultas segmentadas) e à API YouTube Reporting (relatórios em massa). Saiba mais sobre essas mudanças na Central de Ajuda do YouTube.

Em ambas as APIs, o conjunto de possíveis valores de detalhes da origem do tráfego para notificações está mudando. Em consultas segmentadas, as notificações são informadas como insightTrafficSourceType=NOTIFICATION. Nos relatórios em massa, as notificações são informadas como traffic_source_type=17.

Os novos valores dividem as notificações relacionadas a vídeos enviados e transmissões ao vivo, antes informadas como uploaded, em duas categorias:

  • uploaded_push: visualizações originadas de notificações push enviadas aos inscritos quando um vídeo foi enviado.
  • uploaded_other: visualizações originadas de notificações que não são push, como notificações por e-mail ou na caixa de entrada, enviadas aos inscritos quando um vídeo foi enviado.

Esses valores são retornados para o período que começa em 13/01/2020 (13 de janeiro de 2020).

Além disso, vale lembrar que esses valores não representam as notificações em si, mas sim as origens de tráfego que geraram determinadas visualizações do YouTube. Por exemplo, se uma linha do relatório indicar views=3, traffic_source_type=17 (NOTIFICATION) e traffic_source_detail=uploaded_push, isso significa que três visualizações foram geradas por espectadores que clicaram nas notificações push enviadas quando o vídeo foi enviado.

15 de outubro de 2019

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (consultas segmentadas):

  • Observação: este é um aviso de descontinuação.

    O YouTube está removendo o suporte às dimensões 7DayTotals e 30DayTotals. Você ainda pode recuperar dados usando essas dimensões até 15 de abril de 2020. A partir dessa data, as tentativas de recuperar relatórios usando a dimensão 7DayTotals ou 30DayTotals vão retornar um erro.

    Os usuários podem reproduzir alguns dos dados dessas dimensões fazendo consultas com a dimensão day e agregando ou derivando dados em períodos de 7 ou 30 dias. Exemplo:

    • O número de visualizações de um período de sete dias pode ser calculado agregando o número de visualizações de cada dia desse período.
    • O viewerPercentage para um período de sete dias pode ser calculado multiplicando o número de visualizações que ocorreram em cada dia pelo viewerPercentage desse dia para obter o número de espectadores que estavam conectados ao assistir o vídeo naquele dia. Em seguida, o número de espectadores conectados pode ser adicionado para todo o período e dividido pelo número total de visualizações desse período para receber o viewerPercentage de todo o período.
    • Não é possível calcular o número de espectadores únicos em um período de sete dias, porque o mesmo espectador pode ser contabilizado como único em dias diferentes. No entanto, é possível usar a dimensão month em vez de 30DayTotals para extrapolar dados sobre o número de espectadores únicos em um período de 30 dias. A dimensão month se refere aos meses do calendário, enquanto a dimensão 30DayTotals calcula períodos de 30 dias com base nas datas de início e término especificadas.

27 de junho de 2019

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (consultas segmentadas):

  • Como a versão 1 da API foi totalmente descontinuada, a documentação foi atualizada para remover as referências a ela, incluindo o aviso de descontinuação e o guia de migração que explica como atualizar para a versão 2.

1º de novembro de 2018

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (consultas segmentadas):

  • A versão 1 da API foi descontinuada. Se você ainda não fez isso, atualize seus clientes de API para usar a versão 2 da API o mais rápido possível para minimizar as interrupções de serviço. Para mais detalhes, consulte o guia de migração.

    A programação para essa descontinuação foi anunciada originalmente em 26 de abril de 2018.

17 de setembro de 2018

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (consultas segmentadas):

  • A nova seção de anonimização de dados no documento de visão geral do modelo de dados explica que algumas informações do YouTube Analytics são limitadas quando as métricas não atingem um determinado limite. Isso pode acontecer em vários casos. Na prática, isso significa que um relatório pode não conter todos (ou nenhum) dos seus dados se:

    1. um vídeo ou canal tem tráfego limitado durante um período especificado,

      ou

    2. você tiver selecionado um filtro ou uma dimensão, como origem de tráfego ou país, para os quais os valores não atingem determinado limite.

    A nova seção também inclui uma discussão sobre os tipos de dados que podem ser limitados nos relatórios do YouTube Analytics.

  • Os documentos de relatórios de canais e relatórios de proprietários de conteúdo foram atualizados para refletir o fato de que as métricas redViews e estimatedRedMinutesWatched não são mais compatíveis com os relatórios de local de reprodução, origem de tráfego e tipo de dispositivo/sistema operacional.

18 de junho de 2018

Esta atualização contém as seguintes mudanças na API YouTube Analytics (consultas segmentadas):

  • Os requisitos de escopo para os seguintes métodos foram alterados:
    • As solicitações para o método reports.query precisam ter acesso ao escopo https://www.googleapis.com/auth/youtube.readonly.
    • As solicitações para o método groupItems.list precisam ter acesso a:
      • o escopo https://www.googleapis.com/auth/youtube
        ou
      • o escopo https://www.googleapis.com/auth/youtube.readonly
        e
        o escopo https://www.googleapis.com/auth/yt-analytics.readonly

      A primeira opção usa um escopo, que é de leitura e gravação, enquanto a segunda usa dois escopos somente leitura.

23 de maio de 2018

Esta atualização contém as seguintes mudanças na API YouTube Analytics (consultas segmentadas):

22 de maio de 2018

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Reporting (relatórios em massa):

  • As mudanças a seguir estão programadas para entrar em vigor em julho de 2018, e as novas políticas serão aplicadas globalmente a todos os relatórios e jobs de relatórios.

    • Após a mudança, a maioria dos relatórios da API, incluindo os de preenchimento, vai ficar disponível por 60 dias a partir do momento em que forem gerados. No entanto, os relatórios com dados históricos ficam disponíveis por 30 dias a partir do momento em que são gerados.

      Antes desse aviso, todos os relatórios da API ficavam disponíveis por 180 dias a partir do momento em que eram gerados. Para deixar claro, quando essa mudança na política entrar em vigor, os relatórios de dados históricos com mais de 30 dias também não vão mais estar acessíveis pela API. Todos os outros relatórios com mais de 60 dias também não estarão mais acessíveis. Por isso, a documentação agora afirma que os relatórios criados antes da mudança na política vão ficar disponíveis por até 180 dias.

    • Após a mudança, quando você programar um job de relatório, o YouTube vai gerar relatórios a partir desse dia e cobrindo o período de 30 dias anterior ao momento em que o job foi programado. Antes da mudança, quando você programava um job de relatório, o YouTube gerava relatórios que cobriam o período de 180 dias anterior ao momento em que o job foi programado.

  • A seção de práticas recomendadas foi atualizada para lembrar que você pode usar a API YouTube Data para recuperar metadados adicionais de recursos identificados em relatórios. Conforme observado nas Políticas para desenvolvedores dos serviços de APIs do YouTube (seções III.E.4.b a III.E.4.d), os clientes da API precisam excluir ou atualizar os metadados de recursos armazenados dessa API após 30 dias.

  • A seção Características do relatório foi atualizada para indicar que, embora os dados do relatório não sejam filtrados, os relatórios que contêm dados de um período a partir de 1º de junho de 2018 não vão conter referências a recursos do YouTube que foram excluídos pelo menos 30 dias antes da data em que o relatório foi gerado.

  • A seção de dados históricos da visão geral da API foi atualizada para indicar que, quando você programa um novo job de relatório, os relatórios históricos geralmente são publicados em alguns dias. Anteriormente, a documentação afirmava que esses relatórios poderiam levar até 30 dias para serem disponibilizados.

  • A seção de dados de preenchimento da visão geral da API foi atualizada para definir mais claramente os dados de preenchimento como um conjunto de dados que substitui um conjunto entregue anteriormente.

26 de abril de 2018

A versão 2 da API YouTube Analytics (consultas segmentadas) já está disponível para o público. A lista a seguir identifica as mudanças no produto e na documentação relacionadas à nova versão da API:

  • A API v2 é quase idêntica à API v1. No entanto, é provável que você precise atualizar seu código para refletir as mudanças listadas abaixo. Todas essas mudanças são explicadas em detalhes no novo guia de migração.

    • A versão da API mudou de v1 para v2.
    • O URL de base para solicitações de API mudou de https://www.googleapis.com/youtube/analytics/v1 para https://youtubeanalytics.googleapis.com/v2.
    • Vários parâmetros do método reports.query foram renomeados. Especificamente, os nomes de parâmetros que contêm hifens, como end-date na API v1, usam letras concatenadas (endDate) em vez de hifens na API v2. Essa mudança torna os nomes de parâmetros consistentes em toda a API, já que os métodos de criação e gerenciamento de grupos já usavam letras concatenadas para nomes de parâmetros.
    • A API v2 não é compatível com solicitações em lote enviadas ao endpoint HTTP global do Google (www.googleapis.com/batch). Se você estiver enviando solicitações em lote na API v2, use o endpoint https://youtubeanalytics.googleapis.com/v2.

    Além disso, alguns recursos da v1 não são compatíveis com a API v2:

    • O método reports.query não é mais compatível com os parâmetros de solicitação alt, quotaUser e userIp.
    • A API v2 não oferece um endpoint de lote que aceite lotes compostos por solicitações para APIs diferentes. No entanto, um lote pode ser composto por solicitações para métodos diferentes da mesma API. Essa descontinuação não é específica da API YouTube Analytics, já que o Google está descontinuando o endpoint de lote global em todas as APIs.
    • A API v2 não é compatível com o protocolo JSON-RPC, que era compatível com a API v1. Essa descontinuação não é específica da API YouTube Analytics.

  • Observação: este é um aviso de descontinuação.

    A versão 1 da API (v1) foi descontinuada e terá suporte até 31 de outubro de 2018. Todas as solicitações para a API v1 vão parar de funcionar após essa data. Por isso, faça o upgrade para a API v2 até 31 de outubro de 2018 para evitar interrupções no acesso aos dados do YouTube Analytics pela API.

21 de fevereiro de 2018

Esta atualização contém as seguintes mudanças na API YouTube Analytics (consultas segmentadas):

  • Os relatórios demográficos de espectadores, que agregam estatísticas de visualização com base na faixa etária e no gênero dos espectadores, não são mais compatíveis com a dimensão youtubeProduct, que identifica o serviço do YouTube em que a atividade do usuário ocorreu.

18 de janeiro de 2018

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

  • API YouTube Reporting (relatórios em massa)

    • A dimensão operating_system, que identifica o sistema de software do dispositivo em que as visualizações ocorreram, agora aceita o seguinte valor:
      • 25: KaiOS

  • API YouTube Analytics (consultas segmentadas)

20 de dezembro de 2017

Esta atualização contém duas mudanças relacionadas à API YouTube Reporting:

  • O servidor de API agora é compatível com a compactação gzip para solicitações que fazem o download de relatórios. A compactação gzip não é compatível com outros tipos de solicitações de API. Ativar a compactação gzip reduz a largura de banda necessária para cada resposta da API. Embora o aplicativo precise de mais tempo de CPU para descompactar as respostas da API, o benefício de consumir menos recursos de rede geralmente compensa esse custo.

    Para receber uma resposta codificada em gzip, defina o cabeçalho da solicitação HTTP Accept-Encoding como gzip, conforme mostrado no exemplo a seguir:

    Accept-Encoding: gzip

    Essa funcionalidade é explicada na visão geral da API e na definição da propriedade downloadUrl do recurso report.

  • A documentação das dimensões age group e gender foi corrigida para mostrar os valores reais que a API retorna para essas dimensões. Essa é uma correção na documentação e não reflete uma mudança na funcionalidade ou no comportamento da API. Especificamente, os seguintes valores foram alterados:

    • Os valores da dimensão age_group usam letras maiúsculas, contêm sublinhados entre a palavra AGE e os números na faixa etária e usam sublinhados em vez de hifens. Por isso, valores como age13-17 e age18-24 foram corrigidos para AGE_13_17 e AGE_18_24, respectivamente.
    • Os valores da dimensão gender usam letras maiúsculas. Assim, os valores female, male e gender_other foram corrigidos para FEMALE, MALE e GENDER_OTHER.

10 de agosto de 2017

Em 10 de agosto de 2016, esta documentação anunciou a descontinuação da métrica earnings da API YouTube Analytics. Ao mesmo tempo, a API adicionou suporte a uma nova métrica, chamada estimatedRevenue, que fornece os mesmos dados.

Como a métrica earnings era uma métrica principal, ela foi mantida por um ano a partir da data do anúncio. Agora que esse período de um ano terminou, a métrica earnings não é mais compatível. Como resultado, as solicitações de API que especificam a métrica earnings agora retornam um código de resposta HTTP 400. Se você ainda não atualizou seu app para usar a métrica estimatedRevenue em vez de earnings, faça isso o mais rápido possível.

A documentação da API foi atualizada para remover as referências restantes à métrica earnings.

6 de julho de 2017

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

  • API YouTube Analytics (consultas segmentadas)

    • A documentação da API foi atualizada para refletir o fato de que as respostas da API contêm dados até o último dia do período solicitado em que todas as métricas consultadas estão disponíveis.

      Por exemplo, se uma solicitação especificar uma data de término de 5 de julho de 2017, e os valores de todas as métricas solicitadas estiverem disponíveis apenas até 3 de julho de 2017, essa será a última data em que os dados serão incluídos na resposta. Isso é verdade mesmo que os dados de algumas das métricas solicitadas estejam disponíveis para 4 de julho de 2017.

    • A dimensão adType agora é compatível com o valor reservedBumperInstream, que se refere a um anúncio em vídeo não pulável de até 6 segundos que é reproduzido antes do vídeo. O formato do anúncio é idêntico ao do anúncio auctionBumperInstream, mas esse tipo se refere a anúncios vendidos com base em reserva, e não em leilão.

  • API YouTube Reporting (relatórios em massa)

    • A dimensão ad_type agora aceita o valor 20, que se refere a anúncios bumper vendidos de forma reservada. Os anúncios bumper são anúncios em vídeo não puláveis de até 6 segundos que são mostrados antes do vídeo. O valor 19 dessa dimensão também se refere a anúncios bumper vendidos em um leilão, em vez de uma base reservada.

    • Os jobs de relatórios da API YouTube Reporting foram excluídos:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Esses tipos de relatório foram anunciados como descontinuados em 15 de setembro de 2016, e os relatórios deixaram de ser gerados para esses tipos de relatório após 15 de dezembro de 2016. Os relatórios gerados anteriormente ainda estavam disponíveis por 180 dias a partir do momento em que foram gerados. Portanto, alguns relatórios ficaram disponíveis até 15 de junho de 2017. No entanto, como os relatórios não estão mais disponíveis, os jobs associados a eles também não são necessários.

24 de maio de 2017

Todos os jobs de relatórios da API YouTube Reporting foram excluídos:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Esses tipos de relatório foram descontinuados em 22 de junho de 2016 e não são mais gerados desde 22 de setembro de 2016. Os relatórios gerados anteriormente ainda estavam disponíveis por 180 dias a partir do momento em que foram gerados. Por isso, alguns relatórios ficaram disponíveis até 22 de março de 2017. No entanto, como os relatórios não estão mais disponíveis, os jobs associados a eles também não são necessários.

22 de maio de 2017

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

  • API YouTube Reporting (relatórios em massa)

    • A dimensão sharing_service, que identifica o serviço usado para compartilhar vídeos, agora aceita os seguintes valores:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Além disso, o nome usado para identificar o valor 52 foi atualizado na documentação para Kakao (Kakao Talk) para diferenciá-lo mais claramente do valor 73 (Kakao Story). Essa mudança não reflete nenhuma alteração no comportamento da API ou na classificação dos vídeos compartilhados com esses serviços.

  • API YouTube Analytics (consultas segmentadas)

    • A dimensão sharingService agora aceita os seguintes valores:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 de março de 2017

Os proprietários de canais que podem acessar dados de receita pelo YouTube Analytics no Estúdio de Criação agora também podem acessar esses dados pela API YouTube Analytics:

17 de março de 2017

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

3 de março de 2017

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

  • API YouTube Reporting (relatórios em massa)

    • A definição da dimensão date foi corrigida para indicar que o valor da dimensão se refere ao período que começa à meia-noite (horário do Pacífico) e termina às 23h59 (horário do Pacífico) no dia, mês e ano especificados. Dependendo da época do ano, o horário do Pacífico é UTC-7 ou UTC-8.

      Embora as datas normalmente representem um período de 24 horas, as datas em que os relógios são adiantados representam um período de 23 horas, e as datas em que os relógios são atrasados representam um período de 25 horas. Anteriormente, a documentação afirmava que cada data representava um período único de 24 horas e que o horário do Pacífico era sempre UTC-8.

      Essa correção não representa uma mudança no comportamento real da API.

    • A dimensão operating_system, que identifica o sistema de software do dispositivo em que as visualizações ocorreram, agora aceita os seguintes valores:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Todos os jobs de relatório do tipo content_owner_basic_a1 foram excluídos. Esse tipo de relatório foi totalmente descontinuado em 19 de agosto de 2016, mas os relatórios content_owner_basic_a1 gerados anteriormente ainda ficaram disponíveis por 180 dias a partir do momento em que foram gerados. Por isso, alguns relatórios ficaram acessíveis até 19 de fevereiro de 2017. No entanto, como os relatórios não estão mais disponíveis, os jobs associados a eles também não são necessários.

  • API YouTube Analytics (consultas segmentadas)

    • A descrição das dimensões relacionadas a time periods foi corrigida para indicar que o valor da dimensão se refere ao período que começa às 00h horário do Pacífico e termina às 23h59 horário do Pacífico no dia, mês e ano especificados. Dependendo da época do ano, o horário do Pacífico é UTC-7 ou UTC-8.

      Embora as datas normalmente representem um período de 24 horas, as datas em que os relógios são adiantados representam um período de 23 horas, e as datas em que os relógios são atrasados representam um período de 25 horas. Anteriormente, a documentação afirmava que o horário do Pacífico era UTC-8 e não mencionava a possibilidade de um dia não representar um período de 24 horas.

      Essa correção não representa uma mudança no comportamento real da API.

    • A documentação dos relatórios de canais foi atualizada para indicar que eles não contêm métricas de ganhos ou de performance do anúncio. Por isso, o escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly não concede acesso a dados monetários em relatórios de canais.

    • A dimensão operatingSystem aceita três novos valores:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 de fevereiro de 2017

A API YouTube Analytics agora é compatível com o parâmetro opcional include-historical-channel-data. Esse parâmetro só é relevante ao recuperar relatórios do proprietário do conteúdo.

O parâmetro permite que um proprietário do conteúdo indique que uma resposta da API deve incluir o tempo de exibição e os dados de visualização dos canais do período anterior à vinculação deles ao proprietário do conteúdo. O valor padrão do parâmetro é false, o que significa que, por padrão, a resposta da API inclui apenas dados de tempo de exibição e visualizações do período em que os canais estavam vinculados ao proprietário do conteúdo.

Essas regras também se aplicam se a solicitação de API recuperar dados de vários canais:

  • Se o valor do parâmetro for false, os dados de tempo de exibição e visualizações retornados para qualquer canal serão baseados na data em que o canal foi vinculado ao proprietário do conteúdo.

    É importante lembrar que canais diferentes podem ter sido vinculados a um proprietário de conteúdo em datas diferentes. Se a solicitação de API estiver recuperando dados de vários canais e o valor de parâmetro for false, a resposta da API vai conter dados de tempo de exibição e visualizações com base na data de vinculação de cada canal.
  • Se o valor do parâmetro for true, a resposta vai retornar dados de tempo de exibição e visualizações de todos os canais com base nas datas de início e término especificadas na solicitação de API.

15 de dezembro de 2016

Os relatórios da API YouTube Reporting a seguir não são mais compatíveis e foram removidos da documentação. Uma versão mais recente de cada relatório está disponível. O comunicado sobre a descontinuação desses relatórios foi feito em 15 de setembro de 2016.

A lista de tipos de relatórios atuais na documentação de referência da API também foi atualizada.

11 de novembro de 2016

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

A API YouTube Reporting agora é compatível com três novos relatórios de tela final, além de novas dimensões e métricas para esses relatórios. Os relatórios fornecem estatísticas de impressões e cliques para as telas finais que aparecem depois que um vídeo para de ser reproduzido.

8 de novembro de 2016

Esta atualização contém as seguintes mudanças na API YouTube Analytics:

  • As métricas na lista a seguir foram totalmente descontinuadas e não são mais compatíveis. Conforme anunciado em 10 de agosto de 2016, as novas métricas que se referem aos mesmos dados já são compatíveis. A tabela abaixo mostra o nome da métrica descontinuada e o nome da nova métrica:

    Métrica descontinuada Nova métrica
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

27 de outubro de 2016

O YouTube agora gera automaticamente um conjunto de relatórios de receita de publicidade gerenciados pelo sistema para proprietários de conteúdo que têm acesso aos relatórios correspondentes na seção Relatórios do YouTube Studio. Os novos relatórios de API gerenciados pelo sistema foram criados para fornecer acesso programático aos dados que também estão disponíveis nos relatórios para download manual do YouTube Studio.

A visão geral dos relatórios gerenciados pelo sistema traz um breve resumo dos novos relatórios e explica o processo para recuperá-los usando a API. Esse processo é um pouco diferente da recuperação de relatórios em massa do YouTube Analytics, já que os parceiros não precisam programar jobs para gerar os relatórios.

A propriedade id do recurso reportType foi atualizada para incluir uma lista dos relatórios gerenciados pelo sistema que você pode acessar pela API:

  • Receita de publicidade mensal global por vídeo
  • Receita diária de anúncios por vídeo em cada país
  • Receita de publicidade mensal global por recurso
  • Receita de publicidade diária por país e por recurso
  • Reivindicações (este relatório não contém dados de receita)

27 de setembro de 2016

Observação: este é um aviso de descontinuação.

A métrica uniques da API YouTube Analytics foi descontinuada. Essa não é uma métrica principal e será aceita até 31 de outubro de 2016.

15 de setembro de 2016

Esta atualização contém as seguintes mudanças na API YouTube Reporting:

19 de agosto de 2016

Esta atualização contém a seguinte mudança na API YouTube Reporting:

  • O relatório content_owner_basic_a1 foi totalmente descontinuado e removido da documentação. O YouTube não vai mais gerar novos relatórios desse tipo, mas os que já foram gerados vão continuar disponíveis por 180 dias a partir da data de criação.

    O relatório content_owner_basic_a1 foi substituído pelo relatório content_owner_basic_a2, conforme explicado na entrada do histórico de revisões de 19 de maio de 2016.

11 de agosto de 2016

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

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

    O conjunto completo de novos documentos está descrito no histórico de revisões dos Termos Atualizados. Além disso, as mudanças futuras nos Termos Atualizados ou nos documentos de apoio também serão explicadas nesse histórico de revisões.

10 de agosto de 2016

Essa atualização inclui as seguintes alterações:

  • API YouTube Analytics (consultas segmentadas)

    • Observação: este é um aviso de descontinuação.

      As métricas na tabela a seguir estão sendo descontinuadas. Ao mesmo tempo, novas métricas referentes aos mesmos dados estão sendo introduzidas. Na verdade, isso significa que as métricas antigas estão sendo renomeadas, mas a API YouTube Analytics vai aceitar os dois nomes até as datas de descontinuação listadas na tabela.

      Nome da métrica antiga Nome da nova métrica Data de suporte
      earnings estimatedRevenue 10 de agosto de 2017
      adEarnings estimatedAdRevenue 4 de novembro de 2016
      redPartnerRevenue estimatedRedPartnerRevenue 4 de novembro de 2016
      impressionBasedCpm cpm 4 de novembro de 2016
      impressions adImpressions 4 de novembro de 2016

      A métrica earnings era uma métrica principal, então ela será compatível por um ano a partir da data deste anúncio. As outras métricas, que não eram principais, serão compatíveis por três meses, até 4 de novembro de 2016.

      Por exemplo, até 4 de novembro de 2016, uma solicitação de API pode especificar a métrica impressionBasedCpm, a métrica cpm ou ambas. No entanto, após essa data, apenas a métrica cpm será aceita.

    • A dimensão insightTrafficSourceType aceita dois novos valores:
      • CAMPAIGN_CARD: essa origem de tráfego só está disponível para relatórios do proprietário do conteúdo. Indica que as visualizações vieram de vídeos reivindicados e enviados por usuários que o proprietário do conteúdo usou para promover o conteúdo visualizado.
      • END_SCREEN: os dados se referem às visualizações que se originaram da tela final de outro vídeo.

      Para as duas novas origens de tráfego, também é possível recuperar um relatório traffic source detail. Nos dois casos, a dimensão insightTrafficSourceDetail identifica o vídeo de onde o espectador foi encaminhado.

    • A dimensão adType agora é compatível com o valor auctionBumperInstream, que se refere a um anúncio em vídeo não pulável de até 6 segundos que é reproduzido antes do vídeo.

  • API YouTube Reporting (relatórios em massa)

    • A dimensão traffic_source_type agora aceita os seguintes valores:
      • 19: essa origem de tráfego só está disponível para relatórios do proprietário do conteúdo. Indica que as visualizações vieram de vídeos reivindicados e enviados por usuários que o proprietário do conteúdo usou para promover o conteúdo visualizado.
      • 20: os dados se referem às visualizações que se originaram da tela final de outro vídeo.

      Para as duas novas origens de tráfego, a dimensão traffic_source_detail identifica o vídeo de onde o espectador foi encaminhado.

    • A lista de métricas principais da API foi corrigida para listar estimated_partner_revenue como uma métrica principal e remover earnings dessa lista. A métrica earnings nunca foi compatível com a API YouTube Reporting.

    • A dimensão ad_type agora é compatível com o valor 19, que se refere aos anúncios bumper, ou seja, anúncios em vídeo não puláveis de até 6 segundos que são mostrados antes do vídeo.

18 de julho de 2016

Essa atualização inclui as seguintes alterações:

  • API YouTube Analytics (consultas segmentadas)

    • As listas de métricas compatíveis com os seguintes relatórios de canal foram atualizadas para incluir métricas de card. A compatibilidade com as métricas de cards nesses relatórios foi adicionada em 28 de junho de 2016, e a entrada do histórico de revisões dessa data explica a mudança em mais detalhes. Os relatórios são:
      • Atividade do usuário básica para estados dos EUA
      • Atividade do usuário em estados nos EUA em períodos específicos
      • Atividade do usuário por província
      • Atividade do usuário por status de inscrição
      • Atividade do usuário por status de inscrição para províncias
      • Principais vídeos por estado
      • Vídeos mais assistidos por espectadores inscritos ou não inscritos

    • As listas de filtros foram corrigidas para os relatórios de retenção de público do canal e os relatórios de retenção de público do proprietário do conteúdo para refletir que o filtro video é obrigatório e o filtro group não é compatível.

      Antes, a documentação de ambos os relatórios afirmava incorretamente que o relatório poderia ser recuperado usando um desses dois filtros ou nenhum deles.

  • API YouTube Reporting (relatórios em massa)

    • Na visão geral da API, a seção que explica como recuperar o URL de download de um relatório foi corrigida para indicar que o YouTube gera relatórios para download nos dias em que não há dados disponíveis. Esses relatórios contêm uma linha de cabeçalho, mas não contêm dados adicionais. Essas informações já tinham sido atualizadas na seção Características do relatório do mesmo documento em 12 de abril de 2016.
    • A lista de dimensões no relatório content_owner_asset_cards_a1 foi corrigida para refletir que o relatório usa a dimensão card_id. Antes, a documentação listava incorretamente o nome da dimensão como card_title.

28 de junho de 2016

A documentação da API YouTube Analytics foi atualizada para refletir a compatibilidade com as métricas de cards em vários relatórios de canais e proprietários de conteúdo. As novas métricas compatíveis são:

As métricas são compatíveis com os seguintes tipos de relatórios:

22 de junho de 2016

Esta atualização contém as seguintes mudanças na API YouTube Reporting. A primeira mudança se refere à API em geral, e as outras afetam apenas os relatórios do proprietário do conteúdo:

  • A seção Características do relatório da visão geral da API foi atualizada para esclarecer que os relatórios ficam disponíveis pela API por 180 dias a partir do momento em que são gerados.

    Anteriormente, a documentação afirmava que os relatórios ficam disponíveis por um período de até 180 dias antes da data de envio da solicitação de API. Embora isso também seja tecnicamente verdade, o texto original era, na melhor das hipóteses, bastante confuso.

  • A API é compatível com novas versões de três relatórios. Dois desses relatórios também contêm métricas novas e renomeadas:

    • O relatório content_owner_ad_rates_a1 é a nova versão do relatório content_owner_ad_performance_a1. O relatório renomeado é idêntico à versão anterior.

    • Dois relatórios que têm novas versões foram renomeados:

      • A nova versão do relatório content_owner_estimated_earnings_a1 é chamada de content_owner_estimated_revenue_a1.
      • A nova versão do relatório content_owner_asset_estimated_earnings_a1 é chamada de content_owner_asset_estimated_revenue_a1.

      Os dois relatórios renomeados diferem dos anteriores das seguintes maneiras:

    Se você já tiver jobs para criar as versões mais antigas desses relatórios, será necessário criar novos jobs para os relatórios renomeados. Com o lançamento das novas versões, os relatórios content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 e content_owner_asset_estimated_earnings_a1 foram descontinuados.

    Se você tiver jobs para qualquer um desses relatórios, o YouTube não vai gerar novos relatórios para esses jobs após 22 de setembro de 2016. Os relatórios gerados ainda vão ficar disponíveis por 180 dias a partir do momento em que foram gerados.

  • A definição da propriedade id do recurso reportType foi atualizada para refletir o conjunto atual de relatórios disponíveis.

  • Os nomes de duas métricas foram corrigidos na documentação para corresponder aos nomes que aparecem nos relatórios. Essa é apenas uma correção na documentação e não reflete uma mudança no conteúdo real do relatório:

    • O nome da métrica estimated_partner_adsense_revenue foi atualizado para estimated_partner_ad_sense_revenue. No entanto, essa métrica aparece apenas em dois relatórios que estão sendo descontinuados com essa atualização. Como descrito acima, essa métrica foi renomeada como estimated_partner_ad_auction_revenue nas versões mais recentes desses relatórios.
    • O nome da métrica estimated_partner_doubleclick_revenue foi atualizado para estimated_partner_double_click_revenue. Essa métrica aparece apenas em dois relatórios que estão sendo descontinuados com essa atualização. Como descrito acima, essa métrica foi renomeada como estimated_partner_ad_reserved_revenue nas versões mais recentes desses relatórios.

  • A documentação de dimensões da API Reporting foi atualizada para não listar mais as propriedades elapsed_video_time_percentage e audience_retention_type. No momento, essas dimensões não são compatíveis com nenhum relatório disponível na API.

19 de maio de 2016

Esta atualização contém as seguintes mudanças na API YouTube Reporting:

  • A API é compatível com uma nova versão do relatório de atividade do usuário para proprietários de conteúdo. O ID do tipo de relatório para o novo relatório é content_owner_basic_a2. Ao contrário da versão anterior do relatório, content_owner_basic_a1, a nova versão é compatível com as métricas likes e dislikes.

    Se você já tiver um job para criar o relatório content_owner_basic_a1, ainda será necessário criar um novo job para o relatório content_owner_basic_a2. O YouTube não está migrando automaticamente os proprietários de conteúdo para a nova versão do relatório nem criando automaticamente um job para gerar a nova versão do relatório. Em algumas implementações, o surgimento de um job novo e inesperado pode ser uma alteração interruptiva.

    Com o lançamento do novo relatório, o content_owner_basic_a1 foi descontinuado. Se você tiver um job para esse relatório, o YouTube não vai gerar novos relatórios para ele após 19 de agosto de 2016. Os relatórios gerados ainda vão ficar disponíveis por 180 dias a partir do momento em que foram gerados.

  • Os recursos reportType, job e report são compatíveis com uma nova propriedade que identifica se o recurso associado representa um tipo de relatório descontinuado:

    • A propriedade deprecateTime do recurso reportType especifica a data e a hora em que o tipo de relatório será descontinuado. Essa propriedade só tem um valor para relatórios que foram anunciados como descontinuados, e o valor representa a data em que o YouTube vai parar de gerar relatórios desse tipo.

      Depois que um tipo de relatório é anunciado como descontinuado, o YouTube gera relatórios desse tipo por mais três meses. Por exemplo, esta atualização em 19 de maio de 2016 anuncia a descontinuação do relatório content_owner_basic_a1. Assim, o deprecateTime para esse tipo de relatório especifica um horário em 19 de agosto de 2016, após o qual o YouTube vai parar de gerar relatórios desse tipo.

    • A propriedade expireTime do recurso job especifica a data e a hora em que o job expirou ou vai expirar. Essa propriedade terá um valor se o tipo de relatório associado ao job tiver sido descontinuado ou se os relatórios gerados para o job não tiverem sido baixados por um período prolongado. A data marca o momento em que o YouTube deixa de gerar novos relatórios para o job.

    • A propriedade jobExpireTime do recurso report especifica a data e a hora em que o job associado ao relatório expirou ou vai expirar. Essa propriedade contém o mesmo valor que a propriedade expireTime no recurso job, conforme descrito no item anterior desta lista.

  • O método jobs.create agora retorna um código de resposta HTTP 400 (Bad Request) se você tentar criar um job para um relatório descontinuado. Além disso, a documentação do método agora lista vários outros motivos que causam falhas em uma solicitação de API.

12 de abril de 2016

Esta atualização contém as seguintes mudanças, que afetam apenas a API YouTube Reporting:

  • O YouTube agora gera dados que cobrem o período de 180 dias antes da primeira programação de um job de relatório. Antes, a API Reporting não fornecia dados históricos. Essa mudança afeta todos os jobs, incluindo os criados antes deste aviso.

    Os relatórios históricos são publicados assim que ficam disponíveis, mas leva cerca de um mês para que todos os dados históricos de um job sejam publicados. Portanto, um mês após programar um job de relatório, você terá acesso a cerca de sete meses de dados. Todos os dados históricos de jobs criados antes desse anúncio serão publicados em até um mês após o anúncio.

    Os dados históricos só estão disponíveis a partir de 1º de julho de 2015. Como resultado, os jobs criados antes de 28 de dezembro de 2015 terão menos de 180 dias de dados históricos.

    Todas essas mudanças são explicadas na nova seção de dados históricos da visão geral da API Reporting.

  • A seção características do relatório da visão geral da API YouTube Reporting foi atualizada com as seguintes mudanças:

    • A documentação agora informa que os relatórios ficam disponíveis por um período de 180 dias após serem gerados e, portanto, podem ser baixados pelos clientes da API. Anteriormente, a documentação afirmava que os relatórios estavam disponíveis por um período de até seis meses antes da data de envio da solicitação de API.

    • A documentação foi atualizada para refletir o fato de que a API agora gera relatórios para download para dias em que não havia dados disponíveis. Esses relatórios vão conter linhas de cabeçalho, mas não dados adicionais.

  • Em breve, a API YouTube Reporting vai oferecer suporte a um conjunto de relatórios gerados automaticamente e gerenciados pelo sistema que contêm dados de receita de publicidade ou de Receita de Assinaturas do YouTube Red. Os relatórios estarão disponíveis para os proprietários de conteúdo que já podem acessar os relatórios de receita para download manual no YouTube Studio. Assim, a nova funcionalidade da API vai fornecer acesso programático a esses dados.

    As seguintes mudanças na API estão sendo anunciadas agora em preparação para o lançamento dos relatórios gerenciados pelo sistema:

    • A nova propriedade systemManaged do recurso job indica se o recurso descreve um job que gera relatórios gerenciados pelo sistema. O YouTube gera automaticamente relatórios gerenciados pelo sistema para os proprietários de conteúdo, que não podem modificar nem excluir os jobs que criam esses relatórios.

    • O novo parâmetro includeSystemManaged do método jobs.list indica se a resposta da API deve incluir jobs para relatórios gerenciados pelo sistema. O valor padrão do parâmetro é false.

    • O novo parâmetro startTimeAtOrAfter do método jobs.reports.list indica que a resposta da API só deve conter relatórios se os dados mais antigos no relatório forem da data especificada ou posteriores a ela. Da mesma forma, o parâmetro startTimeBefore indica que a resposta da API só deve conter relatórios se os dados mais antigos no relatório forem anteriores à data especificada.

      Ao contrário do parâmetro createdAfter do método, que se refere ao momento em que o relatório foi criado, os novos parâmetros se referem aos dados no relatório.

    • A nova propriedade systemManaged do recurso reportType indica se o recurso descreve um relatório gerenciado pelo sistema.

    • O novo parâmetro includeSystemManaged do método reportTypes.list indica se a resposta da API deve incluir relatórios gerenciados pelo sistema. O valor padrão do parâmetro é false.

28 de março de 2016

As APIs YouTube Reporting e API YouTube Analytics agora retornam estatísticas de visualização para vários outros serviços de compartilhamento.

  • Na API YouTube Reporting, a dimensão sharing_service aceita estes novos valores:
    • 82: caixa de diálogo de atividade do sistema iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • Na API YouTube Analytics, a dimensão sharingService aceita estes novos valores:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: caixa de diálogo de atividade do sistema iOS

16 de março de 2016

Esta atualização contém as seguintes mudanças, que afetam as APIs YouTube Reporting e API YouTube Analytics:

API YouTube Reporting

  • A dimensão playback_location_type aceita dois novos valores:
    • 7: os dados se referem a visualizações que ocorreram na página inicial do YouTube ou na tela inicial, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube.
    • 8: os dados se referem às visualizações que ocorreram diretamente na página de resultados da pesquisa do YouTube.
  • A dimensão traffic_source_type agora aceita 18 como um valor de dimensão. Esse valor indica que as visualizações do vídeo se originaram de uma página que lista todos os vídeos de uma playlist. Essa origem é diferente do tipo 14, que indica que as visualizações ocorreram enquanto o vídeo era reproduzido como parte de uma playlist.

API YouTube Analytics

  • A dimensão insightPlaybackLocationType aceita dois novos valores:
    • BROWSE: os dados se referem a visualizações que ocorreram na página inicial do YouTube ou na tela inicial, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube.
    • SEARCH: os dados se referem às visualizações que ocorreram diretamente na página de resultados da pesquisa do YouTube.
  • A dimensão insightTrafficSourceType agora aceita YT_PLAYLIST_PAGE como um valor de dimensão. Esse valor indica que as visualizações do vídeo se originaram de uma página que lista todos os vídeos de uma playlist. Essa origem é diferente do tipo PLAYLIST, que indica que as visualizações ocorreram enquanto o vídeo era reproduzido como parte de uma playlist.

8 de fevereiro de 2016

A lista de métricas compatíveis com a API YouTube Analytics foi atualizada para que as métricas de cards não sejam mais listadas como compatíveis com essa API. Nenhum dos relatórios dessa API foi documentado como compatível com as métricas do card.

Ainda é possível recuperar as métricas de cards usando a API YouTube Reporting, que é compatível com essas métricas para vários relatórios de canal e de proprietário do conteúdo.

6 de janeiro de 2016

A API YouTube Reporting e a API YouTube Analytics agora identificam especificamente as visualizações que ocorrem em um dispositivo Chromecast.

  • Na API YouTube Reporting, a dimensão operating_system usa o valor 21 para identificar as visualizações que ocorrem pelo Chromecast.
  • Na API YouTube Analytics, a dimensão operatingSystem usa o valor CHROMECAST para identificar as visualizações que ocorrem pelo Chromecast.

21 de dezembro de 2015

Na documentação, os nomes das métricas annotation_clickable_impressions e annotation_closable_impressions foram atualizados para corresponder aos nomes retornados nos relatórios. Anteriormente, os nomes eram documentados como clickable_annotation_impressions e closable_annotation_impressions.

18 de dezembro de 2015

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

15 de dezembro de 2015

Esta atualização contém as seguintes mudanças, que afetam a API YouTube Analytics:

  • A API YouTube Analytics agora é compatível com três novas dimensões de detalhes de exibição, que podem ser usadas em vários relatórios de canais e de proprietários de conteúdo:

    • liveOrOnDemand: essa dimensão indica se os dados no relatório descrevem a atividade do usuário que ocorreu durante uma transmissão ao vivo.
    • subscribedStatus: essa dimensão indica se as métricas de atividade do usuário nos dados estão associadas a espectadores que se inscreveram no canal do vídeo ou da playlist.
    • youtubeProduct: essa dimensão identifica a propriedade do YouTube em que a atividade do usuário ocorreu. Os valores possíveis incluem o site principal do YouTube (ou o app YouTube), o YouTube Gaming e o YouTube Kids.

    A documentação foi atualizada para identificar novos relatórios detalhados de exibição disponíveis para canais e proprietários de conteúdo. Além disso, muitos outros relatórios foram atualizados para indicar que uma ou mais dessas dimensões podem ser usadas como dimensões e/ou filtros nesses relatórios.

  • O formato das tabelas que explicam os relatórios mudou para facilitar a identificação de combinações válidas de dimensões, métricas e filtros que podem ser usados para recuperar cada relatório. A tabela a seguir, que explica o relatório "Tipo de dispositivo" para canais, mostra o novo formato:

    Propriedade Valor
    Dimensões:
    Obrigatório deviceType
    Use 0 ou mais day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Métricas:
    Use 1 ou mais views, estimatedMinutesWatched
    Filtros:
    Use 0 ou 1. country, province, continent, subContinent
    Use 0 ou 1. vídeo, grupo
    Use 0 ou mais operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    A terminologia que descreve os campos obrigatórios e opcionais é explicada na documentação dos relatórios de canal e de proprietário do conteúdo.

  • A API YouTube Analytics agora descarta automaticamente as entidades para as quais o usuário da API não pode recuperar dados de filtros que aceitam vários valores (video, playlist e channel). Anteriormente, o servidor de API retornava um erro se o usuário da API não pudesse acessar dados de pelo menos um dos itens especificados.

    Por exemplo, suponha que um usuário envie uma solicitação de API em que o filtro video lista 20 IDs de vídeo. O usuário é proprietário de 18 vídeos. No entanto, um ID do vídeo identifica um vídeo que pertence a outro canal, e o outro ID do vídeo identifica um vídeo que foi excluído e, portanto, não existe mais. Nesse caso, em vez de retornar um erro, o servidor de API descarta os dois vídeos que o usuário não pode acessar, e a resposta da API contém dados dos 18 vídeos que pertencem ao usuário da API.

  • Se você solicitar dados de um group vazio do YouTube Analytics, a API vai retornar um conjunto de dados vazio em vez de um erro.

  • O método groupItems.insert da API YouTube Analytics agora retorna um erro não autorizado (código de resposta HTTP 403) se você tentar adicionar uma entidade a um grupo, mas não tiver acesso a ela. Antes, a API permitia adicionar a entidade ao grupo, mas depois retornava um erro de falta de autorização quando você tentava recuperar os dados do relatório desse grupo.

  • O método groups.list da API YouTube Analytics agora é compatível com paginação. Se a resposta da API não contiver todos os grupos disponíveis, o parâmetro nextPageToken da resposta vai especificar um token que pode ser usado para recuperar a próxima página de resultados. Defina o parâmetro pageToken do método como esse valor para recuperar mais resultados.

10 de novembro de 2015

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

29 de outubro de 2015

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

  • A documentação da dimensão date da API YouTube Reporting foi corrigida para refletir que as datas se referem ao período de 24 horas que começa às 12h, horário do Pacífico (UTC-8). Anteriormente, a documentação informava que a data começava às 12h (GMT).

    Além disso, a documentação da API YouTube Analytics foi atualizada para indicar que todas as dimensões relacionadas a datas (day, 7DayTotals, 30DayTotals e month) se referem a datas que começam às 0h, horário do Pacífico (UTC-8).

  • O método jobs.reports.list() da API YouTube Reporting agora é compatível com o parâmetro de consulta createdAfter. Se especificado, esse parâmetro indica que a resposta da API deve listar apenas os relatórios criados após a data e hora especificadas, incluindo novos relatórios com dados preenchidos. O valor de parâmetro se refere ao momento em que o relatório é criado, não às datas associadas aos dados retornados.

    O valor de parâmetro é um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de microssegundos. Exemplo: "2015-10-02T15:01:23.045678Z".

    As práticas recomendadas da API YouTube Reporting também foram atualizadas para explicar como usar o parâmetro createdAfter para evitar o processamento repetido do mesmo relatório.

  • As definições da propriedade createTime do recurso job e das propriedades startTime, endTime e createTime do recurso report foram corrigidas para indicar que os valores das propriedades são precisos em microssegundos, não em nanossegundos. Além disso, todas as definições agora refletem com precisão que o valor da propriedade é um carimbo de data/hora.

8 de outubro de 2015

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

  • A documentação da dimensão sharingService da API YouTube Analytics foi atualizada para incluir uma lista de possíveis valores de dimensão. A lista inclui vários serviços recém-compatíveis.

    A definição da dimensão sharing_service da API YouTube Reporting também foi atualizada para listar os novos valores compatíveis. Os valores de tipo enumerado maiores que 59 são os novos na lista.

24 de setembro de 2015

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

  • A nova API YouTube Reporting recupera relatórios de dados em massa que contêm dados do YouTube Analytics para um proprietário de conteúdo ou canal. Ele foi projetado para aplicativos que podem importar grandes conjuntos de dados e que fornecem ferramentas para filtrar, classificar e extrair esses dados.

    Cada relatório da API YouTube Reporting contém um conjunto predefinido de dimensões e métricas. Os relatórios da API YouTube Analytics também usam métricas e dimensões. Em um relatório, cada linha de dados tem uma combinação única de valores de dimensão. É possível agregar dados em linhas com base em valores de dimensão para calcular métricas de vídeos individuais, países, vídeos ao vivo, usuários inscritos etc.

    Você pode usar a API para programar jobs de relatórios, cada um identificando um relatório que o YouTube deve gerar. Depois que você configura um job, o YouTube gera um relatório diário que pode ser baixado de forma assíncrona. Cada relatório contém dados de um período único de 24 horas.

  • Embora sejam APIs diferentes, as APIs YouTube Analytics e YouTube Reporting permitem que os desenvolvedores recuperem dados do YouTube Analytics. Como as duas APIs fornecem acesso a conjuntos de dados semelhantes, a documentação delas está sendo publicada como um único conjunto de documentação.

    • A guia Guias no conjunto de documentação contém informações comuns às duas APIs, incluindo instruções para autorizar solicitações de API.
    • A guia Relatórios em massa contém documentação de referência e outros conteúdos específicos para a API YouTube Reporting.
    • A guia Consultas segmentadas contém documentação de referência e outros conteúdos específicos para a API YouTube Analytics.
    • A guia Descobertas lista exemplos de código disponíveis para as duas APIs.
    • A guia Ferramentas lista outros recursos disponíveis para ajudar os desenvolvedores a implementar uma das duas APIs.

20 de agosto de 2015

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

  • A documentação da API foi reestruturada para facilitar o entendimento. Portanto, essas mudanças não descrevem novos recursos:

    • Agora a documentação contém uma página que lista todos os relatórios de canal disponíveis e outra que lista todos os relatórios de proprietário do conteúdo disponíveis. Antes, a documentação tinha páginas separadas para relatórios de vídeos do canal, relatórios de playlists do canal etc.

    • A nova visão geral do modelo de dados busca fornecer uma introdução mais clara sobre como a API funciona. Especificamente, este documento tenta explicar melhor como o YouTube usa métricas, dimensões e filtros para calcular os valores dos relatórios.

    • O método reports.query da API, usado para recuperar relatórios, agora está documentado separadamente. As informações dessa página estavam em outras páginas. A nova página foi criada para ajudar você a identificar com mais facilidade as informações que precisa enviar para recuperar um relatório.

22 de julho de 2015

Essa atualização contém várias mudanças que se aplicam apenas aos proprietários de conteúdo:

  • A nova métrica adEarnings inclui o total de ganhos estimados (receita líquida) de todas as origens de publicidade vendidas pelo Google. Não é uma métrica principal. A API aceita a métrica adEarnings para qualquer relatório que já aceitava a métrica earnings.

    Além disso, a definição da métrica earnings foi corrigida para refletir o fato de que o valor dela inclui o total de ganhos estimados de todas as origens de publicidade vendidas pelo Google, bem como de origens não publicitárias. Antes, a definição indicava incorretamente que a métrica incluía apenas os ganhos de fontes de publicidade.

  • A métrica primaryAdGrossRevenue foi descontinuada. Em vez disso, use a métrica grossRevenue para recuperar dados de receita.

  • Além da métrica primaryAdGrossRevenue descontinuada, os relatórios de performance dos anúncios não são mais compatíveis com as métricas monetizedPlaybacks e playbackBasedCpm. No entanto, vários relatórios de vídeo ainda são compatíveis com essas métricas.

1º de junho de 2015

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

  • A API agora é compatível com duas novas métricas para relatórios de vídeo: videosAddedToPlaylists e videosRemovedFromPlaylists. As listas de relatórios de vídeo para canais e proprietários de conteúdo foram atualizadas para identificar os relatórios que aceitam as novas métricas.

    • videosAddedToPlaylists: o número de vezes que os vídeos no escopo da consulta foram adicionados a qualquer playlist do YouTube. Os vídeos podem ter sido adicionados à playlist do proprietário ou de outros canais.
    • videosRemovedFromPlaylists: o número de vezes que os vídeos no escopo da consulta foram removidos de qualquer playlist do YouTube. Os vídeos podem ter sido removidos da playlist do proprietário ou de outros canais.

    As duas métricas incluem playlists padrão, como "Assistir mais tarde". No entanto, elas não contam as playlists em que um vídeo é adicionado automaticamente, como a playlist de envios de um canal ou o histórico de exibição de um usuário. Além disso, essas métricas refletem o número absoluto de adições e exclusões. Portanto, se um usuário adicionar um vídeo a uma playlist, removê-lo e adicioná-lo novamente, as métricas vão indicar que o vídeo foi adicionado a duas playlists e removido de uma.

    Os dados dessas métricas estão disponíveis desde 1º de outubro de 2014.

31 de março de 2015

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

16 de março de 2015

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

  • O novo parâmetro currency permite recuperar métricas de ganhos em uma moeda diferente do dólar americano (USD). Se o parâmetro for definido, a API vai converter os valores das métricas earnings, grossRevenue, playbackBasedCpm e impressionBasedCpm para a moeda especificada. Os valores retornados são estimativas calculadas com base em taxas de câmbio que mudam diariamente.

    O valor do parâmetro é um código de moeda ISO 4217 de três letras. O valor padrão é USD. A definição do parâmetro contém uma lista de códigos de moeda aceitos.

25 de fevereiro de 2015

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

  • Agora, a API permite criar e gerenciar grupos do YouTube Analytics, além de recuperar dados de relatórios desses grupos.

    • Como criar e gerenciar grupos

      Esta atualização apresenta os recursos group e groupItem para criar e gerenciar grupos.

      • O recurso group representa um grupo do Analytics, uma coleção personalizada de até 200 canais, vídeos, playlists ou recursos. A API é compatível com os métodos list, insert, update e delete para esse recurso.
      • O recurso groupItem representa um item em um grupo do Analytics. A API é compatível com os métodos list, insert e delete para esse recurso.

      Por exemplo, é possível criar um grupo usando o método groups.insert e adicionar itens a ele usando o método groupItems.insert.

    • Como recuperar dados de relatórios de um grupo

      A documentação de dimensões foi atualizada para incluir a dimensão group, que pode ser usada como filtro para muitos relatórios de canal e relatórios de proprietário do conteúdo. Quando você usa o filtro group, a API retorna dados de todos os itens desse grupo. No momento, a API não permite criar relatórios para grupos de recursos.

    Acesse a Central de Ajuda do YouTube para mais informações sobre os grupos do YouTube Analytics.

13 de fevereiro de 2015

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

  • A API não é mais compatível com a dimensão show.

28 de agosto de 2014

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

  • A API agora permite especificar vários valores para as dimensões video, playlist, channel e show quando elas são usadas como filtros. Para especificar vários valores, defina o valor de parâmetro filters como uma lista separada por vírgulas dos IDs de vídeo, playlist, canal ou programa que serão usados para filtrar a resposta da API. O valor do parâmetro pode especificar até 200 IDs.

    Se você especificar vários valores para o mesmo filtro, também poderá adicionar esse filtro à lista de dimensões que especificar para a solicitação. Isso é válido mesmo que o filtro não esteja listado como uma dimensão compatível com um relatório específico. Se você adicionar o filtro à lista de dimensões, a API também vai usar os valores do filtro para agrupar os resultados.

    Consulte a definição do parâmetro filters para ver todos os detalhes sobre essa funcionalidade.

16 de julho de 2014

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

  • Ao recuperar um relatório de canal, agora é possível recuperar dados do canal do usuário autenticado definindo o valor do parâmetro ids como channel==MINE. Também é possível definir o parâmetro ids como channel==CHANNEL_ID para recuperar dados do canal especificado.

  • A API agora é compatível com relatórios de playlists, que contêm estatísticas relacionadas às visualizações de vídeos que ocorrem no contexto de uma playlist. Os relatórios de playlists estão disponíveis para canais e proprietários de conteúdo.

    Todos os relatórios de playlists são compatíveis com as métricas views e estimatedMinutesWatched, e alguns também são compatíveis com a métrica averageViewDuration.

    Além disso, todos os relatórios de playlists são compatíveis com as seguintes métricas novas. Cada uma dessas métricas reflete apenas as visualizações da playlist que ocorreram na Web.

    • playlistStarts: o número de vezes que os espectadores iniciaram uma playlist.
    • viewsPerPlaylistStart: o número médio de visualizações de vídeo que ocorreram sempre que uma playlist foi iniciada.
    • averageTimeInPlaylist: o tempo médio estimado, em minutos, que um espectador assistiu aos vídeos de uma playlist depois que ela foi iniciada.

    Qualquer solicitação para recuperar um relatório de playlist precisa usar o filtro isCurated, que precisa ser definido como 1 (isCurated==1).

  • A API agora oferece suporte a um relatório de retenção de público. Esse relatório mede a capacidade de um vídeo de reter o público. A nova dimensão elapsedVideoTimeRatio do relatório mede a quantidade de vídeo que foi reproduzida para os valores de métrica correspondentes:

    • A métrica audienceWatchRatio identifica a proporção absoluta de espectadores que assistem ao vídeo em um determinado momento. A proporção é calculada comparando o número de vezes que uma parte de um vídeo foi assistida com o número total de visualizações do vídeo.

      Uma parte do vídeo pode ser assistida mais de uma vez (ou nenhuma) em uma determinada visualização. Por exemplo, se os usuários voltarem e assistirem à mesma parte de um vídeo várias vezes, a proporção absoluta dessa parte poderá ser maior que 1.

    • A métrica relativeRetentionPerformance mostra como um vídeo retém os espectadores durante as visualizações em comparação com todos os vídeos do YouTube de duração semelhante. Um valor de 0 indica que o vídeo retém espectadores pior do que qualquer outro vídeo de duração semelhante, enquanto um valor de 1 indica que o vídeo retém espectadores melhor do que qualquer outro vídeo de duração semelhante. Um valor mediano de 0,5 indica que metade dos vídeos de duração semelhante retém melhor os espectadores, enquanto a outra metade retém pior.

    Você também pode usar o filtro audienceType para que o relatório retorne apenas dados associados a visualizações orgânicas, visualizações de anúncios TrueView in-stream ou visualizações de anúncios TrueView em display. As visualizações orgânicas são o resultado direto da ação do usuário, como uma pesquisa por um vídeo ou um clique em um vídeo sugerido.

  • A API é compatível com várias métricas novas relacionadas a anotações. As métricas listadas abaixo podem ser recuperadas com qualquer relatório que antes era compatível com as métricas annotationClickThroughRate e annotationCloseRate.

    Todas as novas métricas são principais e estão sujeitas à Política de descontinuação. No entanto, os dados estão disponíveis para as novas métricas a partir de 16 de julho de 2013. Os dados das métricas annotationClickThroughRate e annotationCloseRate estão disponíveis desde 10 de junho de 2012.

  • GOOGLE_SEARCH não é mais informado como um valor separado para a dimensão insightTrafficSourceType. Em vez disso, as indicações dos resultados da pesquisa do Google agora são atribuídas ao tipo de origem de tráfego EXT_URL. Como resultado, também não é mais possível recuperar um relatório insightTrafficSourceDetail que define o filtro insightTrafficSourceType como GOOGLE_SEARCH.

31 de janeiro de 2014

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

16 de janeiro de 2014

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

  • O documento de exemplos de solicitações foi reformulado para agrupar os exemplos em categorias, usando um formato de guia semelhante ao lançado recentemente para relatórios de canais e de proprietários de conteúdo. Com o novo design, os exemplos são agrupados nas seguintes categorias:

    • Estatísticas básicas
    • Por períodos
    • Geográfico
    • Local da visualização
    • Origem do tráfego
    • Dispositivo/SO
    • Informações demográficas
    • Social
    • Ganhos/anúncios (somente para relatórios de proprietário do conteúdo)

  • O documento de solicitações de amostra agora inclui novos exemplos para recuperar dados específicos de províncias em relatórios de canais ou de proprietários de conteúdo.

    • Métricas específicas de províncias para estados dos EUA e Washington D.C.: Esse relatório recupera uma análise detalhada por província das contagens de visualizações e outras estatísticas dos vídeos de um canal. Os dados abrangem os estados dos EUA e Washington D.C. O exemplo usa a dimensão province e o parâmetro filters para restringir a resposta e incluir apenas resultados para os Estados Unidos.

    • Informações demográficas dos espectadores na Califórnia (faixa etária e gênero): esse relatório recupera estatísticas sobre a faixa etária e o gênero dos espectadores na Califórnia que assistiram os vídeos de um canal ou, no caso de relatórios de proprietários de conteúdo, o conteúdo reivindicado por um proprietário. Este exemplo usa o parâmetro filters para garantir que a resposta inclua apenas dados de uma província específica.

  • A definição da dimensão province foi atualizada para indicar que, quando province é incluído no valor de parâmetro dimensions, a solicitação também precisa restringir os dados aos Estados Unidos incluindo country==US no valor de parâmetro filters.

6 de janeiro de 2014

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

  • Os documentos que listam os relatórios de canal e proprietário do conteúdo compatíveis foram reformulados. Em vez de fornecer uma tabela que lista todos os relatórios possíveis, cada documento agrupa os relatórios em categorias:

    • Estatísticas básicas
    • Por períodos
    • Geográfico
    • Local da visualização
    • Origem do tráfego
    • Dispositivo/SO
    • Informações demográficas
    • Social
    • Vídeos mais acessados

    Cada documento exibe essas categorias como uma lista de guias. Clique em qualquer guia para ver os relatórios compatíveis com essa categoria.

  • A API agora é compatível com três novas dimensões geográficas: province, continent e subContinent.

    • A dimensão province permite recuperar estatísticas dos estados dos EUA e do Distrito de Colúmbia. A API é compatível com dois usos para essa dimensão:

      • A API oferece suporte a dois relatórios que detalham as estatísticas por estado. Ambos os relatórios estão disponíveis para canais e proprietários do conteúdo.

        • O relatório de estatísticas principais fornece várias estatísticas, incluindo contagens de visualizações e minutos assistidos estimados.
        • O relatório baseado em tempo fornece as mesmas estatísticas, mas agrega dados diariamente, a cada 7 dias, a cada 30 dias ou mensalmente.

      • Use o parâmetro de consulta filters para restringir um relatório e incluir apenas estatísticas de um estado específico. Vários relatórios são compatíveis com esse tipo de filtragem, incluindo os relatórios geográficos, de local de reprodução, de origem de tráfego, de dispositivo, de sistema operacional, demográficos e de vídeos mais assistidos.

    • A dimensão continent especifica um código de região estatística das Nações Unidas (ONU) que identifica um continente. Essa dimensão só pode ser usada como filtro.

    • A dimensão subContinent especifica um código de região estatística das Nações Unidas (ONU) que identifica uma sub-região de um continente. Essa dimensão também só pode ser usada como filtro.

      Como cada sub-região está associada a apenas um continente, não é necessário usar o filtro continent quando você estiver usando o filtro subContinent. Na verdade, a API vai retornar um erro se uma solicitação usar as duas dimensões.

  • A documentação foi corrigida para que a dimensão insightTrafficSourceDetail não inclua o valor PROMOTED de insightTrafficSourceType como um valor de filtro válido.

30 de setembro de 2013

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

  • A API YouTube Analytics agora está sujeita à política de descontinuação descrita nos Termos de Serviço. No entanto, as dimensões e métricas não essenciais da API não estão sujeitas à política de descontinuação. As páginas de dimensões e métricas foram atualizadas para listar as dimensões e métricas principais. Além disso, as definições nessas páginas foram atualizadas para identificar explicitamente as dimensões e métricas principais.

  • A API agora aceita EXTERNAL_APP como um valor para a dimensão insightPlaybackLocationType. Em conjunto com essa atualização, desde 10 de setembro de 2013, as visualizações não são mais categorizadas como visualizações de MOBILE, embora as visualizações em dispositivos móveis que ocorreram antes dessa data ainda sejam categorizadas com esse valor.

    Com essa atualização, as exibições em dispositivos móveis agora são classificadas como WATCH, EMBEDDED ou EXTERNAL_APP, dependendo do tipo de aplicativo em que elas ocorrem.

  • A API agora aceita PLAYLIST como um valor para a dimensão insightTrafficSourceType. O valor indica que as visualizações do vídeo foram originadas de uma playlist. Antes, essas visualizações eram classificadas usando a categoria YT_OTHER_PAGE da dimensão.

16 de julho de 2013

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

  • Agora, a API suporta a capacidade de classificar os relatórios por vári dimensões e métricas. O exemplo de documento de solicitações contém um novo exemplo, Como classificar solicitações por várias dimensões/métricas, que demonstra essa funcionalidade. A solicitação recupera dados de origem de tráfego e tem um valor de parâmetro sort de day,-views. Os resultados são classificados cronologicamente, mas dentro do conjunto de resultados de cada dia, a primeira linha contém dados para a origem de tráfego que gerou o maior número de visualizações, a segunda linha contém dados para a origem que gerou o segundo maior número de visualizações e assim por diante.

  • A API agora é compatível com duas novas dimensões, deviceType e operatingSystem, que podem ser usadas para recuperar dados sobre os dispositivos em que os espectadores assistem seus vídeos. A API suporta relatórios que usam uma ou as duas dimensões.

    • O relatório deviceType permite recuperar contagens de visualizações e tempo de exibição estimado para diferentes tipos de dispositivos, incluindo computadores, smartphones e tablets. Também é possível usar o filtro operatingSystem para restringir o relatório de tipo de dispositivo para que ele contenha apenas estatísticas de dispositivos que executam um sistema operacional específico, como Android ou iOS.

    • O relatório operatingSystem permite recuperar contagens de visualizações e tempo de exibição estimado para diferentes sistemas operacionais, como Android, iOS, Linux e muito mais. Também é possível usar o filtro deviceType para restringir o relatório de sistemas operacionais e incluir apenas estatísticas de um tipo específico de dispositivo, como dispositivos móveis ou tablets.

    Os novos relatórios de tipo de dispositivo e de sistema operacional estão disponíveis para canais e proprietários do conteúdo.

  • O documento exemplo de solicitações foi atualizado para incluir três relatórios de dispositivo para canais e três para proprietários do conteúdo.

  • A dimensão insightPlaybackLocationType pode retornar o valor YT_OTHER, que identifica as visualizações que não são classificadas usando um dos outros valores da dimensão.

23 de maio de 2013

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

10 de maio de 2013

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

06 de maio de 2013

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

  • Agora a API permite recuperar métricas de tempo de exibição (estimatedMinutesWatched, averageViewDuration e averageViewPercentage) em conjunto com outras métricas, incluindo métricas de visualização, métricas de engajamento, métricas de ganhos e métricas de performance do anúncio.

    As listas de relatórios de canal e relatórios do proprietário do conteúdo disponíveis foram atualizadas para refletir essa mudança. Agora, as listas são, na verdade, menores, pois as métricas de tempo de exibição podem ser recuperadas como parte de outros relatórios relacionados.

    O documento Exemplo de solicitações de API também foi atualizado.

  • Os relatórios que usam as dimensões insightPlaybackLocationDetail e insightTrafficSourceDetail foram aprimorados das seguintes maneiras:

    • Agora eles aceitam um filtro country opcional.

    • Agora os proprietários de conteúdo podem recuperar esses relatórios usando qualquer uma das seguintes novas combinações de filter. Todas essas combinações também são compatíveis com o filtro opcional country.

      • Detalhes do local de reprodução

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • Detalhes da origem do tráfego

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

03 de maio de 2013

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

  • O novo documento Exemplos de solicitações de API mostra como recuperar vários tipos de relatórios usando a YouTube Analytics API. Cada exemplo inclui uma breve descrição do relatório que a solicitação recupera e, em seguida, mostra as dimensões, as métricas, os filtros e os parâmetros de classificação da solicitação.

  • A dimensão insightTrafficSourceType agora aceita SUBSCRIBER como um valor válido. Este valor identifica as exibições de vídeo que foram direcionadas de feeds da página inicial do YouTube ou de recursos de inscrição do YouTube. Se você filtrar com base nessa origem de tráfego, o campo insightTrafficSourceDetail vai especificar o feed da página inicial ou outra página de onde as visualizações foram encaminhadas.

28 de março de 2013

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

21 de março de 2013

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

  • Agora, a API suporta as métricas de ganhos e de desempenho de anúncios, além dos novos relatórios de desempenho de anúncios. As métricas e os relatórios são acessíveis apenas para parceiros de conteúdo do YouTube que participam do Programa de parceria do YouTube.

    • Os relatórios recém-suportados oferecem suporte a métricas de desempenho de anúncios baseados em reprodução e a métricas de desempenho de anúncios baseados em impressão. Consulte a documentação relatórios do proprietário do conteúdo para mais informações sobre os relatórios de desempenho de anúncios.

    • As métricas recém-suportadas estão listadas abaixo. A lista de relatórios do proprietário do conteúdo foi atualizada para identificar os relatórios, incluindo os dois novos, que suportam essas métricas.

      • earnings: total de ganhos estimados de todas as origens de publicidade vendidas pelo Google.
      • grossRevenue: receita bruta estimada de parceiros do Google ou do DoubleClick.
      • primaryAdGrossRevenue: receita bruta estimada, somada e classificada de acordo com o tipo de anúncio principal para as exibições de vídeo cobertas pelo relatório, de parceiros do Google ou do DoubleClick.
      • monetizedPlaybacks: o número de exibições que mostraram pelo menos uma impressão de anúncio.
      • playbackBasedCpm: receita bruta estimada por mil exibições.
      • impressions: o número de impressões de anúncio verificadas que foram veiculadas.
      • impressionBasedCpm: receita bruta estimada por mil impressões de anúncios.

      Observação: consulte as definições de métricas para detalhes completos.

    • Qualquer solicitação que recupere métricas de ganhos ou de performance do anúncio precisa enviar um token de autorização que conceda acesso usando o novo escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • A documentação da API foi reorganizada para que diferentes tipos de relatórios sejam explicados em páginas separadas. Como tal, agora, há páginas separadas que explicam os diferentes tipos de relatórios de canal e relatórios do proprietário do conteúdo.

04 de fevereiro de 2013

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

  • O guia de referência da API agora tem uma seção de exemplos, que inclui exemplos de código que demonstram como chamar a API usando as bibliotecas de cliente Java, JavaScript, Python e Ruby. O exemplo de código JavaScript é o mesmo discutido em detalhes na documentação do aplicativo de exemplo.

14 de novembro de 2012

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

  • O guia de referência da API agora conta com o APIs Explorer, que permite chamar a API, ver a solicitação de API e recuperar dados reais na resposta.

  • A API suporta uma série de novos relatórios para os canais e proprietários do conteúdo, descritos abaixo. Todos os relatórios estão disponíveis como um relatório de canal ou um relatório do proprietário do conteúdo. As páginas de dimensões e métricas também foram atualizadas.

    • O relatório de local de reprodução especifica o número de visualizações de vídeos que ocorreram em diferentes tipos de páginas ou aplicativos.

    • O relatório detalhado de local de reprodução identifica os players integrados que geraram o maior número de visualizações de um vídeo especificado. Ele fornece uma visualização mais refinada do que o relatório de local de reprodução identificando os URLs associados aos principais players integrados.

    • O relatório de origem de tráfego identifica o número de visualizações de vídeos provenientes de diferentes tipos de referenciadores.

    • O relatório detalhado de origem de tráfego identifica os referenciadores que geraram o maior número de visualizações para um vídeo especificado e um tipo de origem de tráfego especificado. Por exemplo, esse relatório pode mostrar os vídeos relacionados que enviaram mais tráfego para um vídeo específico. Esse relatório é suportado por várias origens de tráfego.

    • Os relatórios de tempo de exibição fornecem o tempo gasto por espectadores assistindo a seu conteúdo. Os relatórios podem agregar dados de um período específico (dia, últimos sete dias, últimos 30 dias etc.) ou país. Se um relatório agrega dados por dia ou país, ele também pode especificar a duração média de cada exibição de vídeo, além da porcentagem média de cada vídeo que os usuários assistiram.

02 de outubro de 2012

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

  • O YouTube Analytics API já está disponível para todos os desenvolvedores. É possível ativar a API para seu projeto, sem precisar solicitar acesso, no painel Serviços do APIs console.

  • A nova seção Primeiros passos descreve os pré-requisitos e as etapas básicas para criar um aplicativo que usa a YouTube Analytics API.

12 de setembro de 2012

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

  • A nova seção entender o uso da cota fornece diretrizes para a otimização de seu uso da cota de API. O servidor de API calcula um custo de consulta para cada solicitação, e esse custo é deduzido de sua cota de uso da API. Como diferentes tipos de relatórios podem ter vários custos de consulta, planeje o uso de sua cota de maneira eficiente, e seu aplicativo deve solicitar somente as métricas e os dados de que realmente precisa.

  • A seção dimensões temporais foi atualizada para explicar que essas dimensões indicam que um relatório do Google Analytics deve agregar dados com base em um período. Agora, a API suporta as seguintes dimensões temporais adicionais:

    • 7DayTotals: os dados no relatório serão agregados para que cada linha contenha dados de um período de sete dias.
    • 30DayTotals: os dados no relatório serão agregados para que cada linha contenha dados de um período de 30 dias.
    • month: os dados no relatório serão agregados por mês.

    Da mesma forma, a seção relatórios disponíveis foi atualizada para refletir o apoio da API para os relatórios que usam essas dimensões.

  • A seção dimensões da entidade de relatórios foi atualizada para indicar que as solicitações de API para recuperar relatórios do proprietário do conteúdo precisam filtrar os dados usando uma dessas dimensões (video, channel ou show) ou uma combinação aceita das dimensões claimedStatus e uploaderType.

  • Agora, a API suporta duas novas opções de classificação para os relatórios dos principais vídeos. Esses relatórios, que estão disponíveis como relatórios de canal ou relatórios do proprietário do conteúdo, contêm métricas (visualizações, comentários, gostei etc) por país e decompõem essas métricas por vídeo. Você pode classificar os relatórios com base no número de usuários que se inscreveram ou cancelaram a inscrição de um canal da página de exibição do vídeo.

  • As definições das métricas subscribersGained e subscribersLost foram atualizadas para explicar que um canal pode ganhar ou perder inscritos em vários lugares, incluindo a página de exibição do vídeo, a página do canal e o guia que aparece na página inicial do YouTube. Quando aparecem em um relatório específico do vídeo, essas métricas incluem apenas as estatísticas da página de exibição do vídeo especificado.