Você precisa de um método de backup diferente dependendo de quais comentários 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.
  • 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 um canal.

Quer arquivar um perfil do YouTube inteiro em vez de criar um arquivo de comentários isolado? O SocialGuardian lista o YouTube entre as plataformas compatíveis, mantém o arquivo privado na sua conta e informa que você pode exportar o arquivo completo a qualquer momento (veja a opção de arquivamento). Comece seu backup

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 gerencia ou analisa?

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

O Google Takeout é o caminho no nível da conta. Uma comparação entre métodos de exportação diferencia o Takeout 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. O método pode filtrar por videoId ou por allThreadsRelatedToChannelId (YouTube Data API).

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

Use este fluxo para criar 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 somente de comentários (comparação de métodos de exportação). O Google também documenta o fluxo geral: faça login, abra o Google Takeout, desmarque os produtos que não deseja, restrinja opcionalmente um produto usando Todos os dados incluídos e selecione Próxima etapa (Ajuda do Google Takeout).

O Takeout permite entrega por e-mail ou armazenamento em 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 do arquivo 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 da exportaçã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 do download e a criação do arquivo; portanto, trate cada exportação do 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 conversas de um vídeo ou allThreadsRelatedToChannelId para conversas associadas a um canal.
  2. Solicite uma página com maxResults entre 1 e 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 restringir 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 YouTube API (commentThreads.list). Manter o token da página e os totais junto da exportação fornece evidências de quanto conteúdo a execução cobriu, em vez de apenas uma coleção de linhas de comentários (commentThreads.list).

Verifique o acesso antes de considerar o resultado completo. A API documenta o erro 403 commentsDisabled quando os comentários de um vídeo estão desativados e o erro 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 incorrem no custo do método, e 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).

Se você quer um arquivo recorrente de perfil público em vez de montar cada exportação manualmente, o SocialGuardian informa que seus backups automáticos são executados todos os dias e incluem conteúdo e engajamento nas plataformas compatíveis, incluindo o YouTube (SocialGuardian). Configure um backup de perfil

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

Uma resposta de conversa de nível superior não garante que todas as respostas estejam presentes. Um guia de preservação observa que a recuperação completa de respostas 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 as respostas:

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

A YouTube API documenta parentId, um tamanho de página de 1 a 100 e a paginação por pageToken para comments.list (comments.list). Ela também informa que o YouTube atualmente oferece suporte a respostas para comentários de nível superior; respostas a respostas podem ser compatíveis 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 que os comentários estão desativados ou que as permissões são insuficientes (commentThreads.list).

5. Crie um arquivo que continue útil

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

  • Texto do comentário
  • Nome visível do autor
  • Título do vídeo
  • Link direto para o comentário
  • Data da captura
  • Respostas relacionadas e status da questão 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 pela 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

Se usar CSV, mantenha o ID do comentário pai em uma coluna própria. Se usar JSON, preserve a relação entre conversa 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).

O YouTube cria um link para o comentário destacado quando você clica ou toca no horário de um comentário; o link resultante na barra de endereço aponta para o comentário e a conversa correspondente (Ajuda do YouTube). Para verificar um link salvo, abra-o em uma janela privativa e confirme que a conversa 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 os comentários que você escreveu; a API para conversas de vídeos ou canais.
  2. Escolha a frequência: o Takeout permite exportações únicas e programadas, portanto use uma exportação programada quando um único instantâneo não for suficiente (Ajuda do Google Takeout). Para tarefas 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). Isso torna importantes o horário da captura e o escopo quando você precisa de um registro histórico.

O SocialGuardian informa que você pode compartilhar um @handle público, arquivar o conteúdo automaticamente e baixá-lo ou restaurá-lo sem senha ou login (SocialGuardian). Comece com um perfil público

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 conversas de comentários de um vídeo com videoId, solicitar 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 pertencem a mim?

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 conversas 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 conversa e use comments.list com o comentário de nível superior como parentId, siga 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 os comentários do YouTube como CSV ou JSON?

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

A YouTube API consegue recuperar todas as respostas de uma conversa?

Não presuma que uma resposta de commentThreads.list contenha todas as respostas. Use comments.list com parentId e siga a paginação por pageToken; o YouTube documenta atualmente respostas para 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 permite 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 seu texto, autor, título do vídeo, link direto, respostas e 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).