Como fazer backup dos comentários do YouTube

Você precisa de um método de backup diferente dependendo dos comentários que deseja preservar:

• Comentários que você escreveu: use o Google Takeout e o Histórico de comentários do YouTube.
• Comentários e respostas em um vídeo ou canal: use a YouTube Data API e percorra todas as páginas dos resultados.
• Um registro de moderação ou suporte: preserve o texto, autor, detalhes do vídeo, link direto, respostas, status e horário da captura.

Essa distinção evita confundir uma exportação da conta pessoal com um arquivo de comentários de todo o canal.

1. Escolha o registro que você precisa preservar

Comece respondendo a uma pergunta: você está preservando seus próprios comentários públicos ou os comentários do público em vídeos que administra ou analisa?

O Histórico de comentários do YouTube permite ver os comentários públicos que você deixou no YouTube e abrir o local original onde um comentário foi publicado clicando ou tocando no conteúdo (Ajuda do YouTube). Isso é útil para encontrar seus próprios comentários e o contexto original.

O Google Takeout é o caminho no nível da conta. Uma comparação entre métodos de exportação diferencia-o de uma exportação de vídeo ou canal: o Takeout exporta os comentários que você escreveu, não os comentários que outros espectadores deixaram nos seus vídeos (comparação de métodos de exportação).

Para comentários do público, use commentThreads.list da YouTube Data API. É possível filtrar por videoId ou allThreadsRelatedToChannelId (YouTube Data API).

2. Faça backup dos comentários que você escreveu com o Google Takeout

Use este fluxo para um arquivo pessoal de comentários:

1. Abra takeout.google.com.
2. Desmarque todos os produtos e selecione YouTube e YouTube Music.
3. Em YouTube, selecione comentários nas opções de dados.
4. Escolha o formato e o tamanho do arquivo e crie a exportação.

Essas etapas vêm do fluxo revisado de exportação apenas de comentários (comparação de métodos de exportação). O Google também documenta o fluxo geral: fazer login, abrir o Google Takeout, desmarcar os produtos indesejados, opcionalmente limitar um produto com Todos os dados incluídos e selecionar Próxima etapa (Ajuda do Google Takeout).

O Takeout oferece entrega por e-mail ou armazenamento na nuvem, exportações únicas ou programadas, arquivos ZIP ou TGZ e um limite de tamanho do arquivo (Ajuda do Google Takeout). O Google informa que a criação pode levar de alguns minutos a alguns dias, que a maioria das pessoas recebe o link no mesmo dia e que downloads maiores podem ser divididos em vários arquivos (Ajuda do Google Takeout).

Registre a data da solicitação e a data em que recebeu ou baixou o arquivo. O Google alerta que o arquivo de dados pode não incluir alterações feitas entre a solicitação e a criação do arquivo; portanto, trate cada Takeout como um instantâneo (Ajuda do Google Takeout). Baixar os dados não os exclui dos servidores do Google (Ajuda do Google Takeout).

3. Exporte comentários de um vídeo ou canal com a YouTube Data API

Para comentários deixados por outros espectadores, crie o arquivo usando commentThreads.list:

1. Escolha videoId para as discussões de um vídeo ou allThreadsRelatedToChannelId para discussões associadas a um canal.
2. Solicite uma página com maxResults de 1 a 100.
3. Siga nextPageToken até não haver outra página.
4. Armazene os items retornados e o pageInfo da resposta, incluindo totalResults e resultsPerPage.
5. Se necessário, use searchTerms para limitar os resultados a comentários que contenham termos específicos e escolha textFormat como html ou plainText.

Os filtros, o tamanho da página, os campos de paginação, o filtro de pesquisa e os formatos de texto estão documentados na referência da API do YouTube (commentThreads.list). Manter o token da página e os totais junto da exportação fornece evidências da quantidade de dados abrangida, em vez de apenas uma coleção de comentários (commentThreads.list).

Verifique o acesso antes de considerar o resultado completo. A API documenta um erro 403 commentsDisabled quando os comentários de um vídeo estão desativados e um erro de insufficient permissions quando a solicitação não tem permissão (commentThreads.list). Registre essas falhas junto do arquivo e marque o vídeo ou canal afetado como incompleto.

Cada chamada a commentThreads.list custa 1 unidade de cota. Solicitações adicionais de páginas também têm o custo do método, e os projetos que ativam a YouTube Data API têm uma alocação padrão de 10.000 unidades por dia para todos os outros endpoints; as cotas diárias são redefinidas à meia-noite, no horário do Pacífico (guia de cotas do YouTube).

4. Preserve respostas e o contexto de moderação

Uma resposta de discussão de nível superior não garante que todas as respostas estejam presentes. Um guia de preservação observa que a recuperação completa pode exigir comments.list e recomenda preservar a relação com o comentário pai (guia de preservação de comentários).

Use este fluxo para respostas:

1. Salve o comentário de nível superior e seu ID a partir do registro da discussão.
2. Chame comments.list com esse ID como parentId.
3. Solicite até 100 resultados por página e siga pageToken para páginas adicionais.
4. Armazene cada resposta com o ID do comentário pai.

A API do YouTube documenta parentId, um tamanho de página de 1 a 100 e a paginação com pageToken para comments.list (comments.list). Ela também afirma que o YouTube atualmente aceita respostas a comentários de nível superior; respostas a respostas podem ser aceitas no futuro (comments.list).

Para solicitações autorizadas, commentThreads.list pode filtrar moderationStatus como heldForReview, likelySpam ou published; o padrão é published (commentThreads.list). Salve esse status com o horário da captura quando o contexto de moderação for importante. Não marque uma execução como completa quando a API informar comentários desativados ou permissões insuficientes (commentThreads.list).

5. Crie um arquivo que continue útil

Uma linha de comentário sem o contexto do vídeo e da discussão é difícil de revisar mais tarde. Uma lista de preservação recomenda manter:

• Texto do comentário
• Nome visível do autor
• Título do vídeo
• Link direto do comentário
• Data da captura
• Respostas próximas e status do problema quando o registro for para suporte

Esses campos vêm de um guia prático de preservação de comentários (guia de preservação de comentários). Para exportações da API, adicione o ID do comentário, o ID do comentário pai, o filtro da solicitação, os tokens de página e os totais da resposta, para que a relação e o escopo da coleta permaneçam visíveis (commentThreads.list; comments.list).

Escolha CSV ou JSON

• CSV: escolha-o quando o arquivo for principalmente para ordenar e compartilhar em uma planilha (comparação de métodos de exportação).
• JSON: escolha-o quando precisar da estrutura hierárquica das discussões e de metadados para processamento programático (comparação de métodos de exportação).

Se usar CSV, mantenha o ID do comentário pai em uma coluna própria. Se usar JSON, preserve a relação entre discussão e resposta na estrutura. Em qualquer formato, mantenha o link direto e a data da captura junto do registro (guia de preservação de comentários).

Verifique links e cobertura

O YouTube cria um link destacado para o comentário quando você clica ou toca no carimbo de data de um comentário; o link resultante na barra de endereço aponta para esse comentário e sua discussão (Ajuda do YouTube). Para verificar um link salvo, abra-o em uma janela privada e confirme que a discussão correta está destacada, em vez de apenas abrir o vídeo (guia de preservação de comentários).

Em uma execução da API, compare a quantidade de itens salvos com pageInfo.totalResults, mantenha resultsPerPage e retenha nextPageToken enquanto houver mais páginas (commentThreads.list). Para respostas, repita a mesma verificação usando a paginação de comments.list e o ID pai (comments.list).

6. Torne a rotina de backup repetível

Uma política prática tem três partes:

1. Escolha o escopo: Takeout para comentários que você escreveu; a API para discussões de vídeos ou canais.
2. Escolha a frequência: o Takeout aceita exportações únicas e programadas; use uma exportação programada quando um único instantâneo não for suficiente (Ajuda do Google Takeout). Para trabalhos da API, documente se cada execução será diária, semanal ou vinculada a um evento de moderação ou publicação.
3. Verifique cada execução: registre o horário da captura, os totais das páginas, as evidências de paginação, as falhas de acesso e pelo menos uma verificação de permalink (Ajuda do Google Takeout; commentThreads.list; guia de preservação de comentários).

Um backup preserva o que foi capturado naquele momento. O YouTube informa que um comentário pessoal não aparecerá no Histórico de comentários se tiver sido publicado em um vídeo excluído ou removido pelo YouTube por violação de política (Ajuda do YouTube). Por isso, o horário e o escopo da captura são importantes quando você precisa de um registro histórico.

FAQ

Como faço backup dos comentários do YouTube?

Use o Google Takeout para os comentários que você escreveu. Use commentThreads.list para comentários associados a um vídeo ou canal, percorra as páginas com nextPageToken e use comments.list com parentId quando precisar recuperar respostas (comparação de métodos de exportação; commentThreads.list; comments.list).

Posso exportar todos os comentários de um vídeo do YouTube?

Você pode solicitar as discussões de comentários de um vídeo com videoId, pedir até 100 resultados por página e seguir nextPageToken. Verifique se os comentários estão desativados ou se há erros de permissão antes de considerar o arquivo completo (commentThreads.list).

O Google Takeout exporta comentários de vídeos que não são meus?

A comparação de exportações analisada informa que o Takeout exporta os comentários que você escreveu, não os comentários que outros espectadores deixaram nos seus vídeos. Use a YouTube Data API para discussões de comentários de vídeos ou canais (comparação de métodos de exportação; commentThreads.list).

Como preservo respostas de comentários do YouTube e o contexto de moderação?

Recupere a discussão e use comments.list com o comentário de nível superior como parentId, percorra a paginação e preserve a relação com o comentário pai. Para solicitações autorizadas, salve moderationStatus, como heldForReview, likelySpam ou published (comments.list; commentThreads.list).

Devo salvar comentários do YouTube como CSV ou JSON?

Use CSV para ordenar e compartilhar em planilhas. Use JSON para a estrutura hierárquica das discussões e os metadados usados no processamento programático (comparação de métodos de exportação).

A API do YouTube consegue recuperar todas as respostas de uma discussão?

Não presuma que uma resposta de commentThreads.list contenha todas as respostas. Use comments.list com parentId e siga a paginação com pageToken; o YouTube documenta atualmente respostas a comentários de nível superior (guia de preservação de comentários; comments.list).

Com que frequência devo fazer backup dos comentários do YouTube?

Escolha uma frequência documentada que corresponda à velocidade com que os comentários ou o registro de moderação mudam. O Google Takeout aceita exportações únicas e programadas, enquanto um fluxo da API deve registrar se cada execução é diária, semanal ou baseada em eventos (Ajuda do Google Takeout).

Posso recuperar comentários do YouTube depois que eles forem excluídos?

Preserve uma cópia antes da exclusão e mantenha o texto, o autor, o título do vídeo, o link direto, as respostas e a data da captura. O YouTube informa que um comentário em um vídeo excluído ou removido por violação de política não aparecerá no Histórico de comentários (guia de preservação de comentários; Ajuda do YouTube).