Como exportar e conferir seu histórico de exibição do YouTube

Defina o que você precisa conferir

A pergunta do leitor pede um “histórico de exibição completo do YouTube”. Isso exige duas verificações diferentes: se a tabela preserva os eventos exportados e se o arquivo de exportação abrange o histórico esperado.

Você pode comparar a tabela com seus arquivos de origem. Esses arquivos, sozinhos, não permitem comprovar a cobertura completa de todo o histórico da conta. Uma pergunta pública de um titular de conta relata uma exportação incompleta do Takeout. Esse é um relato de uma lacuna. Ele não estabelece uma taxa de falha nem um método que garanta um histórico completo.

Planeje salvar três registros:

1. Uma anotação privada sobre o arquivo de exportação solicitado e seu conteúdo.
2. Uma tabela de eventos de visualização que preserve as visualizações repetidas e os horários originais.
3. Uma tabela opcional de vídeos públicos, com um resultado selecionado por ID de vídeo.

Um ID é um valor que identifica um item. O ID de um vídeo identifica o vídeo, não um evento de visualização. Mantenha esses dois usos separados durante todo o método.

Solicite seu arquivo de exportação e registre seu escopo

Use apenas sua própria Conta do Google. Acesse a página do Google Takeout com sua conta conectada pelo guia oficial de download.

Não dependa de um caminho fixo de menus nem de um nome de arquivo específico. Examine as opções atuais de produtos e de dados incluídos.

1. Selecione os dados do YouTube ou de atividade da conta necessários para seu histórico de exibição.
2. Registre a conta e os dados selecionados em uma anotação privada.
3. Registre a data da solicitação.
4. Solicite o arquivo de exportação.
5. Baixe todas as partes do arquivo de exportação fornecidas para essa solicitação.
6. Registre a data de criação do arquivo de exportação, o formato dos arquivos e os nomes das partes.
7. Mantenha os arquivos originais sem alterações.
8. Abra uma cópia de trabalho e confirme que ela contém eventos de visualização.

A atividade de pesquisa e as inscrições em canais não comprovam quais vídeos você assistiu. Confirme o tipo de registro pelo conteúdo real antes de contar as linhas.

Os dados selecionados definem o escopo solicitado: os dados da conta que você pediu ao Google para incluir. Registre separadamente o conteúdo que de fato recebeu. A seleção de uma categoria, por si só, não comprova que os arquivos baixados contêm todos os registros esperados.

Mantenha o arquivo de exportação privado. A consulta pública opcional precisa de IDs ou links de vídeos públicos selecionados. Ela não precisa do arquivo de exportação nem das credenciais da sua conta. Baixar seus dados não exclui a cópia na nuvem. Escopo e limites da exportação do Google

Crie uma tabela que preserve cada evento de visualização

Leia os nomes reais dos campos antes de importar os arquivos. Não presuma uma estrutura fixa de arquivos, um formato de data ou um campo de vídeo.

Crie uma linha de trabalho para cada evento de visualização da origem. Mantenha todos os campos originais. Acrescente referências que permitam encontrar o evento no arquivo de exportação sem alterações.

Os campos abaixo são sugestões para sua tabela de trabalho. Não há garantia de que sejam os cabeçalhos da exportação do Google.

Um registro de data e hora armazena uma data e um horário. Um horário normalizado é um segundo valor convertido para um padrão comum. Nenhum deles deve substituir o valor original da origem.

Uma referência de origem localiza um evento no arquivo de exportação salvo. Ela não é necessariamente um ID de evento estável entre exportações diferentes. Números de linha iguais em dois arquivos não comprovam que os eventos sejam iguais.

A ausência de um link de vídeo não apaga um evento de visualização registrado. Mantenha o evento e marque a identidade do vídeo como não resolvida. Da mesma forma, um campo vazio indica que falta informação. Ele não significa zero visualizações.

Determine os horários sem alterar seu significado

O horário de visualização, o horário de publicação do vídeo e o horário da consulta pública descrevem eventos diferentes.

Interprete uma data apenas quando souber seu formato. Interpretar significa ler o texto armazenado como uma data e um horário. Uma data ambígua deve permanecer não resolvida até que você consiga estabelecer seu significado.

1. Mantenha o registro original de data e hora sem alterações.
2. Identifique o formato da data a partir da origem.
3. Identifique o fuso horário ou a diferença de horário, se fornecido.
4. Converta o valor apenas quando essas informações forem conhecidas.
5. Salve o valor convertido ao lado do valor original.
6. Registre qualquer problema de horário não resolvido.

UTC significa Tempo Universal Coordenado, uma referência comum de tempo. Você pode salvar um valor normalizado em UTC quando for possível determinar o horário da origem. Não atribua um fuso horário apenas porque seu computador o utiliza.

Não use o horário da importação como horário da visualização. Não use o horário de publicação do vídeo para preencher um horário de evento ausente. Se depois você agrupar as visualizações por dia, informe o fuso horário do relatório. Resolva as dúvidas sobre horários antes de tratar os totais diários como resultados conferidos.

Mantenha as visualizações repetidas e remova apenas cópias comprovadas da importação

Dois eventos podem ter o mesmo ID de vídeo, título ou data. Isso não os torna eventos duplicados.

Por exemplo, uma visualização pela manhã e outra à noite do mesmo vídeo continuam em duas linhas. Remover linhas pelo ID do vídeo eliminaria parte do histórico registrado.

Deduplicação significa remover cópias confirmadas do mesmo registro. Faça isso apenas quando houver evidências de que a importação criou essas cópias. Importar duas vezes o mesmo arquivo de exportação sem alterações é um caso que você pode investigar pelas referências do arquivo de exportação, do arquivo de origem e da entrada de origem.

1. Conte as linhas de eventos de visualização importadas.
2. Confira se alguma parte do arquivo de exportação foi importada duas vezes.
3. Identifique cópias de registros de origem por suas referências de origem.
4. Remova apenas as cópias extras comprovadas.
5. Registre quantas cópias você removeu e por quê.
6. Salve a contagem de eventos mantidos antes de acrescentar dados públicos.

IDs de vídeo ou registros de data e hora iguais, por si só, não comprovam que duas linhas sejam cópias. Arquivos de exportação com sobreposição exigem uma revisão separada dos registros. Não combine correspondências incertas em um único evento.

Decida se você precisa de dados públicos dos vídeos

Você pode encerrar o trabalho com a tabela de eventos conferida se ela responder à sua pergunta.

Metadados opcionais podem acrescentar títulos atuais, dados dos canais e contagens públicas. Metadados são informações sobre um item. Eles descrevem o vídeo; não comprovam outro evento de visualização.

O Chronometrica YouTube Metrics Scraper é um Actor, um programa de coleta de dados hospedado. Suas entradas documentadas incluem IDs conhecidos e links de vídeos. Ele também permite descobrir canais públicos, algo desnecessário para conferir este arquivo de exportação.

O Actor lê metadados e métricas públicos dos vídeos. Métricas são contagens, como visualizações ou curtidas públicas. Ele não lê históricos de exibição pessoais nem vídeos privados. Ele não coleta o texto dos comentários nem fornece impressões, taxa de cliques ou retenção do YouTube Studio.

Prepare uma lista separada de IDs conhecidos de vídeos públicos, sem repetições. Isso reduz consultas públicas repetidas e preserva cada evento de visualização. O guia de corpus de transcrições também separa as ocorrências repetidas nas fontes das identidades únicas dos vídeos. Aqui, a lista sem repetições serve apenas para a consulta opcional. Sua tabela de eventos deve manter as visualizações repetidas.

Se depois você precisar do texto falado em um vídeo, use o guia de extração de legendas, que é separado. As legendas não comprovam se você assistiu a um vídeo nem quando o assistiu.

Configure a consulta pública opcional

A Task youtube-engagement-metrics-tracker oferece uma configuração inicial. Uma Task é uma configuração de entrada de um Actor salva para reutilização.

As evidências fornecidas incluem uma verificação da página pública da Task e de seu ID em 25 de outubro de 2026. Não houve inspeção das configurações salvas que exigem autenticação nem execução da Task.

A pequena entrada abaixo passou por uma verificação de formato com base nas regras públicas de entrada fornecidas. JSON é um formato de texto para dados estruturados.

{
  "maxItems": 1,
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ]
}

O link do exemplo é uma entrada de demonstração. Ele não é um resultado deste método.

1. Examine as configurações da Task antes de usá-la.
2. Substitua toda a lista de exemplo em `startUrls` pelos IDs ou links dos vídeos públicos que você pretende consultar.
3. Use entradas diretas de vídeos para esta conferência do arquivo de exportação.
4. Defina `maxItems` para permitir a quantidade pretendida de linhas de resultados públicos.
5. Não envie arquivos privados da exportação nem linhas de eventos de visualização.
6. Execute a consulta com uma lista pequena que você possa examinar por completo.
7. Salve separadamente a entrada, a saída e o horário da consulta.

O valor de `maxItems` mostrado limita a saída a uma linha de métricas. Mantê-lo em um para uma lista maior pode impedir que a saída abranja toda a lista. Compare os IDs enviados com os resultados; não presuma que uma execução concluída abrangeu todos os vídeos pretendidos.

Essas são ações propostas ao leitor. Nenhum arquivo de exportação privado foi acessado ou testado para este guia. Nenhuma execução paga do Actor foi feita. A adequação documentada dá suporte a essa consulta pública opcional; ela não comprova o desempenho durante a execução.

Acrescente resultados públicos sem perder eventos

Mantenha a saída pública em uma tabela separada. Preserve os valores exatos retornados e suas informações de estado.

O campo `comments` contém uma contagem, não o texto dos comentários. Contagens ausentes continuam indisponíveis. Preserve `null`, que representa um valor ausente, em vez de substituí-lo por zero. Mantenha também as informações de precisão; uma contagem pública arredondada não deve se tornar uma contagem exata no relatório. Contrato de saída do Actor

Selecione no máximo uma observação pública por ID de vídeo conferido para esta versão da tabela. Se fizer consultas posteriores, salve-as separadamente e informe qual observação você utiliza.

Uma junção combina tabelas por meio de um valor correspondente. Associe o resultado público selecionado a cada evento com aquele ID de vídeo conferido. Preserve os eventos sem correspondência. Se um resultado falhar e não retornar um ID, mantenha a referência da entrada enviada e investigue a correspondência.

Confira os dois sentidos possíveis do erro:

1. Se a contagem de eventos diminuir, confira se eventos sem correspondência foram removidos.
2. Se a contagem de eventos aumentar, confira se vários resultados públicos foram associados a um único evento.
3. Confirme que cada referência original de evento permanece exatamente uma vez.
4. Confirme que as visualizações repetidas continuam em linhas separadas.

Uma consulta pública malsucedida não comprova que um vídeo foi excluído, tornado privado, limitado por região ou esteja temporariamente indisponível. Mantenha a causa como não resolvida, a menos que outras evidências a estabeleçam.

Exemplo resolvido: três eventos e dois IDs de vídeo

Este exemplo é uma ficção original. Os rótulos dos eventos e os resultados das consultas foram inventados para ensinar. Eles não são registros de um arquivo de exportação privado nem resultados de testes do Actor.

Um arquivo de exportação fictício registra o vídeo A às 09:00 e às 17:00, além do vídeo B às 18:00. Este exemplo simplificado não fornece data nem fuso horário. Mantenha essas limitações visíveis; não calcule horários em UTC a partir desses valores.

A tabela de eventos tem três linhas. A lista separada de consulta tem dois IDs de vídeo: A e B. Na consulta fictícia, A retorna metadados e B não.

Os cálculos usam unidades diferentes:

• 2 eventos de visualização de A + 1 evento de visualização de B = 3 eventos de visualização.
• 1 ID único de A + 1 ID único de B = 2 IDs únicos de vídeo.
• 1 resultado com metadados disponíveis + 1 resultado com metadados indisponíveis = 2 resultados de consulta.
• 3 linhas de eventos antes da junção = 3 linhas de eventos depois da junção.

Os dois eventos de A recebem os metadados selecionados de A. O evento de B às 18:00 permanece, com os metadados marcados como indisponíveis. A consulta malsucedida não apaga a visualização registrada.

Informe três eventos de visualização registrados e dois IDs únicos de vídeo. Essas contagens não medem pessoas únicas. Elas também não comprovam que o arquivo de exportação contém todos os eventos de visualização daquele dia.

Se a contagem pública de visualizações de B estiver ausente, mantenha-a ausente. Informar zero visualizações públicas seria uma afirmação numérica sem suporte nessa consulta fictícia.

Confira a cobertura do arquivo de exportação e os estados não resolvidos

Compare o escopo solicitado com os arquivos incluídos. Quando for viável, compare registros selecionados do arquivo de exportação com o histórico que você consegue ver em Minha atividade. Registre a conta, o período e a data dessa comparação.

O YouTube informa que vídeos assistidos enquanto o histórico está desativado não aparecem no histórico. Os titulares das contas também podem excluir o histórico manualmente ou usar a exclusão automática. Dados públicos dos vídeos não podem reconstruir esses eventos privados ausentes. Controles do histórico do YouTube

Mantenha os diferentes problemas separados:

Um período vazio não comprova zero visualizações. Uma linha mais antiga com data distante não comprova um histórico completo. Uma interpretação bem-sucedida comprova que seu processo leu os arquivos; ela não comprova que o Google forneceu todos os eventos passados.

Antes de aceitar a tabela, confirme que todas as partes do arquivo de exportação foram contabilizadas, que os valores originais continuam sem alterações, que os problemas com horários permanecem visíveis e que todos os eventos de origem mantidos continuam presentes após a junção com os dados públicos. Informe as lacunas do arquivo de exportação separadamente das falhas de consulta.