Histórico de revisões

Esta página lista as alterações de API e atualizações da documentação da API YouTube Reporting e da API YouTube Analytics. Ambas as APIs permitem que os desenvolvedores acessem os dados do YouTube Analytics, embora de maneiras diferentes. Inscreva-se nesse log de mudanças. Inscrever-se

6 de maio de 2024

A API (Consultas segmentadas) do YouTube Analytics é compatível com três novos relatórios para canais:

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

7 de abril de 2024

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

A seguinte entrada do histórico de revisões fornece quase as mesmas informações da entrada de 19 de janeiro de 2024. No entanto, o proprietário do conteúdo os relatórios de playlists são compatíveis com isCurated dimensão até 31 de dezembro de 2024, embora a dimensão seja compatível com os relatórios de playlists de canais até 30 de junho de 2024.

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

    O isCurated A dimensão foi suspensa para relatórios de playlist do proprietário do conteúdo. Ele não será mais a partir de 31 de dezembro de 2024. A definição dessa dimensão foi atualizada de maneira adequada.

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

    Além da dimensão isCurated, a seguinte funcionalidade da API é não são mais compatíveis com os novos relatórios:

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

  • Relatórios de playlists da documentação de denúncias do proprietário do conteúdo foi atualizada para explicar os tipos de métricas com suporte para relatórios de playlists:

    • Métricas de vídeo agregadas oferecem atividades do usuário e métricas de impressão agregadas para todos os vídeos na as playlists do proprietário do conteúdo que também pertencem a ele. As métricas de vídeo agregadas são suportado apenas para solicitações de API que não usam a dimensão isCurated.
    • Métricas na playlist reflitam a atividade e o envolvimento do usuário no contexto da página da playlist. Essas métricas incluir dados também incluirá visualizações de vídeos que não são de sua propriedade na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
    • As métricas das playlists compatíveis identifica as métricas de vídeo agregadas e as métricas na playlist que estão suportado para relatórios de playlist.

  • As seguintes novas métricas na playlist são compatíveis com os relatórios de playlist para proprietários de conteúdo. Essas métricas são suportadas somente se a solicitação de API para recuperar os relatórios não usam a dimensão isCurated. Consulte a documentação de métricas para de cada métrica:

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

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

      Nesses relatórios, que não usam a dimensão isCurated, o valor-chave A métrica playlistViews indica o número de vezes que os vídeos foram visualizados no contexto da playlist. Essa métrica contabiliza as visualizações para todos os vídeos da playlist, seja qual for o canal.

  • Para cada relatório de playlist, o relatórios do proprietário do conteúdo documentação agora inclui tabelas que mostram as métricas com suporte para 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 com base no tempo como exemplo.

19 de janeiro de 2024

A API (Targeted Querys) do YouTube Analytics tem diversas atualizações relacionadas à playlist do canal. e detecção de ameaças. As atualizações incluem uma dimensão descontinuada e várias métricas novas e atualizadas:

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

    O isCurated foi suspensa para relatórios de canais. Ele não terá mais suporte no após 30 de junho de 2024. A definição dessa dimensão foi atualizada.

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

    Além da dimensão isCurated, a seguinte funcionalidade da API é não são mais compatíveis com os novos relatórios:

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

  • Relatórios de playlists da documentação de relatórios de canal foi atualizada para explicar mais detalhadamente os tipos de métricas com suporte para relatórios de playlists:

    • Métricas de vídeo agregadas oferecem atividades do usuário e métricas de impressão agregadas para todos os vídeos na playlists do canal que também pertencem a ele. As métricas de vídeo agregadas são suportado apenas para solicitações de API que não usam a dimensão isCurated.
    • Métricas na playlist reflitam a atividade e o envolvimento do usuário no contexto da página da playlist. Essas métricas incluir dados também incluirá visualizações de vídeos que não são de sua propriedade na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
    • As métricas das playlists compatíveis identifica as métricas de vídeo agregadas e as métricas na playlist que estão suportado para relatórios de playlist.

  • As seguintes novas métricas na playlist são compatíveis com os relatórios de playlist para canais. Essas métricas ainda não são suportadas para relatórios do proprietário do conteúdo. Essas métricas são suportado somente se a solicitação de API para recuperar os relatórios não usar o isCurated. Consulte a documentação de métricas para de cada métrica:

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

    • Quando uma solicitação inclui a dimensão isCurated, a A métrica views está em uma playlist métrica que indica o número de vezes que os vídeos foram assistidos no contexto do listas de reprodução do canal.
    • Quando uma solicitação não inclui a dimensão isCurated, o views é uma métrica de vídeo agregada que especifica o número total o número de vezes que o vídeo nas playlists do canal foi visualizado, não importa se essas de visualizações de vídeo aconteceram no contexto de playlist. O total agregado inclui apenas as visualizações do vídeos que pertencem ao canal que é proprietário da playlist.

      Nesses relatórios, que não usam a dimensão isCurated, o valor-chave A métrica playlistViews indica o número de vezes que os vídeos foram visualizados no contexto da playlist. Essa métrica contabiliza as visualizações para todos os vídeos da playlist, seja qual for o canal.

  • Para cada relatório de playlist, os relatórios de canal documentação agora inclui tabelas que mostram as métricas com suporte para 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 com base no tempo como exemplo.

04 de dezembro de 2023

A API (Targeted Querys) do YouTube Analytics foi atualizada para mesclar dois insightTrafficSourceType valores de dimensão. Antes, a dimensão diferenciava os vídeos reproduzidos como parte de uma playlist. (PLAYLIST) e visualizações originadas de uma página que lista todos os vídeos de uma playlist YT_PLAYLIST_PAGE). Daqui para frente, ambos os tipos de visualização serão associados ao Valor de dimensão PLAYLIST.

15 de dezembro de 2022

A API (Consultas segmentadas) do YouTube Analytics é 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 channels e proprietários do conteúdo. Este relatório contém as novas city , que identifica a estimativa do YouTube da cidade onde a atividade do usuário ocorreu.

  • O novo creatorContentType identifica o tipo de conteúdo do YouTube associado à atividade do usuário na linha de dados. Os valores aceitos são LIVE_STREAM, SHORTS, STORY e VIDEO_ON_DEMAND.

    A dimensão creatorContentType é aceita como uma dimensão opcional para todos relatórios de vídeo do canal e do 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 removido da documentação. A descontinuação dessas dimensões foi anunciada em outubro de 2019.

26 de agosto de 2022

A API de consultas segmentadas do YouTube Analytics e a API de relatórios em massa do YouTube dão suporte a um novo valor de detalhe da origem do tráfego:

  • Na API (Consultas segmentadas) da API YouTube Analytics, se o insightTrafficSourceType se o valor da dimensão for SUBSCRIBER, insightTrafficSourceDetail O valor pode ser definido como podcasts, que indica que o tráfego foi encaminhado do Página de destino de podcasts.
  • Na API YouTube Reporting (Bulk Reports), se o traffic_source_type se o valor da dimensão for 3, Valor de traffic_source_detail pode ser definido como podcasts, o que indica que o tráfego foi encaminhado do 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 agosto de 2022. Essa pode ser uma alteração incompatível com versões anteriores na sua implementação da API. De acordo com as Retroceder na seção "Mudanças incompatíveis" dos Termos de Serviço das APIs do YouTube. Essa mudança é serão anunciados seis meses antes de entrarem em vigor. Atualize a implementação da sua API antes de 11 de agosto de 2022, para garantir uma transição tranquila para o novo conjunto de valores.

Estas são as mudanças específicas que estão sendo feitas:

  • Na API (consultas segmentadas) do YouTube Analytics, a No momento, gender dimensão oferece suporte a dois valores: female e male. A partir de 11 de agosto de 2022, suporta três valores: female, male e user_specified
  • Na API YouTube Reporting (Bulk Reports), a No momento, gender dimensão oferece suporte a 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 alteração afeta a API (consultas segmentadas) do YouTube Analytics e a API YouTube Reporting (Bulk Reports).

2 de fevereiro de 2022

Essa API YouTube Reporting (Bulk Reports) é compatível com um novo valor de dimensão de origem do tráfego que indica que as visualizações vieram de Redirecionamentos em tempo real:

Para este tipo de origem de tráfego, a traffic_source_detail especifica o ID do canal a partir do qual o espectador foi indicado.

23 de setembro de 2020

Essa API do YouTube Analytics (Targeted custo) e a API YouTube Reporting (Bulk Reports) oferecem suporte a um novo valor da dimensão de origem do tráfego que indica que o espectador foi indicado pelo deslizando verticalmente na experiência de visualização do YouTube Shorts:

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 é preenchido para esse novo tipo de origem de tráfego.

20 de julho de 2020

Esta atualização abrange duas alterações que afetam a API (consultas segmentadas) do YouTube Analytics:

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

13 de fevereiro de 2020

Esta atualização contém as seguintes mudanças relacionadas às consultas segmentadas do YouTube Analytics e a API YouTube Reporting (Bulk Reports). Saiba mais sobre essas mudanças na Central de Ajuda do YouTube.

Nas duas APIs, o conjunto de possíveis valores de detalhes da origem do tráfego para notificações vai mudar. Em consultas segmentadas, as notificações são registradas como insightTrafficSourceType=NOTIFICATION. Em relatórios em massa, as notificações são registradas como traffic_source_type=17.

Antes, os novos valores se dividem nas notificações relacionadas a vídeos e transmissões ao vivo enviados. relatadas como uploaded, em duas categorias:

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

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

Além disso, esses valores não representam as notificações em si, mas o tráfego fontes que geraram determinadas visualizações do YouTube. Por exemplo, se a linha de um relatório indicar views=3, traffic_source_type=17 (NOTIFICATION) e traffic_source_detail=uploaded_push, a linha indica que três visualizações resultantes dos cliques dos espectadores nas notificações push enviadas quando o vídeo foi publicado.

15 de outubro de 2019

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

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

    O YouTube vai remover o suporte para as dimensões 7DayTotals e 30DayTotals. Você ainda pode recuperar dados usando essas dimensões até 15 de abril de 2020. Nessa data ou após, 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 consultando usando a dimensão day e agregando ou derivando dados em períodos de 7 ou 30 dias. Exemplo:

    • Para calcular o número de visualizações de um período de sete dias, agregamos o número de visualizações de cada dia desse período.
    • A percentagem de espectadores de um período de sete dias pode ser calculada multiplicando-se o número de visualizações que ocorreram em cada dia pelo número de visualizadores daquele dia para obter o número de espectadores que fizeram login ao assistir ao vídeo naquele dia. Então, o número de espectadores conectados pode ser adicionado para todo o período e dividido pelo número total de visualizações naquele período para obter a visualizadorPercentage de todo o período.
    • Não é possível calcular o número de espectadores únicos para um período de sete dias, já que o mesmo espectador pode ser calculado como um espectador único em dias diferentes. No entanto, você pode usar a dimensão month em vez da 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 corridos, 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 alterações relacionadas à API (consultas segmentadas) do YouTube Analytics:

  • Como a versão 1 da API foi totalmente descontinuada, a documentação foi atualizada para remover referências a essa versão, 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 alterações relacionadas à API (consultas segmentadas) do YouTube Analytics:

  • 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 assim que possível para minimizar as interrupções do serviço. Para mais detalhes, consulte o guia de migração.

    O cronograma dessa suspensão de uso foi anunciado originalmente em 26 de abril de 2018.

17 de setembro de 2018

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

  • A nova seção sobre anonimização de dados no documento de visão geral do modelo de dados explica que alguns dados do YouTube Analytics são limitados quando as métricas não atingem um determinado limite. Isso pode acontecer em diversos casos. Na prática, isso significa que um relatório talvez não contenha todos (ou nenhum) dos seus dados se:

    1. um vídeo ou canal tiver tráfego limitado durante um período específico,

      ou

    2. você selecionou um filtro ou uma dimensão, como origem do tráfego ou país, para os quais os valores não atingem um 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 relatórios de canal e relatórios do proprietário do 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 da reprodução, origem de tráfego e tipo de dispositivo/sistema operacional.

18 de junho de 2018

Esta atualização contém as seguintes alterações na API (consultas segmentadas) do YouTube Analytics:

  • Os requisitos de escopo dos métodos a seguir mudaram:
    • 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 https://www.googleapis.com/auth/youtubeescopo
        ou
      • o https://www.googleapis.com/auth/youtube.readonlyescopo
        e
        o escopo https://www.googleapis.com/auth/yt-analytics.readonly

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

23 de maio de 2018

Esta atualização contém as seguintes alterações na API (consultas segmentadas) do YouTube Analytics:

22 de maio de 2018

Esta atualização contém as seguintes mudanças relacionadas à API YouTube Reporting (Bulk Reports):

  • As alterações a seguir estão programadas para entrar em vigor em julho de 2018, e as novas políticas se aplicam globalmente a todos os relatórios e jobs de geração de relatórios.

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

      Antes deste anúncio, todos os relatórios de API ficavam disponíveis por 180 dias a partir do momento em que foram gerados. Quando essa alteração da política entrar em vigor, os relatórios de dados históricos com mais de 30 dias também não poderão mais ser acessados pela API. Todos os outros relatórios com mais de 60 dias também não poderão ser acessados. Por isso, a documentação agora afirma que os relatórios criados antes da mudança na política ficarão disponíveis por até 180 dias.

    • Após a alteração, quando você programar um trabalho de geração de relatórios, o YouTube gerará relatórios a partir daquele dia e cobrindo o período de 30 dias antes do horário em que o trabalho foi agendado. Antes da mudança, quando você programa um trabalho de geração de relatórios, o YouTube gera relatórios cobrindo o período de 180 dias anterior ao horário que o trabalho foi agendado.

  • 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 nos relatórios. Conforme descrito nas Políticas para desenvolvedores de serviços da API 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 informar que, embora os dados não sejam filtrados, os relatórios com dados de um período a partir de 1° de junho de 2018 não terão referências a recursos do YouTube excluídos pelo menos 30 dias antes da data de geração.

  • A seção de dados históricos da visão geral da API foi atualizada para informar que, quando você programa um novo job de geração de relatórios, os relatórios históricos geralmente são postados em alguns dias. Antes, a documentação indicava que podia levar até 30 dias para que esses relatórios ficassem disponíveis.

  • 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 enviado anteriormente.

26 de abril de 2018

A versão 2 da API (v2) do YouTube Analytics (Consultas segmentadas) já está disponível ao público. A lista a seguir identifica as alterações do produto e da documentação relacionadas à nova versão da API:

  • A API v2 é quase idêntica à API v1. No entanto, provavelmente será necessário atualizar seu código para refletir as alterações listadas abaixo. Todas essas alterações 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 têm nomes atualizados. 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, uma vez que os métodos da API para criar e gerenciar grupos já usavam letras concatenadas para os nomes de parâmetros.
    • A API v2 não é compatível com solicitações em lote enviadas ao endpoint de lote HTTP global do Google (www.googleapis.com/batch). Se você estiver enviando solicitações em lote na API v2, use o ponto de extremidade https://youtubeanalytics.googleapis.com/v2.

    Além disso, alguns recursos da v1 não têm suporte na API v2:

    • O método reports.query não oferece mais suporte aos parâmetros de solicitação alt, quotaUser e userIp.
    • A API v2 não fornece um endpoint de lote que oferece suporte a lotes compostos por solicitações para diferentes APIs. No entanto, um lote pode ser composto por solicitações para diferentes métodos da mesma API. Essa descontinuação não é específica à API YouTube Analytics, já que o Google vai descontinuar o endpoint de lote global em todas as APIs.
    • A API v2 não suporta o protocolo JSON-RPC, que era suportado na API v1. Novamente, essa descontinuação não é específica da API YouTube Analytics.

  • Observação:este é um anúncio 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 deixarão de funcionar após essa data. Por isso, faça 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 alterações na API (consultas segmentadas) do YouTube Analytics:

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

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 é compatível com o seguinte valor:
      • 25: KaiOS

  • API YouTube Analytics (consultas segmentadas)

    • A dimensão operatingSystem é compatível com o valor de dimensão KAIOS.

20 de dezembro de 2017

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

  • O servidor de API agora oferece suporte à compactação gzip para solicitações que fazem download de relatórios. A compactação gzip não é compatível com outros tipos de solicitações de API. A ativação da compactação gzip reduz a largura de banda necessária para cada resposta da API. E, embora seu aplicativo precise de mais tempo de CPU para descompactar as respostas da API, o benefício de consumir menos recursos de rede geralmente supera 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 da 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. Dessa forma, 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 suspensão do uso 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 earnings era uma métrica principal, ela teve suporte 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 da earnings, faça isso o quanto antes.

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 para o qual todas as métricas consultadas estão disponíveis.

      Por exemplo, se uma solicitação especificar uma data de término como 5 de julho de 2017, e os valores de todas as métricas solicitadas só estiverem disponíveis até 3 de julho de 2017, essa será a última data em que os dados serão incluídos na resposta. Isso é válido mesmo que os dados de algumas das métricas solicitadas estejam disponíveis para o dia 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é seis segundos que é reproduzido antes da exibição do vídeo. O formato do anúncio é idêntico ao do anúncio auctionBumperInstream, mas esse tipo se refere a anúncios vendidos por reserva, e não em um leilão.

  • API YouTube Reporting (relatórios em massa)

    • A dimensão ad_type agora é compatível com o valor 20, que se refere a anúncios bumper vendidos por reserva. Os anúncios bumper são anúncios em vídeo não puláveis de até seis segundos que são veiculados antes da exibição do vídeo. O valor 19 para essa dimensão também se refere a anúncios bumper vendidos em um leilão, e não de forma reservada.

    • Os jobs de relatórios para os seguintes 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 suspensos em 15 de setembro de 2016 e não são mais gerados 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. Assim, alguns relatórios puderam ser acessados a partir de 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ório para os seguintes 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 anunciados como descontinuados em 22 de junho de 2016 e não são mais gerados para eles depois de 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. Assim, alguns relatórios puderam ser acessados a partir de 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 é compatível com 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 alteração não reflete qualquer alteração no comportamento da API ou na classificação de vídeos compartilhados com esses serviços.

  • API YouTube Analytics (consultas segmentadas)

    • A dimensão sharingService agora é compatível com os seguintes valores:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 de março de 2017

Os proprietários de canais com acesso aos dados de receita pelo YouTube Analytics no YouTube Studio agora também podem fazer isso 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 informar que o valor da dimensão se refere ao período que começa às 0h do 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 ajustados representam um período de 23 horas, e as datas em que os relógios são ajustados para trás representam um período de 25 horas. Antes, a documentação indicava que cada data representava um período exclusivo de 24 horas e que o horário do Pacífico sempre era 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 é compatível com os seguintes valores:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Todos os jobs de relatório para o tipo de relatório content_owner_basic_a1 foram excluídos. Esse tipo de relatório foi totalmente suspenso em 19 de agosto de 2016, mas os relatórios content_owner_basic_a1 gerados anteriormente ainda estavam disponíveis por 180 dias a partir do momento em que foram gerados. Assim, alguns relatórios puderam ser acessados a partir de 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 informar que o valor da dimensão se refere ao período que começa às 0h do 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 ajustados representam um período de 23 horas, e as datas em que os relógios são ajustados para trás representam um período de 25 horas. Anteriormente, a documentação indicava 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 canal foi atualizada para informar que, no momento, eles não contêm métricas de ganhos ou de desempenho de anúncios. Como resultado, o escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly não concede acesso a dados monetários em relatórios de canal no momento.

    • A dimensão operatingSystem é compatível com três novos valores de dimensão:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 de fevereiro de 2017

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

O parâmetro permite que um proprietário de conteúdo indique que uma resposta da API deve incluir o endereço o tempo de exibição e os dados de visualização do período anterior à vinculação dos canais 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 o tempo de exibição e os dados de visualização a partir do momento em que os canais foram 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 do conteúdo em datas diferentes. Se a solicitação de API estiver recuperando dados de vários canais e o valor do parâmetro for false, a resposta da API vai conter o tempo de exibição e os dados de visualização com base na data de vinculação de cada canal.
  • Se o valor do parâmetro for true, a resposta retornará o tempo de exibição e os dados de visualização 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 anúncio de suspensão de uso desses relatórios foi feito em 15 de setembro de 2016.

A lista dos tipos de relatório 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 oferece suporte a três novos relatórios de tela final, bem como 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 são exibidas após a interrupção da reprodução de um vídeo.

    8 de novembro de 2016

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

    • As métricas da lista a seguir foram totalmente descontinuadas e não são mais compatíveis. Conforme anunciado em 10 de agosto de 2016, já são suportadas novas métricas referentes aos mesmos dados. 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

    Agora o YouTube 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 projetados para fornecer acesso programático aos dados que também estão disponíveis nos relatórios do Estúdio de Criação para download manual.

    A visão geral dos relatórios gerenciados pelo sistema apresenta os novos relatórios e explica o processo para recuperá-los pela API. Esse processo é um pouco diferente daquele usado para recuperar relatórios em massa do YouTube Analytics, já que os parceiros não precisam agendar tarefas para gerar os relatórios.

    A propriedade id do recurso reportType foi atualizada para incluir uma lista dos relatórios gerenciados pelo sistema que podem ser acessados pela API:

    • Receita de publicidade mensal e mundial por vídeo
    • Receita de publicidade diária por país por vídeo
    • Receita de publicidade mensal e mundial 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 anúncio de descontinuação.

    A métrica uniques da API YouTube Analytics foi descontinuada. Essa não é uma métrica principal e será compatível 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 gerará mais novos relatórios desse tipo, embora os relatórios que já tenham sido gerados ainda estejam disponíveis por 180 dias a partir do momento em que foram gerados.

      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 novos Termos de Serviço dos serviços de API do YouTube ("Termos atualizados"), discutidos em detalhes no Blog de engenharia e desenvolvedores do YouTube (em inglês), oferecem um conjunto completo de atualizações dos Termos de Serviço atuais. Além dos Termos atualizados, que entrarão em vigor em 10 de fevereiro de 2017, esta atualização inclui vários documentos de apoio para ajudar a explicar as políticas que os desenvolvedores precisam seguir.

      O conjunto completo dos novos documentos está descrito no histórico de revisões dos Termos atualizados. Além disso, futuras alterações nos Termos atualizados ou nesses documentos de comprovação também serão explicadas no histórico de revisões. Você pode se inscrever em um feed RSS listando as alterações do histórico de revisões por um link no documento.

    10 de agosto de 2016

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

    • API YouTube Analytics (consultas segmentadas)

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

        As métricas na tabela a seguir serão 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, embora a API YouTube Analytics seja compatível com os dois nomes de métrica até as datas de suspensão de uso listadas na tabela.

        Nome antigo da métrica Novo nome da métrica Data do 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

        Observe que earnings era uma métrica principal, por isso será válida por um ano a partir da data deste anúncio. As outras métricas, que não eram principais, terão suporte 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, cpm ou ambas. Após essa data, apenas a métrica cpm será compatível.

      • A dimensão insightTrafficSourceType é compatível com dois novos valores de dimensão:
        • CAMPAIGN_CARD: esta origem de tráfego só é compatível com relatórios do proprietário do conteúdo. Ela indica que as visualizações se originaram de vídeos reivindicados enviados por usuários e que o proprietário do conteúdo utilizou para promover o conteúdo visualizado.
        • END_SCREEN: os dados pertencem às visualizações originadas na tela final de outro vídeo.

        Para as duas novas origens de tráfego, você também pode recuperar um relatório traffic source detail. Em ambos os casos, a dimensão insightTrafficSourceDetail identifica o vídeo a partir do qual o espectador foi indicado.

      • 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é seis segundos que é reproduzido antes da exibição do vídeo.

    • API YouTube Reporting (relatórios em massa)

      • A dimensão traffic_source_type agora é compatível com os seguintes valores:
        • 19: esta origem de tráfego só é compatível com relatórios do proprietário do conteúdo. Ela indica que as visualizações se originaram de vídeos reivindicados enviados por usuários e que o proprietário do conteúdo utilizou para promover o conteúdo visualizado.
        • 20: os dados pertencem às visualizações originadas na tela final de outro vídeo.

        Para ambas as novas origens de tráfego, a dimensão traffic_source_detail identifica o vídeo a partir do qual o espectador foi direcionado.

      • 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 referente aos anúncios bumper, que são anúncios em vídeo não puláveis de até seis segundos que são exibidos antes da exibição 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 relatórios de canal a seguir foram atualizadas para incluir métricas de cards. A compatibilidade com métricas de card nesses relatórios foi realmente adicionada em 28 de junho de 2016, e a entrada do histórico de revisões dessa data explica a alteração em mais detalhes. Os relatórios são:
        • Atividade básica do usuário para os 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 nas províncias
        • Principais vídeos por estado
        • Principais vídeos para espectadores inscritos ou não inscritos

      • As listas de filtros foram corrigidas nos relatórios de retenção de público do canal e nos 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 dos dois relatórios indicava incorretamente que o relatório poderia ser recuperado usando um desses dois filtros ou usando 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 afirmar que o YouTube gera relatórios para download para os dias em que não há dados disponíveis. Esses relatórios contêm uma linha de cabeçalho, mas não contêm outros dados. Essas informações já haviam 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 ele 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 o suporte às métricas de cartão em vários relatórios de canal e proprietário do conteúdo. As métricas recém-aceitas são:

    As métricas são suportadas nos seguintes tipos de relatórios:

    22 de junho de 2016

    Esta atualização contém as mudanças a seguir na API YouTube Reporting. A primeira alteração diz respeito à API em geral, e as demais alterações afetam somente 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.

      Antes, a documentação indicava que os relatórios estavam disponíveis por um período de até 180 dias antes da data de envio da solicitação de API. Embora também fosse 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 recém-renomeado é idêntico à versão anterior.

      • Dois relatórios com novas versões foram renomeados:

        • A nova versão do relatório content_owner_estimated_earnings_a1 se chama content_owner_estimated_revenue_a1.
        • A nova versão do relatório content_owner_asset_estimated_earnings_a1 se chama content_owner_asset_estimated_revenue_a1.

        Os dois relatórios recém-renomeados têm as seguintes diferenças em relação aos antecessores:

      Se você já tiver tarefas para criar qualquer uma das versões mais antigas desses relatórios, precisará criar novas tarefas para os relatórios renomeados. Em conjunto com o lançamento das novas versões do relatório, 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 vagas para algum desses relatórios, não espere que o YouTube gere novos relatórios para essas vagas após 22 de setembro de 2016. Os relatórios gerados vão continuar 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 das duas métricas foram corrigidos na documentação para corresponder aos nomes que aparecem nos relatórios. Esta é apenas uma correção na documentação e não reflete uma mudança no conteúdo 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 após essa atualização. Conforme 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. Vale lembrar que essa métrica só aparece em dois relatórios que estão sendo descontinuados após essa atualização. Conforme 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 para a 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 os relatórios disponíveis pela 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 do conteúdo. O ID do tipo de relatório do 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 precisará criar um novo job para o relatório content_owner_basic_a2. O YouTube não está automaticamente migrando os proprietários do conteúdo para a nova versão do relatório nem criando um job para gerar a nova versão do relatório. Em algumas implementações, o aparecimento de um job novo e inesperado pode ser uma alteração interruptiva.

      Com o lançamento da nova versão, o relatório content_owner_basic_a1 foi descontinuado. Se você tem um trabalho para aquele relatório, não espere que o YouTube gere novos relatórios para esse trabalho após 19 de agosto de 2016. Os relatórios gerados vão continuar 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. Esta propriedade só tem valor para relatórios que foram anunciados como descontinuados, e o valor representa a data em que o YouTube deixará 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, a atualização de 19 de maio de 2016 anuncia a descontinuação do relatório content_owner_basic_a1. Por isso, o deprecateTime para esse tipo de relatório especifica o dia 19 de agosto de 2016. Após essa data, o YouTube deixará de gerar relatórios desse tipo.

      • A propriedade expireTime do recurso job especifica a data e a hora em que o emprego 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 forem transferidos por download por um período prolongado. A data marca o momento em que o YouTube não vai mais gerar novos relatórios para o trabalho.

      • 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 fazem com que uma solicitação de API falhe.

    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 abrangem o período de 180 dias antes do horário em que um trabalho de relatório foi agendado pela primeira vez. Antes, a API Reporting não fornecia dados históricos. Essa alteração afeta todos os jobs, incluindo os criados antes deste anúncio.

      Os relatórios históricos são postados assim que ficam disponíveis, embora leve cerca de um mês para que todos os dados históricos sejam postados para uma vaga. Assim, um mês após agendar um trabalho de relatório, você terá acesso a cerca de sete meses de dados. (Todos os dados históricos de vagas criadas antes deste anúncio devem ser postados até um mês após o anúncio.)

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

      Essas alterações são explicadas na nova seção de dados históricos da visão geral da API Reporting.

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

      • A documentação agora afirma que os relatórios estão disponíveis por um período de 180 dias após a geração e, portanto, disponíveis para download pelos clientes da API. Antes, a documentação indicava 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 os dias em que não havia dados disponíveis. Esses relatórios conterão linhas de cabeçalho, mas não terão dados adicionais.

    • Em breve, a API YouTube Reporting será compatível com um conjunto de relatórios gerados automaticamente e gerenciados pelo sistema com dados de receita de publicidade ou de assinaturas do YouTube Premium. Os relatórios estarão disponíveis para os proprietários de conteúdo que já têm acesso manual aos relatórios de receita para download no Estúdio de Criação do YouTube. Assim, a nova funcionalidade da API fornecerá acesso programático a esses dados.

      As seguintes alterações na API estão sendo anunciadas agora como 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 proprietários de conteúdo do YouTube e os proprietários de conteúdo não podem modificar ou excluir trabalhos que criam esses relatórios.

      • O novo parâmetro includeSystemManaged do método jobs.list indica se a resposta da API precisa 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ó vai conter relatórios se os dados mais antigos forem até a data especificada ou após essa data. Da mesma forma, o parâmetro startTimeBefore indica que a resposta da API só vai 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 está relacionado ao momento em que o relatório foi criado, os novos parâmetros estão relacionados 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 precisa incluir relatórios gerenciados pelo sistema. O valor padrão do parâmetro é false.

    28 de março de 2016

    A API YouTube Reporting e a API YouTube Analytics agora mostram estatísticas de visualização de vários outros serviços de compartilhamento.

    • Na API YouTube Reporting, a dimensão sharing_service é compatível com estes novos valores:
      • 82: caixa de diálogo de atividade do sistema iOS
      • 83: caixa de entrada do Google
      • 84: Android Messenger
    • Na API YouTube Analytics, a dimensão sharingService é compatível com estes novos valores:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: caixa de entrada do Google
      • 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 a API YouTube Reporting e a API YouTube Analytics:

    API YouTube Reporting

    • A dimensão playback_location_type é compatível com dois novos valores de dimensão:
      • 7: os dados pertencem a visualizações que ocorreram na página ou tela inicial do YouTube, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube.
      • 8: os dados se referem a visualizações que ocorreram diretamente na página de resultados da pesquisa do YouTube.
    • A dimensão traffic_source_type agora é compatível com 18 como um valor de dimensão. Este valor indica que as exibições de vídeo se originaram de uma página que lista todos os vídeos de uma lista de reprodução. Essa fonte é diferente do tipo de origem 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 é compatível com dois novos valores de dimensão:
      • BROWSE: os dados pertencem a visualizações que ocorreram na página ou tela inicial do YouTube, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube.
      • SEARCH: os dados se referem a visualizações que ocorreram diretamente na página de resultados da pesquisa do YouTube.
    • A dimensão insightTrafficSourceType agora é compatível com YT_PLAYLIST_PAGE como um valor de dimensão. Este valor indica que as exibições de vídeo se originaram de uma página que lista todos os vídeos de uma lista de reprodução. Essa fonte é diferente do tipo de origem PLAYLIST, que indica que as visualizações ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist.

    8 de fevereiro de 2016

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

    Você ainda pode recuperar as métricas do cartão usando a API YouTube Reporting, que é compatível com essas métricas para vários relatórios de canal e 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 por meio de um dispositivo Chromecast.

    • Na API YouTube Reporting, a dimensão operating_system usa o valor 21 para identificar visualizações que ocorrem pelo Chromecast.
    • Na API YouTube Analytics, a dimensão operatingSystem usa o valor CHROMECAST para identificar 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. Antes, 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 fornecidas e o consentimento seja obtido dos usuários finais na UE. Portanto, os usuários finais na União Europeia precisam obedecer à Política de consentimento de usuários da União Europeia. Adicionamos um aviso sobre esse requisito nos Termos de Serviço da API do YouTube.

    15 de dezembro de 2015

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

    • A API YouTube Analytics agora oferece suporte a três novas dimensões de detalhes da reprodução, que podem ser usadas em vários relatórios do proprietário do conteúdo e do canal:

      • 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: esta dimensão indica se as métricas de atividade do usuário nos dados estão associadas aos 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 (ou app YouTube) principal do YouTube, o YouTube Gaming e o YouTube Kids.

      A documentação foi atualizada para identificar novos relatórios detalhados de reprodução disponíveis para canais e proprietários do conteúdo. Além disso, muitos outros relatórios foram atualizados para mostrar 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 foi alterado para facilitar a identificação de combinações válidas de dimensões, métricas e filtros que podem ser usadas para recuperar cada relatório. A tabela abaixo, que explica o "tipo de dispositivo", para canais, mostra o novo formato:

      Índice
      Dimensões:
      Obrigatório deviceType
      Use 0 ou mais day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Métricas:
      Use um ou mais views, estimatedMinutesWatched
      Filtros:
      Use 0 ou 1 país, província, continente, subContinent
      Use 0 ou 1 vídeo, grupo
      Use 0 ou mais operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

    • A API YouTube Analytics agora remove automaticamente entidades para as quais o usuário da API não pode recuperar dados de filtros compatíveis com vários valores (video, playlist e channel). Anteriormente, o servidor da API apenas retornava um erro se o usuário da API não pudesse acessar os 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ídeos. O usuário é proprietário de 18 dos vídeos. No entanto, um ID de vídeos identifica um vídeo de outro canal, e outro identifica um vídeo que foi excluído e, portanto, não existe mais. Nesse caso, em vez de retornar um erro, o servidor da API agora descarta os dois vídeos que o usuário não pode acessar e a resposta da API contém dados para os 18 vídeos que o usuário da API possui.

    • Se você solicitar dados para uma group vazia 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 que você adicionasse a entidade ao grupo, mas depois retornou um erro não autorizado quando você tentou recuperar dados de 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 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 outros 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 as datas referentes ao período de 24 horas que começa à 0h, horário do Pacífico (UTC-8). Antes, a documentação indicava que a data começava às 0h (GMT).

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

    • O método jobs.reports.list() da API YouTube Reporting agora oferece suporte ao parâmetro de consulta createdAfter. Se especificado, este parâmetro indica que a resposta da API deve listar somente os relatórios criados após a data e a hora especificadas, incluindo novos relatórios com dados preenchidos. O valor do parâmetro é referente ao horário em que o relatório foi criado, e não às datas associadas aos dados retornados.

      O valor do parâmetro é um carimbo de data/hora em UTC "Zulu" RFC3339 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 as propriedades startTime, endTime e createTime do recurso report foram corrigidas para mostrar que os valores da propriedade são precisos em microssegundos, não 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-suportados.

      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 é 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 exclusiva de valores de dimensão. É possível agregar dados em linhas com base nos valores de dimensão para calcular as métricas de vídeos individuais, países, vídeos ao vivo, usuários inscritos e assim por diante.

      Você pode usar a API para programar jobs de geração de relatórios, e cada um deles identifica um relatório que o YouTube deve gerar. Após configurar uma tarefa, o YouTube gera um relatório diário que pode ser baixado de forma assíncrona. Cada relatório contém dados para um período exclusivo de 24 horas.

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

      • A guia Guides (guias) no conjunto de documentação contém informações comuns a ambas as 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 especificamente para a API YouTube Reporting.
      • A guia Consultas segmentadas contém documentação de referência e outros conteúdos especificamente para a API YouTube Analytics.
      • A guia Amostras lista os exemplos de código disponíveis para qualquer uma das duas APIs.
      • A guia Ferramentas lista outros recursos disponíveis para ajudar os desenvolvedores a implementar qualquer 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 a compreensão dela. Dessa forma, essas mudanças não descrevem novos recursos:

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

      • 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 de relatório.

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

    22 de julho de 2015

    Essa atualização contém várias mudanças, e todas elas 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 fontes de publicidade vendidas pelo Google. Ela não é uma métrica principal. A API oferece suporte à 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 seu valor inclui o total de ganhos estimados de todas as fontes de publicidade vendidas pelo Google, bem como de fontes não publicitárias. Antes, a definição indicava incorretamente que a métrica incluía apenas ganhos de fontes de publicidade.

    • O uso da métrica primaryAdGrossRevenue foi descontinuado. Em vez disso, use a métrica grossRevenue para recuperar dados de receita.

    • Além da métrica descontinuada primaryAdGrossRevenue, os relatórios de performance de 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 oferecem suporte a essas métricas.

    1o de junho de 2015

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

    • A API agora oferece suporte a 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 do conteúdo foram atualizadas para identificar os relatórios que suportam 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 do vídeo ou ao conteúdo de outros canais listas de reprodução.
      • 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 do vídeo ou da lista de outros canais listas de reprodução.

      Ambas as métricas incluem playlists padrão, como "Assistir mais tarde" lista de reprodução. No entanto, elas não contam as playlists às quais um vídeo é adicionado automaticamente, como a playlist de envios de um canal ou o histórico de exibição de um usuário. 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 indicarão que o vídeo foi adicionado a duas playlists e removido de uma.

      Os dados dessas métricas estão disponíveis desde 1o 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:

    • Com o novo parâmetro currency, é possível recuperar métricas de ganhos em uma moeda que não seja o 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 usando taxas de câmbio que são alteradas 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 compatíveis.

    25 de fevereiro de 2015

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

    • A API agora suporta a capacidade de criar e gerenciar grupos do YouTube Analytics, bem como a capacidade de recuperar dados de relatório 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 oferece suporte aos métodos list, insert, update e delete para esse recurso.
        • O recurso groupItem representa um item em um grupo do Google Analytics. A API oferece suporte aos métodos list, insert e delete para esse recurso.

        Por exemplo, você pode criar um grupo usando o método groups.insert e depois 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 um filtro para muitos relatórios de canal e relatórios do 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 oferece suporte à capacidade de especificar vários valores para as dimensões video, playlist, channel e show quando essas dimensões são usadas como filtros. Para especificar diversos valores, defina o valor do parâmetro filters como uma lista separada por vírgulas dos IDs de vídeo, playlist, canal ou programa para os quais a resposta da API será filtrada. O valor do parâmetro pode especificar até 200 IDs.

      Se você especificar diversos valores para o mesmo filtro, também poderá adicionar esse filtro à lista de dimensões especificadas para a solicitação. Isso acontece 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 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 para o 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 oferece suporte a relatórios de lista de reprodução, que contêm estatísticas relacionadas às exibições de vídeo que ocorrem no contexto de uma lista de reprodução. Os relatórios de playlists estão disponíveis para canais e proprietários do 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 novas métricas a seguir. Cada uma dessas métricas reflete somente as visualizações de playlists que ocorreram na Web.

      • playlistStarts: o número de vezes que os espectadores iniciaram a reprodução de uma playlist.
      • viewsPerPlaylistStart: a média de visualizações do vídeo sempre que uma playlist foi iniciada.
      • averageTimeInPlaylist: a quantidade média estimada de tempo, em minutos, que um espectador assistiu a vídeos em 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).

    • Agora a API oferece suporte a um relatório de retenção de público. Este relatório mede a capacidade de um vídeo de reter seu público. A nova dimensão elapsedVideoTimeRatio do relatório mede a duração do vídeo de acordo com os valores de métrica correspondentes:

      • A métrica audienceWatchRatio identifica a proporção absoluta de espectadores que estão assistindo ao vídeo em um determinado ponto do vídeo. 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.

        Observe que uma parte do conteúdo pode ser assistida mais de uma vez (ou não ser assistida) em uma determinada exibiçã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 do vídeo poderá ser maior que 1.

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

      Você também pode usar o filtro audienceType para que o relatório mostre apenas dados associados a visualizações orgânicas, visualizações de anúncios TrueView in-stream ou visualizações de anúncios TrueView in-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 oferece suporte a várias novas métricas relacionadas às anotações. As métricas listadas abaixo podem ser recuperadas com qualquer relatório que anteriormente aceitava 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 referências dos resultados de 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 defina 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 exemplos em categorias, usando um formato de guia semelhante ao lançado recentemente para relatórios do proprietário do conteúdo e do canal. 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 do proprietário do conteúdo)

    • O documento de exemplos de solicitações agora inclui novos exemplos para recuperar dados específicos de uma província nos relatórios do canal ou do proprietário do conteúdo.

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

      • Informações demográficas dos espectadores na Califórnia (idade e gênero): este relatório apresenta estatísticas sobre a faixa etária e o gênero dos espectadores da Califórnia que assistiram vídeos de um canal ou, para relatórios do proprietário do conteúdo, do conteúdo reivindicado dele. 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 informar que, quando province for incluído no valor do parâmetro dimensions, a solicitação também precisará restringir os dados aos Estados Unidos, incluindo country==US no valor do 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, e você pode clicar em qualquer guia para ver os relatórios compatíveis nessa 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 para os estados dos EUA e do Distrito da Colômbia. A API suporta dois usos para essa dimensão:

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

          • O relatório de estatísticas principais fornece diversas estatísticas, incluindo contagens de visualizações e estimativa de minutos assistidos.
          • O relatório com base no tempo fornece as mesmas estatísticas, mas agrega dados diários, de 7 dias, 30 dias ou mensais.

        • É possível usar o parâmetro de consulta filters para restringir um relatório para conter apenas estatísticas de um estado específico. Vários relatórios são compatíveis com esse tipo de filtragem, incluindo relatórios geográficos, de local da reprodução, de origem do tráfego, de dispositivos, de sistemas operacionais, demográficos e dos principais vídeos.

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

      • A dimensão subContinent especifica um código regional estatístico 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 só é associada a um continente, não é necessário usar o filtro continent quando você estiver usando o filtro subContinent. Na verdade, a API retornará um erro se uma solicitação usar ambas as 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, essas métricas não estão sujeitas à política de descontinuação. As páginas dimensões e métricas foram atualizadas para listar as dimensões e as 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 oferece suporte a EXTERNAL_APP como um valor para a dimensão insightPlaybackLocationType. De acordo com essa atualização, desde 10 de setembro de 2013, as reproduções não são mais categorizadas como reproduções do MOBILE. No entanto, as reproduções em dispositivos móveis que ocorreram antes dessa data ainda serão categorizadas com esse valor.

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

    • A API agora oferece suporte a PLAYLIST como um valor para a dimensão insightTrafficSourceType. O valor indica que as exibições de vídeo foram direcionadas de uma playlist. Anteriormente, 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 conter apenas as estatísticas dos 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 do sistema operacional para conter apenas as estatísticas de um tipo específico de dispositivo, como smartphones 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:

    • A API agora oferece suporte à capacidade de recuperar métricas de tempo de exibição (estimatedMinutesWatched, averageViewDuration e averageViewPercentage) em conjunto com outras métricas, incluindo métricas de visualização, de engajamento, de ganhos e de performance de anúncios.

      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 oferecem suporte a um filtro country opcional.

      • Os proprietários do conteúdo agora podem recuperar esses relatórios usando qualquer uma das novas combinações de filter a seguir. Todas essas combinações também oferecem suporte ao filtro country opcional.

        • Detalhes do local da 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 Exemplo de solicitações de API fornece exemplos que demonstram como recuperar muitos tipos diferentes de relatórios usando o YouTube Analytics API. Cada exemplo inclui uma breve descrição do relatório que a solicitação recupera e mostra as dimensões, métricas, filtros e parâmetros de classificação da solicitação.

    • A dimensão insightTrafficSourceType agora é compatível com 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 especificará o feed da página inicial ou outra página de origem das visualizações.

    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 fontes de publicidade vendidas pelo Google.
        • grossRevenue – Receita bruta estimada de parceiros do Google ou do DoubleClick.
        • primaryAdGrossRevenue – Receita bruta estimada, resumida e classificada no tipo de anúncio principal para as reproduções de vídeo que o relatório abrange, de parceiros do Google ou da DoubleClick.
        • monetizedPlaybacks – O número de reproduções que mostraram pelo menos uma impressão de anúncio.
        • playbackBasedCpm – Receita bruta estimada por mil reproduções.
        • impressions – O número de impressões de anúncios 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 recupera métricas de ganhos ou de performance de anúncios precisa enviar um token de autorização que concede 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:

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

    14 de novembro de 2012

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

    • O guia de referência da API agora apresenta a APIs Explorer, que permite chamar a API, consultar 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 dimensões e métricas também foram atualizadas em conformidade.

      • 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 (dia, sete dias anteriores, 30 dias anteriores etc) ou país específico. 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 primeiro acesso no painel Serviços no APIs console.

    • A nova seção Vamos começar descreve os pré-requisitos e as etapas básicas para criar um aplicativo que usa o 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 Analytics deve agregar dados com base em um período. Agora, a API suporta as seguintes dimensões temporais adicionais:

      • 7DayTotals – Os dados do relatório serão agregados para que cada linha contenha dados de um período de sete dias.
      • 30DayTotals – Os dados do relatório serão agregados para que cada linha contenha dados de um período de 30 dias.
      • month – Os dados do 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 informar 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 compatível 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 de vídeos, 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.