Como fazer backup dos metadados de um canal do YouTube

Baixar o arquivo de vídeo é apenas uma parte da preservação de um canal do YouTube: uma ferramenta documentada de backup de canais diferencia os metadados dos vídeos dos próprios arquivos de vídeo na documentação de backup. Um backup de metadados pode incluir títulos, tags e descrições segundo o TubeBuddy, registros do canal na documentação do recurso Channel, detalhes das playlists na documentação do recurso playlist, miniaturas na documentação do recurso Channel e a ordem das playlists na documentação de itens de playlist.

O método ideal depende de você precisar de um arquivo único do Google, registros estruturados para seu próprio processo, uma exportação apenas de metadados ou proteção recorrente para um ou mais perfis.

O que um backup de metadados do YouTube deve preservar

Comece pelo registro do canal. O YouTube documenta campos do canal que incluem título, descrição, URL personalizada, miniaturas, idioma padrão, país, playlist de uploads relacionada, estatísticas, status de privacidade, configurações de marca e localizações na documentação do recurso Channel.

Depois, preserve os registros dos vídeos necessários. Títulos, tags e descrições são identificados especificamente como metadados de vídeo por uma ferramenta documentada de backup de canais, que exporta essas informações como CSV, e não os arquivos de vídeo na documentação.

Trate as playlists como registros, não apenas como listas de links. Um recurso de playlist do YouTube pode incluir título, descrição, miniaturas, status de privacidade, quantidade de itens, idioma padrão, texto localizado e localizações na documentação do recurso playlist. Cada item da playlist identifica a playlist, o ID do vídeo e uma posição baseada em zero; assim, a posição preserva a associação e a ordem na documentação de itens de playlist.

Para as miniaturas, mantenha o arquivo de imagem junto do registro do vídeo ou da playlist correspondente. Se precisar definir novamente uma miniatura personalizada de vídeo pela YouTube Data API, o endpoint de miniaturas aceita arquivos JPEG ou PNG e tem limite máximo de 50 MB segundo a documentação de miniaturas do YouTube.

Escolha a rota de backup certa

Google Takeout: um arquivo de um momento específico

O Google Takeout pode exportar vídeos do YouTube e criar um arquivo para manter registros ou transferir dados segundo o Google. Ele permite entrega por e-mail, Drive, Dropbox, OneDrive ou Box; exportações únicas ou programadas; arquivos ZIP ou TGZ; e divisão de arquivos grandes por tamanho máximo segundo as opções de exportação do Google.

Use essa rota quando quiser um arquivo de exportação gerenciado pelo Google. Lembre-se de que o Google alerta que um arquivo pode não incluir alterações feitas entre a solicitação e sua criação. Portanto, trate cada exportação como uma fotografia de um momento específico, e não como um espelho em tempo real segundo o Google.

Exportação pela API autorizada pelo proprietário: registros estruturados e dados privados

A YouTube Data API usa OAuth 2.0 para dados privados do usuário. O escopo solicitado define quais recursos um aplicativo pode recuperar ou gerenciar, e um aplicativo de servidor autorizado pode receber tokens de acesso e de atualização segundo a documentação de autenticação do Google.

Esta é a rota a considerar quando você precisa de registros estruturados do canal e das playlists ou de acesso autorizado pelo proprietário. É um fluxo de implementação, não um simples caminho de clique em um painel:

1. Autorize o acesso com OAuth 2.0 e solicite apenas os escopos necessários para a exportação segundo a documentação de autenticação do Google.
2. Leia o recurso do canal, incluindo os campos que deseja preservar segundo a documentação do recurso Channel do YouTube.
3. Leia contentDetails.relatedPlaylists.uploads no recurso do canal para obter o ID da playlist de uploads segundo a documentação do recurso Channel. Use playlists.list para recuperar o recurso da playlist e, em seguida, playlistItems.list para recuperar os itens dessa playlist e suas posições baseadas em zero segundo a documentação do recurso playlist e a documentação de itens de playlist.
4. Continue por todas as respostas de listas paginadas. Quando houver outra página, use nextPageToken ou prevPageToken como o próximo pageToken segundo as orientações de paginação do YouTube.
5. Mantenha os registros retornados em um arquivo estruturado. Um script de backup documentado grava registros de vídeos e playlists como arquivos JSON separados na documentação do código-fonte.

Não substitua o fluxo documentado de autorização do usuário por uma conta de serviço: o Google informa que a YouTube Data API não oferece suporte a OAuth com contas de serviço e que seu uso resulta em NoLinkedYouTubeAccount segundo a documentação de autenticação do Google.

Ferramentas CSV ou JSON: metadados sem arquivos de vídeo

Uma exportação CSV é útil quando seu objetivo imediato é ter um registro pesquisável de metadados dos vídeos, em vez dos arquivos de vídeo. Um fluxo documentado para canais públicos é:

1. Faça login e abra a ferramenta Channel Backup.
2. Cole a URL do canal; o fluxo documentado aceita URLs de handle, canal, personalizadas e de usuário legadas.
3. Selecione “Get Channel Backup”.
4. Baixe o CSV resultante com os metadados dos vídeos segundo o fluxo documentado.

Um segundo fluxo documentado fica dentro do YouTube Studio: abra “Bulk & Misc Tools”, escolha “Misc Tools”, abra “Channel Backup”, selecione todo o conjunto de vídeos ou apenas os vídeos desde o último backup e exporte o resultado como CSV segundo a documentação do Channel Backup.

Para arquivos JSON brutos e miniaturas, um utilitário separado de metadados documenta este fluxo:

1. Envie uma URL ou um ID de vídeo, playlist ou canal.
2. Salve o resultado como ZIP.
3. Mantenha juntos os arquivos about.txt, video.json, playlist.json, channel.json e os arquivos PNG de miniatura disponíveis segundo a documentação de exportação do utilitário.

Essas rotas não têm exatamente o mesmo escopo. A rota CSV de conta conectada é descrita como somente leitura e pode incluir uploads não listados e privados nos planos pagos; o plano gratuito visível é limitado aos 50 vídeos públicos mais recentes, enquanto o plano pago é descrito como cobrindo até 50.000 vídeos segundo a página atual da ferramenta. Verifique o escopo antes de considerar uma exportação de canal público como um arquivo completo do proprietário.

Como lidar com registros privados, não listados e públicos

Acesso e visibilidade são questões diferentes. A YouTube Data API usa escopos OAuth para dados privados do usuário segundo a documentação de autenticação do Google. Não se deve presumir que uma exportação baseada em URL pública contenha uploads privados ou não listados; uma ferramenta de conta conectada separa explicitamente o acesso público do plano gratuito do acesso a conteúdo não listado e privado nos planos pagos segundo sua descrição atual de escopo.

Registre a visibilidade pretendida junto de cada entrada de playlist ou vídeo. O YouTube define itens públicos como assistíveis e compartilháveis por qualquer pessoa; itens não listados como assistíveis e compartilháveis por qualquer pessoa que tenha o link; e itens privados como aqueles que não podem compartilhar uma URL segundo as orientações de visibilidade do YouTube.

Para a visibilidade de playlists, o caminho documentado no Studio é:

1. Faça login no YouTube Studio.
2. Selecione Content e depois Playlists.
3. Na playlist, selecione Details.
4. Abra Visibility e escolha a configuração.
5. Selecione Save segundo as instruções de visibilidade de playlists do YouTube.

Crie um manifesto antes de precisar restaurar

Use um documento de inventário para o arquivo. Um guia de recuperação recomenda registrar a URL do canal e o proprietário da Conta Google ou da Conta de marca, arquivos de origem ou mestres, nomes dos arquivos de miniatura, títulos padrão, descrições, hashtags e links, data de verificação e responsáveis pela recuperação segundo as orientações de recuperação.

Adicione os campos estruturados que descrevem o canal e suas relações:

• Título, descrição, URL personalizada, miniaturas, idioma padrão, país, status de privacidade, configurações de marca e localizações do canal do recurso Channel do YouTube.
• Título, descrição, miniaturas, status de privacidade, quantidade de itens, idioma padrão, texto localizado e localizações da playlist do recurso playlist do YouTube.
• Para cada associação a uma playlist, o ID da playlist, o ID do vídeo e a posição baseada em zero do recurso de itens de playlist.
• Títulos, tags e descrições dos vídeos quando a exportação escolhida incluir esses campos de metadados do escopo documentado do Channel Backup.

Identifique cada arquivo com sua data de verificação. Isso é importante porque o Google descreve um arquivo de exportação como potencialmente incapaz de incluir alterações feitas entre a solicitação e sua criação segundo o Google.

É possível restaurar metadados do YouTube a partir de CSV ou JSON?

Uma exportação CSV ou JSON fornece registros para trabalhar, mas a documentação de upload do próprio YouTube descreve um fluxo de reconstrução manual, em vez de uma importação nativa de CSV ou JSON:

1. No YouTube Studio, selecione CREATE e depois Upload videos.
2. Selecione o arquivo de vídeo.
3. Selecione Edit em cada arquivo para editar os detalhes do vídeo segundo a documentação de upload do YouTube.

O YouTube informa que é possível enviar até 15 vídeos por vez segundo a mesma documentação de upload. Se a janela de upload fechar antes da escolha da visibilidade, o YouTube salvará o vídeo como privado na página Content do Studio segundo o YouTube.

Uma afirmação específica de uma ferramenta é diferente: a documentação do Channel Backup diz para enviar o arquivo de backup salvo para restaurar os metadados do vídeo segundo a documentação da ferramenta. Trate isso como o fluxo documentado da ferramenta, não como uma importação geral nativa de CSV ou JSON do YouTube.

Para uma miniatura personalizada, o endpoint da YouTube Data API define a miniatura de um vídeo e aceita arquivos JPEG ou PNG de até 50 MB segundo a documentação de miniaturas do YouTube.

Por fim, teste o arquivo. As orientações de recuperação recomendam realizar um exercício de restauração de vinte minutos segundo suas orientações de recuperação. Use o exercício para confirmar que o manifesto, os arquivos de origem, os nomes das miniaturas, os registros de metadados, os dados de propriedade e a ordem das playlists estão juntos antes que uma recuperação real se torne urgente.

Um plano de backup recorrente

O Google Takeout permite exportações programadas segundo as opções de exportação do Google. A SocialGuardian afirma que o conteúdo de grandes plataformas, incluindo o YouTube, pode ser salvo automaticamente todos os dias, com legendas e metadados entre os tipos de conteúdo protegidos segundo a SocialGuardian.

Para o onboarding documentado da SocialGuardian:

1. Escolha a rede.
2. Informe o handle ou a URL do perfil.
3. Use “+ Add another profile” se precisar adicionar outro perfil.
4. A página inicial informa que o teste não exige senha segundo a página inicial da SocialGuardian.

A descrição pública do produto SocialGuardian afirma que o serviço arquiva posts, stories e vídeos do YouTube e protege legendas e metadados; ela também descreve download ou restauração a partir de um @handle público sem senha ou login segundo a SocialGuardian.