Nesta página, listamos as mudanças na 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, ainda que de maneiras diferentes. Inscreva-se neste log de mudanças.
6 de maio de 2024
A API YouTube Analytics (Targeted Query) oferece suporte a três novos relatórios para canais:
-
O relatório Atividade do usuário por DMA é um relatório geográfico que fornece estatísticas de atividade do usuário por Área designada do mercado (DMA, na sigla em inglês). Para esse relatório, é necessário definir o valor do parâmetro
filters
comocountry==US
. -
O relatório Espectadores simultâneos mostra o número de espectadores simultâneos em diferentes partes de um único vídeo transmitido ao vivo.
-
O relatório Cancelamentos de membros oferece estatísticas que mostram por que os usuários cancelaram os Clubes dos canais.
Esse relatório usa a nova dimensão
membershipsCancellationSurveyReason
, que especifica por que um usuário cancelou uma assinatura dos Clubes dos canais. Ele também usa a nova métricamembershipsCancellationSurveyResponses
, que indica quantas assinaturas dos Clubes dos canais foram canceladas por esse motivo.
Além disso, o relatório Retenção de público foi aprimorado para oferecer suporte a três novas métricas:
7 de abril de 2024
A API YouTube Analytics (TargetedQueries) tem várias atualizações relacionadas aos relatórios de playlists do proprietário do conteúdo. As atualizações são as mesmas relacionadas aos relatórios de playlists de canais, anunciados em 19 de janeiro de 2024.
A entrada de histórico de revisões a seguir fornece quase
as mesmas informações da entrada de 19 de janeiro de 2024. No entanto, os relatórios de playlists
do proprietário do conteúdo serão compatíveis com a dimensão
isCurated
até
31 de dezembro de 2024, e a dimensão será compatível com relatórios de playlists do canal até
30 de junho de 2024.
-
Observação:este é um anúncio de descontinuação.
A dimensão
isCurated
foi descontinuada para relatórios de playlists do proprietário do conteúdo. Ela não será mais aceita 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 a dimensão
isCurated
, você também precisa atualizar seu código para recuperar a métricaplaylistViews
, em vez da métricaviews
, somente para relatórios de playlists. Como a métricaviews
ainda é compatível com relatórios de playlists, embora com um significado diferente, a API ainda retornará dados se você não atualizar o nome da métrica. Você pode modificar o aplicativo para recuperar e exibirviews
eplaylistViews
.Além da dimensão
isCurated
, a seguinte funcionalidade da API não tem mais suporte nos novos relatórios:- Os filtros de local, como
continent
esubcontinent
, não são compatíveis com os novos relatórios de playlists de canais. - As métricas
redViews
eestimatedRedMinutesWatched
não são mais compatíveis com os novos relatórios de playlists de canais. Essas métricas não estavam disponíveis no YouTube Studio. Por isso, essa mudança alinha a funcionalidade da API com a disponível no aplicativo Studio. - As dimensões
subscribedStatus
eyoutubeProduct
não são mais compatíveis como filtros para relatórios de playlists de canais. Esses filtros não estavam disponíveis no YouTube Studio. Por isso, essa mudança alinha a funcionalidade da API com a funcionalidade disponível no aplicativo Studio.
- Os filtros de local, como
-
A seção de relatórios de playlists da documentação de relatórios do proprietário do conteúdo foi atualizada para explicar melhor os tipos de métricas que podem ser usados nesses relatórios:
- Métricas de vídeo agregadas fornecem métricas de atividade do usuário e impressões que são agregadas para todos os vídeos nas playlists do proprietário do conteúdo que também pertencem a ele. As métricas de vídeo agregadas são compatíveis somente com solicitações de API que não usam a dimensão
isCurated
. - As métricas na playlist refletem a atividade e o engajamento do usuário no contexto da página da playlist. Essas métricas incluem dados de visualizações de vídeos que não são de propriedade na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
- A seção Métricas de playlists aceitas identifica as métricas agregadas de vídeos e na playlist que podem ser usadas nos relatórios de playlists.
- Métricas de vídeo agregadas fornecem métricas de atividade do usuário e impressões que são agregadas para todos os vídeos nas playlists do proprietário do conteúdo que também pertencem a ele. As métricas de vídeo agregadas são compatíveis somente com solicitações de API que não usam a dimensão
-
As novas métricas na playlist a seguir são compatíveis com relatórios de playlists para proprietários de conteúdo. Essas métricas só serão aceitas se a solicitação da API para recuperar os relatórios não usar a dimensão
isCurated
. Consulte a documentação sobre metrics para ver as definições de cada uma delas: -
O comportamento da métrica
views
agora depende de a solicitação de API que recuperou o relatório de playlist usou a dimensãoisCurated
:- Quando uma solicitação inclui a dimensão
isCurated
, a métricaviews
é uma métrica na playlist que indica o número de vezes que os vídeos foram assistidos no contexto das playlists do proprietário do conteúdo. - Quando uma solicitação não inclui a dimensão
isCurated
, a métricaviews
é uma métrica de vídeo agregada que especifica o número total de vezes que os vídeos nas playlists do proprietário do conteúdo foram visualizados, independentemente de ter ocorrido no contexto da playlist. O total agregado inclui apenas as visualizações de vídeos que pertencem ao proprietário do conteúdo associado ao canal proprietário da playlist.
Nesses relatórios, que não usam a dimensãoisCurated
, a métricaplaylistViews
indica o número de vezes que os vídeos foram visualizados no contexto da playlist. Essa métrica contabiliza as visualizações de todos os vídeos da playlist, independentemente do canal proprietário deles.
- Quando uma solicitação inclui a dimensão
-
Para cada relatório de playlist, a documentação dos relatórios do proprietário do conteúdo agora inclui tabelas com as métricas compatíveis com o relatório, dependendo se a solicitação de API inclui ou não a dimensão
isCurated
. Consulte a seção que define relatórios de playlists com base em tempo para ver um exemplo.
19 de janeiro de 2024
A API YouTube Analytics (TargetedQueries) tem várias atualizações relacionadas aos relatórios de playlists de canais. As atualizações incluem uma dimensão descontinuada e várias métricas novas e atualizadas:
-
Observação:este é um anúncio de descontinuação.
A dimensão
isCurated
foi descontinuada para relatórios de canal. Ela não será mais compatível a partir de 30 de junho de 2024. A definição dessa dimensão foi atualizada de maneira adequada.Para preservar a compatibilidade com versões anteriores ao remover a dimensão
isCurated
, você também precisa atualizar seu código para recuperar a métricaplaylistViews
, em vez da métricaviews
, somente para relatórios de playlists. Como a métricaviews
ainda é compatível com relatórios de playlists, embora com um significado diferente, a API ainda retornará dados se você não atualizar o nome da métrica. Você pode modificar o aplicativo para recuperar e exibirviews
eplaylistViews
.Além da dimensão
isCurated
, a seguinte funcionalidade da API não tem mais suporte nos novos relatórios:- Os filtros de local, como
continent
esubcontinent
, não são compatíveis com os novos relatórios de playlists de canais. - As métricas
redViews
eestimatedRedMinutesWatched
não são mais compatíveis com os novos relatórios de playlists de canais. Essas métricas não estavam disponíveis no YouTube Studio. Por isso, essa mudança alinha a funcionalidade da API com a disponível no aplicativo Studio. - As dimensões
subscribedStatus
eyoutubeProduct
não são mais compatíveis como filtros para relatórios de playlists de canais. Esses filtros não estavam disponíveis no YouTube Studio. Por isso, essa mudança alinha a funcionalidade da API com a funcionalidade disponível no aplicativo Studio.
- Os filtros de local, como
-
A seção de relatórios de playlists da documentação de relatórios de canais foi atualizada para explicar melhor os tipos de métricas que podem ser usadas nesses relatórios:
- Métricas de vídeo agregadas fornecem métricas de atividade do usuário e de impressões que são agregadas para todos os vídeos nas playlists do canal que também pertencem a ele. As métricas de vídeo agregadas são compatíveis somente com solicitações de API que não usam a dimensão
isCurated
. - As métricas na playlist refletem a atividade e o engajamento do usuário no contexto da página da playlist. Essas métricas incluem dados de visualizações de vídeos que não são de propriedade na playlist, mas somente quando essas visualizações ocorreram no contexto da playlist.
- A seção Métricas de playlists aceitas identifica as métricas agregadas de vídeos e na playlist que podem ser usadas nos relatórios de playlists.
- Métricas de vídeo agregadas fornecem métricas de atividade do usuário e de impressões que são agregadas para todos os vídeos nas playlists do canal que também pertencem a ele. As métricas de vídeo agregadas são compatíveis somente com solicitações de API que não usam a dimensão
-
As novas métricas na playlist a seguir são compatíveis com relatórios de playlists para canais. Essas métricas ainda não são compatíveis com os relatórios do proprietário do conteúdo. Essas métricas só serão aceitas se a solicitação de API para recuperar os relatórios não usar a dimensão
isCurated
. Consulte a documentação sobre metrics para ver as definições de cada uma delas: -
O comportamento da métrica
views
agora depende de a solicitação de API que recuperou o relatório de playlist usou a dimensãoisCurated
:- Quando uma solicitação inclui a dimensão
isCurated
, a métricaviews
é uma métrica na playlist que indica o número de vezes que os vídeos foram assistidos no contexto das playlists do canal. - Quando uma solicitação não inclui a dimensão
isCurated
, a métricaviews
é uma métrica de vídeo agregada que especifica o número total de vezes que o vídeo foi assistido nas playlists do canal, independente de ter ocorrido no contexto da playlist. O total agregado inclui apenas as visualizações de vídeos que pertencem ao canal proprietário da playlist.
Nesses relatórios, que não usam a dimensãoisCurated
, a métricaplaylistViews
indica o número de vezes que os vídeos foram visualizados no contexto da playlist. Essa métrica contabiliza as visualizações de todos os vídeos da playlist, independentemente do canal proprietário deles.
- Quando uma solicitação inclui a dimensão
-
Para cada relatório de playlist, a documentação dos relatórios de canal agora inclui tabelas com as métricas compatíveis com o relatório, dependendo de a solicitação de API incluir ou não a dimensão
isCurated
. Consulte a seção que define relatórios de playlists com base em tempo para ver um exemplo.
04 de dezembro de 2023
A API YouTube Analytics (Consultas segmentadas) foi atualizada para combinar dois valores de dimensão insightTrafficSourceType
. Antes, a dimensão diferenciava entre vídeos reproduzidos como parte de uma playlist
(PLAYLIST
) e visualizações originadas de uma página que listava todos os vídeos de uma playlist
(YT_PLAYLIST_PAGE
). A partir de agora, os dois tipos de visualização serão associados ao valor de dimensão
PLAYLIST
.
15 de dezembro de 2022
A API YouTube Analytics (Consultas segmentadas) oferece suporte a duas novas dimensões e um novo relatório:
-
Um novo relatório fornece a atividade do usuário por cidade. Esse relatório está disponível para canais e proprietários do conteúdo. Esse relatório contém a nova dimensão
city
, que identifica uma estimativa do YouTube da cidade onde a atividade do usuário ocorreu. -
A nova dimensão
creatorContentType
identifica o tipo de conteúdo do YouTube associado às métricas de atividade do usuário na linha de dados. Os valores aceitos sãoLIVE_STREAM
,SHORTS
,STORY
eVIDEO_ON_DEMAND
.A dimensão
creatorContentType
é aceita como uma dimensão opcional para todos os 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 das duas novas dimensões.
-
As referências às dimensões
7DayTotals
e30DayTotals
foram removidas da documentação. A descontinuação dessas dimensões foi anunciada em outubro de 2019.
26 de agosto de 2022
A API YouTube Analytics (Consultas segmentadas) e a API YouTube Reporting (Relatórios em massa) são compatíveis com um novo valor de detalhe da origem do tráfego:
- Na API YouTube Analytics (Consultas segmentadas), se o valor da dimensão
insightTrafficSourceType
forSUBSCRIBER
, o valorinsightTrafficSourceDetail
poderá ser definido comopodcasts
, o que indica que o tráfego foi encaminhado da página de destino do Google Podcasts. - Na API YouTube Reporting (relatórios em massa), se o valor da dimensão
traffic_source_type
for3
, o valor detraffic_source_detail
poderá ser definido comopodcasts
, o que indica que o tráfego foi encaminhado da página de destino do Google Podcasts.
11 de fevereiro de 2022
O conjunto de valores válidos para a dimensão gender
vai mudar a partir de 11
de agosto de 2022. Essa pode ser uma alteração incompatível com versões anteriores na implementação da sua API. De acordo com a seção
Mudanças
incompatíveis com versões anteriores dos Termos de Serviço dos serviços da API do YouTube, essa mudança foi
anunciada seis meses antes de entrar em vigor. Atualize sua implementação da API
antes de 11 de agosto de 2022 e garanta uma transição perfeita para o novo conjunto de valores.
Estas são as mudanças específicas:
- Na API YouTube Analytics (Consultas segmentadas), a dimensão
gender
atualmente é compatível com dois valores:female
emale
. A partir de 11 de agosto de 2022, essa dimensão será compatível com três valores:female
,male
euser_specified
. - Na API YouTube Reporting (relatórios em massa), a
dimensão
gender
atualmente é compatível com três valores:FEMALE
,MALE
eGENDER_OTHER
. A partir de 11 de agosto de 2022, o conjunto de valores compatíveis vai mudar paraFEMALE
,MALE
eUSER_SPECIFIED
.
9 de fevereiro de 2022
Duas métricas foram atualizadas para excluir o tráfego de clipes em loop a partir de 13 de dezembro de 2021. Essa mudança afeta a API YouTube Analytics (Consultas segmentadas) e a API YouTube Reporting (relatórios em massa).
- Na API YouTube Analytics (Consultas segmentadas), as métricas
averageViewDuration
eaverageViewPercentage
excluem o tráfego de clipes em loop desde 13 de dezembro de 2021. - Na API YouTube Reporting (relatórios em massa), as métricas
average_view_duration_seconds
eaverage_view_duration_percentage
excluem o tráfego de clipes em loop desde 13 de dezembro de 2021.
2 de fevereiro de 2022
Esta API YouTube Reporting (relatórios em massa) é compatível com um novo valor de dimensão de origem do tráfego que indica que as visualizações se originaram de Redirecionamentos em tempo real:
- Na API YouTube Reporting (relatórios em massa), a dimensão
traffic_source_type
é compatível com o valor28
.
Para este tipo de origem do tráfego, a dimensão
traffic_source_detail
especifica o ID do canal de onde o espectador foi direcionado.
23 de setembro de 2020
A API YouTube Analytics (Consultas segmentadas) e a API YouTube Reporting (relatórios em massa) são compatíveis com um novo valor de dimensão de origem de tráfego que indica que o espectador foi direcionado ao deslizar verticalmente na experiência de visualização do YouTube Shorts:
- Na API YouTube Analytics (consultas segmentadas), a dimensão
insightTrafficSourceType
é compatível com o valorSHORTS
. - Na API YouTube Reporting (relatórios em massa), a dimensão
traffic_source_type
é compatível com o valor24
.
A dimensão de detalhes da origem de tráfego (insightTrafficSourceDetail
) na API YouTube Analytics ou traffic_source_detail
na API YouTube Reporting não é preenchida para esse novo tipo de origem de tráfego.
20 de julho de 2020
Esta atualização abrange duas mudanças que afetam a API YouTube Analytics (Consultas segmentadas):
- O tamanho máximo de um grupo de relatórios do YouTube Analytics aumentou de 200 para 500 entidades.
- O parâmetro
filters
do métodoreports.query
identifica uma lista de filtros que precisam ser aplicados ao recuperar dados do YouTube Analytics. O parâmetro é compatível com a capacidade de especificar vários valores para os filtrosvideo
,playlist
echannel
, e 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 à API YouTube Analytics (Consultas segmentadas) e à API YouTube Reporting (relatórios em massa). Saiba mais sobre essas mudanças na Central de Ajuda do YouTube.
Nas duas APIs, o conjunto de possíveis valores de detalhes da origem do tráfego para notificações está mudando.
Em consultas segmentadas, as notificações são informadas como insightTrafficSourceType=NOTIFICATION
. Nos relatórios em massa, as notificações são informadas como traffic_source_type=17
.
Os novos valores dividem as notificações relacionadas a vídeos enviados e transmissões ao vivo, anteriormente
relatadas como uploaded
, em duas categorias:
uploaded_push
: visualizações originadas de notificações push enviadas aos inscritos quando um vídeo foi enviadouploaded_other
: visualizações originadas de notificações não push, como notificações por e-mail ou caixa de entrada, enviadas aos inscritos quando um vídeo foi enviado.
Esses valores são retornados para o período a partir de 13 de janeiro de 2020.
Além disso, lembre-se de que esses valores não representam as notificações, mas sim as origens de tráfego que geraram determinadas visualizações no YouTube. Por exemplo, se uma linha do relatório indicar views=3
,
traffic_source_type=17
(NOTIFICATION
) e
traffic_source_detail=uploaded_push
, ela vai indicar que três visualizações
são provenientes de espectadores que clicaram em notificações push enviadas quando o vídeo foi enviado.
15 de outubro de 2019
Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (Consultas segmentadas):
-
Observação:este é um anúncio de descontinuação.
O YouTube está removendo o suporte para as dimensões
7DayTotals
e30DayTotals
. Você ainda poderá recuperar dados usando essas dimensões até 15 de abril de 2020. Nessa data ou após essa data, as tentativas de recuperar relatórios que usam a dimensão7DayTotals
ou30DayTotals
vão retornar um erro.Os usuários podem reproduzir alguns dos dados para essas dimensões fazendo consultas 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 em um período de sete dias, agregando o número de visualizações de cada dia desse período.
- Para calcular a porcentagem de espectadores para um período de sete dias, multiplique o número de visualizações ocorridas em cada dia vezes a porcentagem de espectadores para esse dia. Assim, é possível encontrar o número de espectadores que fizeram login ao assistir o vídeo naquele dia. Em seguida, o número de espectadores conectados pode ser adicionado durante todo o período e dividido pelo número total de visualizações para aquele período, para chegar à porcentagem de espectadores de todo o período.
- Não é possível calcular o número de espectadores únicos em 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 da30DayTotals
para extrapolar os dados sobre o número de espectadores únicos em um período de 30 dias. A dimensãomonth
se refere a meses, enquanto a dimensão30DayTotals
calcula períodos de 30 dias com base nas datas de início e término especificadas.
27 de junho de 2019
Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (Consultas segmentadas):
-
Como a versão 1 da API agora está totalmente descontinuada, a documentação foi atualizada para remover as referências a ela, incluindo o aviso de descontinuação e o guia de migração que explica como atualizar para a versão 2.
1º de novembro de 2018
Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (Consultas segmentadas):
-
A versão 1 da API foi descontinuada. Atualize seus clientes de API para que usem a versão 2 o quanto antes, caso ainda não tenha feito isso, e minimize as interrupções do serviço. Para mais detalhes, consulte o Guia de migração.
A programação dessa suspensão de uso foi anunciada originalmente em 26 de abril de 2018.
17 de setembro de 2018
Esta atualização contém as seguintes mudanças relacionadas à API YouTube Analytics (Consultas segmentadas):
-
A nova seção 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 pode não conter todos (ou nenhum) dados se:
-
um vídeo ou canal tem tráfego limitado durante um período específico
ou
-
você selecionou um filtro ou uma dimensão, como origem do tráfego ou país, em que os valores não atendem a um determinado limite.
A nova seção também inclui uma explicaçã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
eestimatedRedMinutesWatched
não são mais compatíveis com os relatórios de local de reprodução, origem de tráfego e tipo de dispositivo/sistema operacional.
18 de junho de 2018
Esta atualização contém as seguintes mudanças na API YouTube Analytics (Consultas segmentadas):
- Os requisitos de escopo dos métodos a seguir foram alterados:
- As solicitações para o método
reports.query
precisam ter acesso ao escopohttps://www.googleapis.com/auth/youtube.readonly
. - As solicitações para o método
groupItems.list
precisam ter acesso a:- no
https://www.googleapis.com/auth/youtube
escopo
ou - o escopo
https://www.googleapis.com/auth/youtube.readonly
e
o escopohttps://www.googleapis.com/auth/yt-analytics.readonly
A primeira opção usa um escopo, que é um escopo de leitura/gravação, enquanto a segunda usa dois escopos somente leitura.
- no
- As solicitações para o método
23 de maio de 2018
Esta atualização contém as seguintes mudanças na API YouTube Analytics (Consultas segmentadas):
- A visão geral da API contém uma nova seção, métricas agregadas e itens excluídos, que explica como as respostas da API lidam com os dados associados aos recursos excluídos, como vídeos, playlists ou canais.
- A seção de práticas recomendadas da visão geral da API foi atualizada para lembrar que você pode usar a API YouTube Data para recuperar metadados adicionais para os recursos identificados nas respostas da API YouTube Analytics. Conforme observado nas Políticas do desenvolvedor de serviços da API do YouTube (seções III.E.4.b a III.E.4.d), os clientes de APIs precisam excluir ou atualizar os metadados de recursos armazenados dessa API após 30 dias.
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 são aplicadas globalmente a todos os relatórios e jobs relacionados.
-
Depois da mudança, a maioria dos relatórios de API, incluindo os de preenchimento, vai ficar disponível por 60 dias a partir do momento em que forem gerados. No entanto, os relatórios 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 da API estavam disponíveis por 180 dias a partir do momento em que foram gerados. Para esclarecer, quando essa alteração na política entrar em vigor, 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 mais ser acessados. Sendo assim, a documentação agora determina que os relatórios criados antes da mudança da política estarão disponíveis por até 180 dias.
-
Após a alteração, quando você programar um trabalho de relatório, o YouTube gerará relatórios a partir desse dia e abrangendo o período de 30 dias anterior ao horário em que a tarefa foi agendada. Antes da mudança, quando você programar um trabalho de relatório, o YouTube gerará relatórios que abrangem o período de 180 dias anterior ao horário em que a tarefa foi agendada.
-
-
A seção de práticas recomendadas foi atualizada para lembrar que você pode usar a API YouTube Data para recuperar mais metadados dos recursos identificados nos relatórios. Conforme observado nas Políticas do desenvolvedor de serviços da API do YouTube (seções III.E.4.b a III.E.4.d), os clientes de APIs 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 que contêm dados de um período a partir de 1o de junho de 2018 não terão referências a recursos do YouTube que foram excluídos pelo menos 30 dias antes da data em que o relatório foi gerado.
-
A seção de dados históricos da visão geral da API foi atualizada para mostrar que, quando você programa um novo job de geração de relatórios, os relatórios geralmente são postados em alguns dias. Anteriormente, a documentação indicava que poderia levar até 30 dias para que esses relatórios fossem disponibilizados.
-
A seção de dados de preenchimento da visão geral da API foi atualizada para definir com mais clareza 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 do YouTube Analytics (Consultas segmentadas) (v2) já está disponível ao público. A lista a seguir identifica as alterações no produto e na documentação relacionadas à nova versão da API:
-
A API v2 é quase idêntica à API v1. No entanto, você provavelmente terá que atualizar seu código para refletir as alterações listadas abaixo. Todas essas mudanças são explicadas em detalhes no novo guia de migração.
- A versão da API mudou de
v1
parav2
. - O URL de base para solicitações de API mudou de
https://www.googleapis.com/youtube/analytics/v1
parahttps://youtubeanalytics.googleapis.com/v2
. - Vários parâmetros para o método
reports.query
têm nomes atualizados. Especificamente, nomes de parâmetros que contêm hifens, comoend-date
na API v1, usam letras concatenadas (endDate
) em vez de hifens na API v2. Essa mudança torna os nomes dos parâmetros consistentes em toda a API, uma vez que os métodos da API para criar e gerenciar grupos já usavam letras concatenadas nos nomes dos parâmetros. - A API v2 não aceita solicitações em lote enviadas para o endpoint de lote HTTP global do Google (
www.googleapis.com/batch
). Se você estiver enviando solicitações em lote na API v2, será necessário usar o endpointhttps://youtubeanalytics.googleapis.com/v2
.
Além disso, alguns recursos da v1 não são compatíveis com a API v2:
- O método
reports.query
não oferece mais suporte aos parâmetros de solicitaçãoalt
,quotaUser
euserIp
. - A API v2 não fornece um endpoint em lote que ofereça suporte a lotes compostos de solicitações para APIs diferentes. (Um lote pode ser composto de solicitações para diferentes métodos da mesma API, no entanto.) Essa descontinuação não é específica da 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.
- A versão da API mudou de
-
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 mudanças na API YouTube Analytics (Consultas segmentadas):
- Os relatórios demográficos dos espectadores, que agregam estatísticas de visualização com base na idade e no gênero dos espectadores, não são mais compatíveis com a dimensão
youtubeProduct
, que identifica o serviço do YouTube em que a atividade do usuário ocorreu.
18 de janeiro de 2018
Esta atualização contém as seguintes alterações:
-
API YouTube Reporting (relatórios em massa)
- A dimensão
operating_system
, que identifica o sistema de software do dispositivo em que as visualizações ocorreram, agora é compatível com o seguinte valor:25
: KaiOS
- A dimensão
-
API YouTube Analytics (consultas segmentadas)
- A dimensão
operatingSystem
é compatível com o valor de dimensãoKAIOS
.
- A dimensão
20 de dezembro de 2017
Esta atualização contém duas mudanças relacionadas à API YouTube Reporting:
-
O servidor da API agora oferece suporte à compactação gzip para solicitações que fazem o download de relatórios. A compactação gzip não é compatível com outros tipos de solicitações de API. Ativar a compactação gzip reduz a largura de banda necessária para cada resposta da API. 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
comogzip
, 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 recursoreport
. -
A documentação das dimensões
age group
egender
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 palavraAGE
e os números na faixa etária, e usam sublinhados em vez de hifens. Dessa forma, valores comoage13-17
eage18-24
foram corrigidos paraAGE_13_17
eAGE_18_24
, respectivamente. - Os valores da dimensão
gender
usam letras maiúsculas. Assim, os valoresfemale
,male
egender_other
foram corrigidos paraFEMALE
,MALE
eGENDER_OTHER
.
- Os valores da dimensão
10 de agosto de 2017
Em 10 de agosto de 2016, esta documentação anunciou a descontinuação da métrica earnings
da API YouTube Analytics. Ao mesmo tempo, a API adicionou suporte a uma nova métrica, chamada estimatedRevenue
, que fornece os mesmos dados.
Como earnings
era uma métrica principal, ela era aceita por um ano a partir da data do anúncio. No entanto, agora que esse período de um ano terminou, não é mais possível usar a métrica earnings
. 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 que estão sendo consultadas estão disponíveis.
Por exemplo, se uma solicitação especificar uma data de término em 5 de julho de 2017, e os valores de todas as métricas solicitadas estiverem disponíveis somente 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 4 de julho de 2017.
-
A dimensão
adType
agora é compatível com o valorreservedBumperInstream
, que se refere a um anúncio em vídeo não pulável de até seis segundos reproduzido antes da exibição do vídeo. O formato do anúncio é idêntico aoauctionBumperInstream
, mas esse tipo se refere a anúncios vendidos por reserva, e não por leilão.
-
-
API YouTube Reporting (relatórios em massa)
-
A dimensão
ad_type
agora é compatível com o valor20
, que se refere a anúncios bumper vendidos de forma reservada. Os anúncios bumper são anúncios em vídeo não puláveis de até seis segundos que são reproduzidos antes da exibição do vídeo. O valor19
para essa dimensão também se refere a anúncios bumper que são vendidos em leilão, não com base em reserva. -
Os jobs 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 anunciados como descontinuados em 15 de setembro de 2016, e relatórios não são mais gerados para eles após 15 de dezembro de 2016. Os relatórios gerados anteriormente permanecem disponíveis por 180 dias a partir do momento em que foram gerados. Portanto, alguns relatórios já estavam acessíveis até 15 de junho de 2017. No entanto, como os relatórios não estão mais disponíveis, os jobs associados a eles também não são necessários.
-
24 de maio de 2017
Todos os jobs 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 após 22 de setembro de 2016. Os relatórios gerados anteriormente permanecem disponíveis por 180 dias a partir do momento em que foram gerados. Portanto, alguns relatórios já estavam acessíveis no final 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 Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
Além disso, o nome usado para identificar o valor
52
foi atualizado na documentação para Kakao (Kakao Talk), a fim de diferenciá-lo mais claramente do valor73
(Kakao Story). Essa mudança não reflete nenhuma mudança no comportamento da API nem na classificação dos vídeos compartilhados com esses serviços.
- A dimensão
-
API YouTube Analytics (consultas segmentadas)
- A dimensão
sharingService
agora é compatível com os seguintes valores:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- A dimensão
28 de março de 2017
Os proprietários de canais que podem acessar os dados de receita com o YouTube Analytics no YouTube Studio agora também podem acessar esses dados pela API YouTube Analytics:
-
A API oferece suporte às seguintes métricas relacionadas à receita:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Essas métricas são compatíveis com os seguintes relatórios:
-
Os proprietários de canais agora também podem recuperar um Relatório de performance de anúncios, que oferece suporte às dimensões
adType
eday
, que é opcional. -
O guia de exemplos de solicitações da API YouTube Analytics agora inclui uma seção para relatórios de receita do canal.
17 de março de 2017
Esta atualização contém as seguintes alterações:
-
A API YouTube Analytics oferece suporte às métricas
redViews
eestimatedRedMinutesWatched
, ambas relacionadas às visualizações do YouTube Red. Na verdade, a API é compatível com essas métricas há algum tempo, e a API YouTube Reporting já é compatível com as duas métricas, conforme anunciado em 15 de setembro de 2016.- A métrica
redViews
identifica o número de vezes que um vídeo foi assistido por assinantes do YouTube Red. - A métrica
estimatedRedMinutesWatched
identifica por quantos minutos os assinantes do YouTube Red assistiram um vídeo.
A documentação dos relatórios de canal e dos relatórios do proprietário do conteúdo foi atualizada para mostrar quais relatórios suportam as duas novas métricas. Elas são aceitas em todos os relatórios que já aceitam as métricas
views
eestimatedMinutesWatched
. - A métrica
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 mostrar que o valor da dimensão se refere ao período que começa à 0h, no 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 geralmente 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 representam um período de 25 horas. Anteriormente, 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
: tizen23
: Firefox24
: RealMedia
-
Todos os jobs de relatório do tipo
content_owner_basic_a1
foram excluídos. Esse tipo de relatório foi totalmente descontinuado em 19 de agosto de 2016, mas os relatórioscontent_owner_basic_a1
gerados anteriormente ainda estavam disponíveis por 180 dias a partir do momento em que foram gerados. Portanto, alguns relatórios já estavam acessíveis até 19 de fevereiro de 2017. No entanto, como os relatórios não estão mais disponíveis, os jobs associados a eles também não são necessários.
-
-
API YouTube Analytics (consultas segmentadas)
-
A descrição das dimensões relacionadas a
time periods
foi corrigida para mostrar que o valor da dimensão se refere ao período que começa à 0h, 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 geralmente 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 representam um período de 25 horas. 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 de relatórios de canais foi atualizada para mostrar que esses relatórios não contêm métricas de ganhos ou de desempenho de anúncios no momento. Por isso, o escopo
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
não concede acesso a dados monetários em relatórios de canal no momento. - A dimensão
operatingSystem
é compatível com três novos valores:FIREFOX
REALMEDIA
TIZEN
-
8 de fevereiro de 2017
A API YouTube Analytics agora oferece suporte ao parâmetro opcional include-historical-channel-data
. 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 tempo de exibição dos canais e visualizar os dados do período anterior a quando os canais foram vinculados ao proprietário do conteúdo. O valor de parâmetro padrão é false
, o que significa que, por padrão, a resposta da API inclui apenas dados de visualização e tempo de exibição 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 de conteúdo em datas diferentes. Se a solicitação de API estiver recuperando dados de vários canais e o valor do parâmetro forfalse
, a resposta da API 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 vai 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 seguintes relatórios da API YouTube Reporting não têm mais suporte 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.
-
Relatórios do canal
channel_basic_a1
: substituído pelo relatório dechannel_basic_a2
.channel_province_a1
: substituído pelo relatório dechannel_province_a2
.channel_playback_location_a1
: substituído pelo relatório dechannel_playback_location_a2
.channel_traffic_source_a1
: substituído pelo relatório dechannel_traffic_source_a2
.channel_device_os_a1
: substituído pelo relatório dechannel_device_os_a2
.channel_subtitles_a1
: substituído pelo relatório dechannel_subtitles_a2
.channel_combined_a1
: substituído pelo relatório dechannel_combined_a2
.
-
Relatórios do proprietário do conteúdo
content_owner_basic_a2
: substituído pelo relatório decontent_owner_basic_a3
.content_owner_province_a1
: substituído pelo relatório decontent_owner_province_a2
.content_owner_playback_location_a1
: substituído pelo relatório decontent_owner_playback_location_a2
.content_owner_traffic_source_a1
: substituído pelo relatório decontent_owner_traffic_source_a2
.content_owner_device_os_a1
: substituído pelo relatório decontent_owner_device_os_a2
.content_owner_subtitles_a1
: substituído pelo relatório decontent_owner_subtitles_a2
.content_owner_combined_a1
: substituído pelo relatório decontent_owner_combined_a2
.content_owner_asset_basic_a1
: substituído pelo relatório decontent_owner_asset_basic_a2
.content_owner_asset_province_a1
: substituído pelo relatório decontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
: substituído pelo relatório decontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
: substituído pelo relatório decontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
: substituído pelo relatório decontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
: substituído pelo relatório decontent_owner_asset_combined_a2
.
A lista de 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:
-
Relatórios de telas finais
- O relatório de tela final para vídeos do canal contém estatísticas de todos os vídeos de um canal.
- O relatório de tela final para vídeos do proprietário do conteúdo contém estatísticas dos vídeos nos canais de qualquer proprietário.
- O relatório de tela final para recursos do proprietário do conteúdo contém estatísticas dos recursos associados aos vídeos após os quais as telas finais são exibidas.
-
Dimensões da tela final
end_screen_element_type
: o tipo de elemento da tela final associado às estatísticas.end_screen_element_id
: o ID que o YouTube usa para identificar de forma exclusiva o elemento da tela final.
Métricas da tela final
Observação:os dados das métricas de tela final estão disponíveis desde 1o de maio de 2016.
end_screen_element_impressions
: o número total de impressões do elemento da tela final. Uma impressão é registrada para cada elemento exibido na tela final.end_screen_element_clicks
: o número de vezes que os elementos da tela final foram clicados.end_screen_element_click_rate
: a taxa de cliques dos elementos da tela final.
-
Os relatórios 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 22 de junho de 2016.
content_owner_ad_performance_a1
: substituído pelo relatório decontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
: substituído pelo relatório decontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
: substituído pelo relatório decontent_owner_asset_estimated_revenue_a1
.
-
As métricas na lista a seguir foram totalmente descontinuadas e não são mais compatíveis. Conforme anunciado em 10 de agosto de 2016, novas métricas que se referem aos mesmos dados já estão disponíveis. A tabela abaixo mostra os nomes da métrica descontinuada e da nova:
Métrica descontinuada Nova métrica adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Receita de publicidade mensal e mundial por vídeo
- Receita diária de publicidade por país e 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)
-
A API suporta duas novas métricas relacionadas às visualizações do YouTube Red:
red_views
: o número de vezes que um vídeo foi assistido por assinantes do YouTube Red.red_watch_time_minutes
: o número de minutos em que os membros do YouTube Red assistiram um vídeo.
-
A API suporta as novas versões de 20 relatórios. Todas as novas versões são compatíveis com as novas métricas
red_views
ered_watch_time_minutes
.Para cada relatório, o número no novo ID de tipo de relatório é um número maior do que no ID de tipo de relatório antigo. As versões antigas desses relatórios foram descontinuadas, conforme descrito posteriormente neste histórico de revisões. Por exemplo, o relatório
channel_basic_a1
foi descontinuado e substituído pelo relatóriochannel_basic_a2
.As listas a seguir identificam os novos IDs de tipo de relatório:
Relatórios de vídeos do canal
Relatórios de vídeo do proprietário do conteúdo
Relatórios de recursos do proprietário do conteúdo
-
Observação:este é um anúncio de descontinuação.
Se você já tiver jobs para criar uma das versões mais antigas dos relatórios listados acima, precisará criar novos jobs para os relatórios renomeados. Em conjunto com o lançamento das novas versões de relatório, as seguintes versões foram descontinuadas:
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
Se você tiver tarefas para qualquer um desses relatórios, não espere que o YouTube gere novos relatórios para esses trabalhos depois de 15 de dezembro de 2016. Os relatórios gerados ficam disponíveis por 180 dias a partir do momento em que foram gerados.
-
O relatório
content_owner_basic_a1
foi totalmente descontinuado e removido da documentação. O YouTube não vai mais gerar novos relatórios desse tipo, embora os relatórios que já foram gerados continuem disponíveis por 180 dias a partir do momento em que foram gerados.A substituição do relatório
content_owner_basic_a1
é o relatóriocontent_owner_basic_a2
, conforme explicado na entrada do histórico de revisões de 19 de maio de 2016. -
Os Termos de Serviço da API YouTube recém-publicados ("os Termos atualizados"), que são abordados em detalhes no Blog de engenharia e desenvolvedores do YouTube e contêm um grande conjunto de atualizações dos Termos de Serviço atuais. Além dos Termos atualizados, que entrarão em vigor a partir de 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 de novos documentos está descrito no histórico de revisões dos termos atualizados. Além disso, as futuras alterações nos Termos Atualizados ou nos documentos complementares 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.
-
API YouTube Analytics (consultas segmentadas)
-
Observação:este é um anúncio de descontinuação.
As métricas na tabela a seguir estão sendo descontinuadas. Ao mesmo tempo, estão sendo introduzidas novas métricas referentes aos mesmos dados. Na verdade, isso significa que as métricas antigas serão renomeadas, mas a API YouTube Analytics será compatível com os dois nomes até as datas de descontinuação listadas na tabela.
Nome da métrica antigo Nome da nova 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 terá suporte por um ano a partir da data deste anúncio. As outras métricas, que não eram métricas 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. No entanto, após essa data, apenas a métricacpm
terá suporte. - A dimensão
insightTrafficSourceType
é compatível com dois novos valores de dimensão:CAMPAIGN_CARD
: esta origem de tráfego só é suportada por relatórios do proprietário do conteúdo. Ela indica que as visualizações se originaram de vídeos reivindicados enviados por usuários que o proprietário do conteúdo usou para promover o conteúdo visualizado.END_SCREEN
: os dados pertencem às visualizações originadas da tela final de outro vídeo.
Para ambas as origens de tráfego novas, você também pode recuperar um relatório
traffic source detail
. Em ambos os casos, a dimensãoinsightTrafficSourceDetail
identifica o vídeo do qual o espectador foi direcionado. -
A dimensão
adType
agora é compatível com o valorauctionBumperInstream
, que se refere a um anúncio em vídeo não pulável de até seis segundos 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ó é suportada por relatórios do proprietário do conteúdo. Ela indica que as visualizações se originaram de vídeos reivindicados enviados por usuários que o proprietário do conteúdo usou para promover o conteúdo visualizado.20
: os dados pertencem às visualizações originadas da tela final de outro vídeo.
Para as duas novas origens de tráfego, a dimensão
traffic_source_detail
identifica o vídeo 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 removerearnings
dessa lista. Nunca houve suporte à métricaearnings
na API YouTube Reporting. -
A dimensão
ad_type
agora é compatível com o valor19
, que se refere a anúncios bumper, que são anúncios em vídeo não puláveis com até seis segundos de duração.
- A dimensão
-
API YouTube Analytics (consultas segmentadas)
- As listas de métricas compatíveis com os seguintes relatórios de canal foram atualizadas para incluir as métricas do card. O suporte para métricas de cartão nesses relatórios foi adicionado em 28 de junho de 2016, e a entrada no histórico de revisões dessa data explica a alteração com mais detalhes. Os relatórios são:
- Atividade básica do usuário para estados dos EUA
- Atividade do usuário em estados nos EUA em períodos específicos
- Atividade do usuário por província
- Atividade do usuário por status de inscrição
- Atividade do usuário por status de inscrição para províncias
- Principais vídeos por estado
- Vídeos mais acessados para espectadores inscritos ou não
-
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 filtrogroup
não é compatível.Anteriormente, a documentação dos dois relatórios indicava incorretamente que o relatório podia ser recuperado com um desses dois filtros ou com nenhum deles.
- As listas de métricas compatíveis com os seguintes relatórios de canal foram atualizadas para incluir as métricas do card. O suporte para métricas de cartão nesses relatórios foi adicionado em 28 de junho de 2016, e a entrada no histórico de revisões dessa data explica a alteração com mais detalhes. Os relatórios são:
-
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 informar que o YouTube gera relatórios para download para os dias em que não havia dados disponíveis. Esses relatórios contêm uma linha de cabeçalho, mas não contêm dados adicionais. Essas informações já foram 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ãocard_id
. Antes, a documentação listava incorretamente o nome da dimensão comocard_title
.
- Estatísticas básicas(canais, proprietários do conteúdo)
- Com base no tempo(canais, proprietários do conteúdo)
- Localização do usuário (canais, proprietários do conteúdo)
- Atividade do usuário por status de inscrição (canais, proprietários do conteúdo)
- Principais vídeos (canais, proprietários 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 estão disponíveis pela API por 180 dias a partir do momento em que são gerados.
Anteriormente, 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 verdadeiro, o texto original era, na melhor das hipóteses, bastante confuso.
-
A API suporta as 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 docontent_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
chama-secontent_owner_estimated_revenue_a1
. - A nova versão do relatório
content_owner_asset_estimated_earnings_a1
chama-secontent_owner_asset_estimated_revenue_a1
.
Os dois relatórios recém-renomeados diferem dos antecessores das seguintes maneiras:
- Ele adiciona a nova métrica
estimated_partner_red_revenue
, que estima os ganhos totais das assinaturas do YouTube Red. - Ele adiciona a nova métrica
estimated_partner_transaction_revenue
, que estima a receita de transações como conteúdo pago e Financiamento por fãs, menos os reembolsos cobrados por parceiros. - Ele renomeou a métrica
estimated_partner_ad_sense_revenue
paraestimated_partner_ad_auction_revenue
. - Ele renomeou a métrica
estimated_partner_double_click_revenue
paraestimated_partner_ad_reserved_revenue
.
- A nova versão do relatório
Se você já tiver jobs para criar uma das versões mais antigas desses relatórios, será necessário criar novos jobs para os relatórios renomeados. Com o lançamento das novas versões, os relatórios
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
econtent_owner_asset_estimated_earnings_a1
foram descontinuados.Se você tiver jobs para qualquer um desses relatórios, não espere que o YouTube gere novos relatórios para esses jobs após 22 de setembro de 2016. Os relatórios gerados ficam disponíveis por 180 dias a partir do momento em que foram gerados.
-
-
A definição da propriedade
id
do recursoreportType
foi atualizada para refletir o conjunto atual de relatórios disponíveis. -
Os nomes de duas métricas foram corrigidos na documentação para corresponder aos nomes que aparecem nos relatórios. Isso é apenas uma correção da documentação e não reflete uma mudança no conteúdo real do relatório:
- O nome da métrica
estimated_partner_adsense_revenue
foi atualizado paraestimated_partner_ad_sense_revenue
. No entanto, essa métrica só aparece em dois relatórios que serão descontinuados com essa atualização. Conforme descrito acima, essa métrica foi renomeada comoestimated_partner_ad_auction_revenue
nas versões mais recentes desses relatórios. - O nome da métrica
estimated_partner_doubleclick_revenue
foi atualizado paraestimated_partner_double_click_revenue
. Vale lembrar que essa métrica só aparece em dois relatórios que serão descontinuados com essa atualização. Conforme descrito acima, essa métrica foi renomeada comoestimated_partner_ad_reserved_revenue
nas versões mais recentes desses relatórios.
- O nome da métrica
-
A documentação de dimensões da API Reporting foi atualizada para não listar mais as propriedades
elapsed_video_time_percentage
eaudience_retention_type
. No momento, essas dimensões não são compatíveis com os relatórios disponíveis pela API. -
A API é compatível com uma nova versão do Relatório de atividade do usuário para proprietários de conteúdo. O ID do tipo 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étricaslikes
edislikes
.Se você já tiver um job para criar o relatório
content_owner_basic_a1
, ainda será necessário criar um novo job para o relatóriocontent_owner_basic_a2
. O YouTube não está migrando automaticamente os proprietários de conteúdo para a nova versão do relatório nem criando um job para gerar essa nova versão. Em algumas implementações, a aparência de um job novo e inesperado pode representar uma alteração interruptiva.Junto com o lançamento do novo relatório, o relatório
content_owner_basic_a1
foi descontinuado. Se você tem um trabalho para esse relatório, não espere que o YouTube gere novos relatórios para esse trabalho depois de 19 de agosto de 2016. Os relatórios gerados ficam disponíveis por 180 dias a partir do momento em que foram gerados. -
Os recursos
reportType
,job
ereport
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 recursoreportType
especifica a data e a hora em que o tipo de relatório será descontinuado. Esta propriedade tem valor somente para relatórios que foram anunciados como obsoletos e representa a data em que o YouTube deixará de gerar relatórios desse tipo.Depois que um tipo de relatório é anunciado como suspenso, o YouTube gera relatórios desse tipo por mais três meses. Por exemplo, esta atualização de 19 de maio de 2016 anuncia a descontinuação do relatório
content_owner_basic_a1
. Portanto, odeprecateTime
para esse tipo de relatório especifica um período em 19 de agosto de 2016, período em que o YouTube deixará de gerar relatórios desse tipo. -
A propriedade
expireTime
do recursojob
especifica a data e a hora em que o job expirou ou irá expirar. Essa propriedade terá um valor se o tipo de relatório associado ao job tiver sido descontinuado ou se os relatórios gerados para o job não tiverem sido transferidos por download por um período prolongado. A data marca o momento após o qual o YouTube não gera mais novos relatórios para a tarefa. -
A propriedade
jobExpireTime
do recursoreport
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 propriedadeexpireTime
no recursojob
, conforme descrito no item anterior desta lista.
-
-
O método
jobs.create
agora retorna um código de resposta HTTP400
(Bad Request
) se você tentar criar um job para um relatório descontinuado. Além disso, a documentação do método lista agora vários outros motivos que causam falha em uma solicitação de API. -
Agora o YouTube gera dados que abrangem o período de 180 dias anterior ao horário em que um job de relatório foi agendado pela primeira vez. Antes, a API Reporting não fornecia dados históricos. Essa mudança afeta todas as tarefas, inclusive as criadas antes deste aviso.
Os relatórios históricos são postados assim que disponibilizados, 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 job de relatório, você terá acesso a cerca de sete meses de dados. (Todos os dados históricos das vagas criadas antes deste anúncio deverão ser postados dentro de 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 vagas criadas antes de 28 de dezembro de 2015 terão menos de 180 dias de dados históricos.
Essas mudanças são explicadas na nova seção 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 mudanças:
-
A documentação agora determina que os relatórios ficam disponíveis por um período de 180 dias após a geração e, portanto, disponíveis para download dos clientes da API. Anteriormente, 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 conterão dados adicionais.
-
-
Em breve, a API YouTube Reporting será compatível com um conjunto de relatórios gerados automaticamente e gerenciados pelo sistema que contêm dados de receita de publicidade ou de assinaturas do YouTube Red. Eles serão disponibilizados a proprietários de conteúdo que já podem acessar os relatórios de receita para download manualmente no YouTube Studio. Assim, a nova funcionalidade da API vai proporcionar acesso programático a esses dados.
As seguintes mudanças na API estão sendo anunciadas em preparação para o lançamento dos relatórios gerenciados pelo sistema:
-
A nova propriedade
systemManaged
do recursojob
indica se o recurso descreve uma tarefa 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étodojobs.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étodojobs.reports.list
indica que a resposta da API só vai conter relatórios se os dados mais antigos forem na data especificada ou depois dela. Da mesma forma, o parâmetrostartTimeBefore
indica que a resposta da API só deve conter relatórios se os dados mais antigos forem anteriores à data especificada.Ao contrário do parâmetro
createdAfter
do método, que pertence ao momento em que o relatório foi criado, os novos parâmetros são relacionados aos dados no relatório. -
A nova propriedade
systemManaged
do recursoreportType
indica se o recurso descreve um relatório gerenciado pelo sistema. -
O novo parâmetro
includeSystemManaged
do métodoreportTypes.list
indica se a resposta da API precisa incluir relatórios gerenciados pelo sistema. O valor padrão do parâmetro éfalse
.
-
- Na API YouTube Reporting, a dimensão
sharing_service
é compatível com estes novos valores:82
: caixa de diálogo de atividade do sistema iOS83
: Caixa de entrada do Google84
: Android Messenger
- Na API YouTube Analytics, a dimensão
sharingService
é compatível com estes novos valores:ANDROID_MESSENGER
: Android MessengerINBOX
: Caixa de entrada do GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: caixa de diálogo de atividade do sistema iOS
- 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 inicial ou na 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 oferece suporte a18
como um valor de dimensão. Este valor indica que as exibições de vídeo foram originadas de uma página que lista todos os vídeos em uma playlist. Esta fonte é diferente do tipo de origem14
, que indica que as visualizações ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist. - 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 inicial ou na 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 oferece suporte aYT_PLAYLIST_PAGE
como um valor de dimensão. Este valor indica que as exibições de vídeo foram originadas de uma página que lista todos os vídeos em uma playlist. Esta fonte é diferente do tipo de origemPLAYLIST
, que indica que as visualizações ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist. - Na API YouTube Reporting, a dimensão
operating_system
usa o valor21
para identificar as visualizações que ocorrem pelo Chromecast. - Na API YouTube Analytics, a dimensão
operatingSystem
usa o valorCHROMECAST
para identificar visualizações que ocorrem pelo Chromecast. -
A API YouTube Analytics agora oferece suporte a três novas dimensões de detalhes de reprodução, que podem ser usadas em vários relatórios do proprietário do canal e do conteúdo:
liveOrOnDemand
: esta dimensão indica se os dados do 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 a espectadores inscritos no canal do vídeo ou da playlist.youtubeProduct
: essa dimensão identifica a propriedade do YouTube em que a atividade do usuário ocorreu. Os valores possíveis incluem o site principal do YouTube (ou o app YouTube), o YouTube Gaming e o YouTube Kids.
A documentação foi atualizada para identificar novos relatórios detalhados de 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 relatório "Tipo de dispositivo" para canais, mostra o novo formato:
Conteúdo Dimensões: Obrigatório deviceType Use 0 ou mais day, liveOrOnDemand, subscribedStatus, youtubeProduct Métricas: Use 1 ou mais views e 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 os campos obrigatórios e opcionais é explicada na documentação dos relatórios do canal e do proprietário do conteúdo.
-
A API YouTube Analytics agora descarta automaticamente entidades para as quais o usuário da API não consegue recuperar dados de filtros com suporte a vários valores (
video
,playlist
echannel
). Anteriormente, o servidor da API simplesmente retornaria um erro se o usuário da API não conseguisse acessar dados de pelo menos um dos itens especificados.Por exemplo, suponha que um usuário envie uma solicitação de API em que o filtro
video
lista 20 IDs de vídeo. O usuário é proprietário de 18 dos vídeos. No entanto, um ID de vídeo identifica um vídeo de outro canal, e o 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 os dados dos 18 vídeos que o usuário da API possui. -
Se você solicitar dados para um
group
vazio do YouTube Analytics, a API agora 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 HTTP403
) 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 retornava um erro não autorizado quando você tentava recuperar os dados do relatório desse grupo. -
Agora, o método
groups.list
da API YouTube Analytics é compatível com paginação. Se a resposta da API não contiver todos os grupos disponíveis, o parâmetronextPageToken
da resposta vai especificar um token que poderá ser usado para recuperar a próxima página de resultados. Defina o parâmetropageToken
do método como esse valor para extrair resultados adicionais. -
A API YouTube Analytics agora é compatível com a métrica
redPartnerRevenue
, que informa a receita total estimada gerada pelas assinaturas do YouTube Red para as dimensões de relatório selecionadas. O valor da métrica reflete os ganhos dos conteúdos de música e não musical e está sujeito a ajuste no final do mês.A lista de relatórios do proprietário do conteúdo da API YouTube Analytics foi atualizada para identificar os relatórios de vídeo que suportam a métrica
redPartnerRevenue
:- Estatísticas básicas
- Com base no tempo
- Região geográfica do usuário
- Vídeos mais acessados: para este relatório,
redPartnerRevenue
também é suportado como uma métrica de classificação, o que significa que você pode recuperar uma lista de vídeos classificados de acordo com seus ganhos no YouTube Red.
-
A definição do relatório de principais vídeos para a API YouTube Analytics agora reflete que esse relatório também é compatível com as seguintes métricas de ganhos:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
eimpressionBasedCpm
. -
A documentação da dimensão
date
da API YouTube Reporting foi corrigida para refletir que as datas fazem referência ao período de 24 horas que começa às 0h, horário do Pacífico (UTC-8). Anteriormente, a documentação indicava que a data começava à 0h (GMT).Além disso, a documentação da API YouTube Analytics foi atualizada para mostrar que todas as dimensões relacionadas a datas (
day
,7DayTotals
,30DayTotals
emonth
) 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 é compatível com o parâmetro de consultacreatedAfter
. Se especificado, esse parâmetro indica que a resposta da API deve listar apenas os relatórios criados após a data e a hora especificadas, incluindo novos relatórios com dados preenchidos. O valor do parâmetro refere-se ao momento em que o relatório é criado, e não às datas associadas aos dados retornados.O valor do parâmetro é um carimbo de data/hora no formato UTC "Zulu" RFC3339, precisamente medido em 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 recursojob
e as propriedadesstartTime
,endTime
ecreateTime
do recursoreport
foram corrigidas para indicar que os valores da propriedade são precisos em microssegundos, não em nanossegundos. Além disso, todas as definições agora refletem com precisão que o valor da propriedade é um carimbo de data/hora. -
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 que59
são os novos da lista. -
A nova API YouTube Reporting recupera relatórios de dados em massa que contêm dados do YouTube Analytics de um proprietário de conteúdo ou canal. Ele foi desenvolvido 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 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 trabalhos de relatórios, cada um dos quais identifica um relatório que o YouTube deve gerar. Depois que você configura uma tarefa, o YouTube gera um relatório diário que pode ser transferido por download de forma assíncrona. Cada relatório contém dados de um período exclusivo de 24 horas.
-
Embora sejam APIs diferentes, a API 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 das duas APIs está sendo publicada como um único conjunto de documentação.
- A guia Guias no conjunto da documentação contém informações comuns às duas APIs, incluindo instruções para autorizar solicitações de API.
- A guia Relatórios em massa contém documentação de referência e outros tipos de conteúdo especificamente para a API YouTube Reporting.
- A guia Consultas segmentadas contém documentação de referência e outros tipos de conteúdo especificamente para a API YouTube Analytics.
- A guia Amostras lista amostras de código disponíveis para qualquer uma das duas APIs.
- A guia Tools lista recursos adicionais disponíveis para ajudar os desenvolvedores a implementar uma das duas APIs.
-
A documentação da API foi reestruturada para facilitar o entendimento da API. Assim, essas alterações 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. Anteriormente, a documentação tinha páginas separadas para relatórios de vídeos de canais, de playlists de canais e assim por diante.
-
A nova visão geral do modelo de dados busca fornecer uma introdução mais clara de 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 dessa página estavam anteriormente em outras páginas. A nova página foi projetada para ajudar você a identificar mais facilmente as informações que precisa enviar para recuperar um relatório.
-
-
A nova métrica
adEarnings
inclui o total de ganhos estimados (receita líquida) de todas as fontes de publicidade vendidas pelo Google. Não é uma métrica principal. A API é compatível com a métricaadEarnings
para qualquer relatório que já seja compatível com a métricaearnings
.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. Anteriormente, 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étricagrossRevenue
para recuperar dados de receita. -
Além da métrica
primaryAdGrossRevenue
descontinuada, os relatórios de desempenho de anúncios não são mais compatíveis com as métricasmonetizedPlaybacks
eplaybackBasedCpm
. No entanto, vários relatórios de vídeo ainda oferecem suporte a essas métricas. -
A API agora é compatível com duas novas métricas para relatórios de vídeo,
videosAddedToPlaylists
evideosRemovedFromPlaylists
. 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 às playlists de outros canais.videosRemovedFromPlaylists
– O número de vezes que os vídeos no escopo da consulta foram removidos de qualquer playlist do YouTube. Os vídeos podem ter sido removidos da playlist do proprietário do vídeo ou de playlists de outros canais.
As duas métricas incluem playlists padrão, como a playlist "Assistir mais tarde". No entanto, elas não contam 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 delas.
Os dados dessas métricas estão disponíveis desde 1o de outubro de 2014.
-
As métricas
favoritesAdded
efavoritesRemoved
foram descontinuadas em vigor a partir deste anúncio. Essas são as principais métricas e estão sujeitas à política de descontinuação definida nos Termos de Serviço. -
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étricasearnings
,grossRevenue
,playbackBasedCpm
eimpressionBasedCpm
na moeda especificada. Os valores retornados são estimativas calculadas usando taxas de câmbio que mudam diariamente.O valor do parâmetro é um código de moeda ISO 4217 de três letras. O valor padrão é
USD
. A definição do parâmetro contém uma lista de códigos de moeda aceitos. -
A API agora permite criar e gerenciar grupos do YouTube Analytics e recuperar dados de relatório desses grupos.
-
Como criar e gerenciar grupos
Esta atualização apresenta os recursos
group
egroupItem
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étodoslist
,insert
,update
edelete
para esse recurso. - O recurso
groupItem
representa um item em um grupo do Google Analytics. A API oferece suporte aos métodoslist
,insert
edelete
para esse recurso.
Por exemplo, é possível criar um grupo usando o método
groups.insert
e, em seguida, adicionar itens a ele usando o métodogroupItems.insert
. - O recurso
-
Recuperar dados do relatório de um grupo
A documentação de dimensões foi atualizada para incluir
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 filtrogroup
, a API retorna dados de todos os itens desse grupo. No momento, a API não oferece suporte à capacidade de gerar relatórios para grupos de recursos.
Acesse a Central de Ajuda do YouTube para mais informações sobre os grupos do YouTube Analytics.
-
-
A API não oferece mais suporte à dimensão
show
. -
A API agora permite especificar vários valores para as dimensões
video
,playlist
,channel
eshow
quando elas são usadas como filtros. Para especificar diversos valores, defina o valor do parâmetrofilters
como uma lista separada por vírgulas de IDs de vídeos, playlists, canais ou programas que terão a resposta da API filtrada. O valor do parâmetro pode especificar até 200 IDs.Se você especificar diversos valores para o mesmo filtro, também será possível 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 determinado relatório. 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. -
Ao recuperar um relatório de canal, agora você pode recuperar dados do canal do usuário autenticado. Para isso, defina o valor do parâmetro
ids
comochannel==MINE
. Você também pode definir o parâmetroids
comochannel==CHANNEL_ID
para recuperar dados para o canal especificado. -
A API agora suporta relatórios de listas de reprodução, os quais 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
eestimatedMinutesWatched
, e alguns também oferecem suporte à métricaaverageViewDuration
.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
: o número médio de visualizações de vídeo que ocorriam cada vez que uma playlist era iniciada.averageTimeInPlaylist
: o tempo médio estimado, em minutos, que um espectador assistiu a vídeos em uma playlist após o início dela.
Qualquer solicitação para recuperar um relatório de playlists precisa usar o filtro
isCurated
, que precisa ser definido como1
(isCurated==1
). -
Agora a API é compatível com relatórios de retenção de público. Esse relatório mede a capacidade de um vídeo de manter o público. A nova dimensão
elapsedVideoTimeRatio
do relatório mede o tempo de reprodução do vídeo para os valores de métrica correspondentes:-
A métrica
audienceWatchRatio
identifica a proporção absoluta de espectadores que estão assistindo o vídeo em um determinado ponto do vídeo. Ela é 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 de um vídeo pode ser assistida mais de uma vez (ou não ser assistida) em uma determinada exibição de vídeo. Por exemplo, se os usuários retrocedem e assistem à mesma parte de um vídeo várias vezes, a proporção absoluta dessa parte do vídeo pode ser maior que
1
. -
A métrica
relativeRetentionPerformance
mostra a retenção de espectadores de um vídeo durante as reproduções em comparação com todos os vídeos do YouTube de duração semelhante. Um valor de 0 indica que o vídeo retém espectadores pior do que qualquer outro vídeo de duração semelhante, enquanto o 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, e a outra metade, pior.
Também é possível usar o filtro
audienceType
para que o relatório retorne somente 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 de uma ação do usuário, como pesquisar um vídeo ou clicar em um vídeo sugerido. -
-
A API oferece suporte a várias novas métricas relacionadas a anotações. As métricas listadas abaixo podem ser recuperadas com qualquer relatório que anteriormente aceitava as métricas
annotationClickThroughRate
eannotationCloseRate
.annotationImpressions
: o número total de impressões de anotação.annotationClickableImpressions
: o número de anotações que apareceram e receberam cliques.annotationClosableImpressions
: o número de anotações que apareceram e podem ser fechadas.annotationClicks
: o número total de anotações clicadas.annotationCloses
: o número total de anotações fechadas.
Todas as novas métricas são métricas principais e estão sujeitas à política de descontinuação. No entanto, os dados para as novas métricas estão disponíveis a partir de 16 de julho de 2013. Os dados para as métricas
annotationClickThroughRate
eannotationCloseRate
estão disponíveis desde 10 de junho de 2012. -
GOOGLE_SEARCH
não é mais informado como um valor separado para a dimensãoinsightTrafficSourceType
. Em vez disso, as referências dos resultados da pesquisa do Google agora são atribuídas ao tipo de origem de tráfegoEXT_URL
. Como resultado, também não é mais possível recuperar um relatórioinsightTrafficSourceDetail
que define o filtroinsightTrafficSourceType
comoGOOGLE_SEARCH
. -
O documento relatórios do proprietário do conteúdo foi atualizado para refletir que as métricas
subscribersGained
esubscribersLost
agora podem ser recuperadas para conteúdo reivindicado ou enviado por um proprietário do conteúdo.A mudança fica visível no primeiro relatório de estatísticas básicas para proprietários de conteúdo, que agora é compatível com os filtros
claimedStatus
euploaderType
. -
O documento exemplos de solicitações foi reformulado para agrupar exemplos em categorias, usando um formato de guia semelhante ao lançado recentemente para os relatórios do proprietário do canal e do conteúdo. Com o novo design, os exemplos são agrupados nas seguintes categorias:
- Estatísticas básicas
- Por períodos
- Geográfico
- Local da visualização
- Origem do tráfego
- Dispositivo/SO
- Informações demográficas
- Mídias sociais
- 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 recuperação de dados específicos de províncias em relatórios de canal ou relatórios do proprietário do conteúdo.
-
Métricas específicas da província para os estados dos EUA e Washington D.C.: Esse relatório exibe um detalhamento das contagens de visualizações, província por província, e outras estatísticas dos vídeos de um canal. Os dados abrangem os estados dos EUA e Washington D.C. O exemplo usa a dimensão
province
e o parâmetrofilters
para restringir a resposta para incluir somente resultados para os Estados Unidos. -
Informações demográficas do espectador na Califórnia (idade e gênero): esse relatório analisa estatísticas sobre a idade e o gênero dos espectadores na Califórnia que assistiram os vídeos de um canal ou, para relatórios do proprietário do conteúdo, o conteúdo reivindicado pelo proprietário do conteúdo. 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 mostrar que, quandoprovince
é incluído no valor do parâmetrodimensions
, a solicitação também precisa restringir os dados aos Estados Unidos incluindocountry==US
no valor do parâmetrofilters
. -
Os documentos que listam os relatórios compatíveis de canal e proprietário do conteúdo foram reformulados. Em vez de fornecer uma tabela que liste 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
- Mídias sociais
- Vídeos mais acessados
Cada documento mostra essas categorias como uma lista de guias, e você pode clicar em qualquer guia para conferir os relatórios compatíveis com ela.
-
A API agora oferece suporte a três novas dimensões geográficas:
province
,continent
esubContinent
.-
A dimensão
province
permite recuperar estatísticas dos 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 dividem as estatísticas por estado. Ambos os relatórios estão disponíveis para canais e proprietários do conteúdo.
- O relatório de estatísticas principais fornece várias estatísticas, incluindo contagens de visualizações e estimativa de minutos assistidos.
- O relatório com base em tempo fornece as mesmas estatísticas, mas agrega dados diários, por 7 dias, 30 dias ou mensalmente.
-
É possível usar o parâmetro de consulta
filters
para restringir um relatório para conter apenas as estatísticas de um determinado estado. Vários relatórios oferecem suporte a esse tipo de filtragem, incluindo relatórios geográficos, de locais de reprodução, de origens de tráfego, de dispositivos, de sistemas operacionais, informações demográficas e dos principais vídeos.
-
-
A dimensão
continent
especifica um código de região estatístico das Nações Unidas (ONU) que identifica um continente. Essa dimensão só pode ser usada como filtro. -
A dimensão
subContinent
especifica um código de região estatística das Nações Unidas (ONU) que identifica uma sub-região de um continente. Essa dimensão também só pode ser usada como filtro.Como cada sub-região está associada apenas a um continente, não é necessário usar o filtro
continent
aosubContinent
. Na verdade, a API retornará um erro se uma solicitação usar as duas dimensões.
-
-
A documentação foi corrigida para que a dimensão
insightTrafficSourceDetail
não inclua o valorinsightTrafficSourceType
PROMOTED
como um valor de filtro válido. -
A API YouTube Analytics agora está sujeita à política de descontinuação descrita nos Termos de Serviço. No entanto, as dimensões e métricas não essenciais da API não estão sujeitas à política de descontinuação. As páginas dimensões e metrics foram atualizadas para listar dimensões e métricas principais. Além disso, as definições nessas páginas foram atualizadas para identificar explicitamente as principais dimensões e métricas.
-
A API agora oferece suporte a
EXTERNAL_APP
como um valor para a dimensãoinsightPlaybackLocationType
. Com essa atualização, desde 10 de setembro de 2013, as reproduções não são mais categorizadas comoMOBILE
. 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
ouEXTERNAL_APP
, dependendo do tipo de app em que elas ocorrem. -
A API agora oferece suporte a
PLAYLIST
como um valor para a dimensãoinsightTrafficSourceType
. O valor indica que as exibições de vídeo foram direcionadas de uma playlist. Antes, essas vistas eram classificadas usando a categoriaYT_OTHER_PAGE
da dimensão. -
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
deday,-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 oferece suporte a duas novas dimensões,
deviceType
eoperatingSystem
, que podem ser usadas para recuperar dados sobre os dispositivos em que os espectadores estão assistindo seus vídeos. A API suporta relatórios que usam uma ou as duas dimensões.-
O relatório de
deviceType
permite recuperar as contagens de visualizações e o tempo de exibição estimado para diferentes tipos de dispositivos, incluindo computadores, smartphones e tablets. Também é possível usar o filtrooperatingSystem
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 filtrodeviceType
para restringir o relatório de sistema operacional para conter apenas estatísticas para um tipo específico de dispositivo, como dispositivos móveis ou tablets.
Os novos relatórios de tipo de dispositivo e de sistema operacional estão disponíveis para canais e proprietários do conteúdo.
-
-
O documento exemplo de solicitações foi atualizado para incluir três relatórios de dispositivo para canais e três para proprietários do conteúdo.
-
A dimensão
insightPlaybackLocationType
pode retornar o valorYT_OTHER
, que identifica visualizações que não são classificadas usando um dos outros valores da dimensão. -
O documento relatórios do proprietário do conteúdo foi atualizado para refletir que você pode classificar o relatório dos principais vídeos em ordem decrescente de ganhos para identificar os vídeos com os maiores ganhos. Esse relatório é o primeiro da segunda tabela da seção Relatórios de atividade do usuário e ganhos.
-
O YouTube não identifica mais os recursos e serviços experimentais da API. Em vez disso, agora, fornecemos uma lista de APIs do YouTube que estão sujeitas à política de suspensão de uso.
-
Agora, a API permite recuperar métricas de tempo de exibição (
estimatedMinutesWatched
,averageViewDuration
eaverageViewPercentage
) em conjunto com outras, incluindo métricas de visualização, engajamento, ganhos e 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
einsightTrafficSourceDetail
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 filtrocountry
opcional.-
Detalhe do local da reprodução
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Detalhe da origem do tráfego
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
O novo documento Exemplos de solicitações de API fornece exemplos que demonstram como recuperar vários 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 oferece suporte aSUBSCRIBER
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 nesta origem de tráfego, o campoinsightTrafficSourceDetail
especificará o feed da página inicial ou outra página a partir da qual as visualizações foram direcionadas. -
A API agora oferece suporte a duas novas métricas,
annotationClickThroughRate
eannotationCloseRate
, que estão relacionadas às interações do espectador com anotações que são exibidas durante os vídeos. As listas de relatórios de canal e relatórios do proprietário do conteúdo foram atualizadas para identificar os relatórios que suportam as novas métricas.annotationClickThroughRate
: a proporção de anotações em que os espectadores clicaram em relação ao número total de impressões de anotações clicáveis.annotationCloseRate
: a proporção de anotações que os espectadores fecharam em relação ao número total de impressões de anotaçõ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, somada e classificada de acordo com o tipo de anúncio principal para as reproduções de vídeo abrangidas pelo relatório, 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 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 desempenho de anúncios precisa enviar um token de autorização que conceda acesso usando o novo escopo
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
.
-
-
A documentação da API foi reorganizada para que diferentes tipos de relatórios sejam explicados em páginas separadas. Como tal, agora, há páginas separadas que explicam os diferentes tipos de relatórios de canal e relatórios do proprietário do conteúdo.
-
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 aplicativo de amostra.
-
O guia de referência da API agora apresenta o 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 metrics 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.
-
-
O YouTube Analytics API já está disponível para todos os desenvolvedores. Você pode ativar a API para seu projeto, sem precisar solicitar acesso primeiro, no painel Serviços na APIs console.
-
A nova seção Como começar descreve os pré-requisitos e as etapas básicas para criar um aplicativo que usa a YouTube Analytics API.
-
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 de dimensões da entidade do relatório foi atualizada para mostrar 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
oushow
) ou uma combinação compatível das dimensõesclaimedStatus
euploaderType
. -
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 metrics
subscribersGained
esubscribersLost
foram atualizadas para explicar que um canal pode ganhar ou perder inscritos em vários lugares, incluindo a página de exibição do vídeo, a página do canal e o guia que aparece na página inicial do YouTube. Quando aparecem em um relatório específico do vídeo, essas métricas incluem apenas as estatísticas da página de exibição do vídeo especificado.
A API YouTube Reporting oferece suporte a três novos relatórios de tela final, além de novas dimensões e métricas para esses relatórios. Os relatórios fornecem estatísticas de impressão e de cliques para as telas finais exibidas após a interrupção da reprodução de um vídeo.
A Central de Ajuda do YouTube tem informações mais detalhadas sobre como adicionar telas finais aos seus vídeos.
8 de novembro de 2016
Esta atualização contém as seguintes mudanças na API YouTube Analytics:
27 de outubro de 2016
Agora o YouTube gera automaticamente um conjunto de relatórios de receita de anúncios gerenciados pelo sistema para proprietários de conteúdo que têm acesso aos relatórios correspondentes na seção Relatórios do Estúdio de Criação do YouTube. Os novos relatórios da API gerenciada pelo sistema foram projetados para oferecer acesso programático aos dados que também estão disponíveis nos relatórios do Estúdio de Criação, que podem ser baixados manualmente.
A visão geral dos relatórios gerenciados pelo sistema traz uma visão geral dos novos relatórios e explica o processo para recuperá-los pela API. Esse processo é um pouco diferente do 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:
27 de setembro de 2016
Observação:este é um anúncio de descontinuação.
O uso da métrica uniques
da API YouTube Analytics foi descontinuado. Essa não é uma métrica principal e terá suporte 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:
11 de agosto de 2016
Esta atualização contém as seguintes alterações:
10 de agosto de 2016
Essa atualização inclui as seguintes alterações:
18 de julho de 2016
Essa atualização inclui as seguintes alterações:
28 de junho de 2016
A documentação da API YouTube Analytics foi atualizada para refletir o suporte para métricas de cards em vários relatórios de canais e proprietários do conteúdo. As novas métricas são:
As métricas são compatíveis com os seguintes tipos de relatórios:
22 de junho de 2016
Esta atualização contém as seguintes mudanças na API YouTube Reporting. A primeira alteração diz respeito à API em geral, e as demais afetam apenas os relatórios do proprietário do conteúdo:
19 de maio de 2016
Esta atualização contém as seguintes mudanças na API YouTube Reporting:
12 de abril de 2016
Esta atualização contém as seguintes mudanças, que afetam apenas a API YouTube Reporting:
28 de março de 2016
A API de relatórios do YouTube e a API do YouTube Analytics agora retornam estatísticas de visualização para diversos serviços de compartilhamento adicionais.
16 de março de 2016
Essa atualização contém as seguintes mudanças, que afetam a API YouTube Reporting e a API YouTube Analytics:
API YouTube Reporting
API YouTube Analytics
8 de fevereiro de 2016
A lista de métricas compatíveis com a API YouTube Analytics foi atualizada para que as métricas de card não sejam mais compatíveis com essa API. Nenhum dos relatórios dessa API foi documentado como suporte a qualquer uma das métricas do card.
Você ainda pode recuperar as métricas dos cards usando a API YouTube Reporting, que é compatível com essas métricas para vários relatórios de canais e proprietários do conteúdo.
6 de janeiro de 2016
As APIs YouTube Reporting e YouTube Analytics agora identificam especificamente as visualizações que ocorrem em um dispositivo Chromecast.
21 de dezembro de 2015
Na documentação, os nomes das métricas annotation_clickable_impressions
e annotation_closable_impressions
foram atualizados para corresponder aos nomes retornados nos relatórios. Anteriormente, os nomes eram documentados como clickable_annotation_impressions
e closable_annotation_impressions
.
18 de dezembro de 2015
As leis da União Europeia (UE) exigem que certas divulgações sejam fornecidas e recebam o consentimento dos usuários finais na UE. Portanto, os usuários finais da 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
Essa atualização contém as seguintes mudanças, que afetam a API YouTube Analytics:
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:
8 de outubro de 2015
Esta atualização contém as seguintes alterações:
24 de setembro de 2015
Esta atualização contém as seguintes alterações:
20 de agosto de 2015
Esta atualização contém as seguintes alterações:
22 de julho de 2015
Esta atualização contém várias mudanças, e todas elas se aplicam somente aos proprietários do conteúdo:
1o de junho de 2015
Esta atualização contém as seguintes alterações:
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:
25 de fevereiro de 2015
Esta atualização contém as seguintes alterações:
13 de fevereiro de 2015
Esta atualização contém as seguintes alterações:
28 de agosto de 2014
Esta atualização contém as seguintes alterações:
16 de julho de 2014
Esta atualização contém as seguintes alterações:
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:
6 de janeiro de 2014
Esta atualização contém as seguintes alterações:
30 de setembro de 2013
Esta atualização contém as seguintes alterações:
16 de julho de 2013
Esta atualização contém as seguintes alterações:
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:
03 de maio de 2013
Esta atualização contém as seguintes alteraçõ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:
04 de fevereiro de 2013
Esta atualização contém as seguintes alterações:
14 de novembro de 2012
Esta atualização contém as seguintes alterações:
02 de outubro de 2012
Esta atualização contém as seguintes alterações:
12 de setembro de 2012
Esta atualização contém as seguintes alterações: