# Como encontrar vídeos indisponíveis ou ausentes na sua playlist salva do YouTube Para encontrar vídeos indisponíveis ou ausentes na sua playlist do YouTube, compare seu próprio inventário salvo da playlist com verificações dos IDs de vídeo conhecidos desse inventário. Um inventário é uma lista salva das entradas de uma playlist. Primeiro, inspecione as entradas pouco claras na sua conta de proprietário e na página do vídeo. Preserve cada posição salva, inclusive as de vídeos repetidos. Uma consulta pública que falhou não prova que um vídeo é privado ou foi excluído. Sem um inventário anterior, a visualização atual não permite determinar quais entradas antigas desapareceram. O resultado útil é uma auditoria: uma comparação salva que mantém visíveis as entradas verificadas, os avisos explícitos de indisponibilidade e as entradas não resolvidas. Ela não recupera o conteúdo de vídeos excluídos ou privados. Também não exige que você remova ou substitua entradas. ## Comece pelo registro da playlist que você já tem A primeira pergunta não é qual ferramenta consegue encontrar mais vídeos. É qual registro salvo mostra as entradas da playlist que você quer verificar. Use sua própria exportação ou seu inventário existente. Uma exportação é uma cópia salva de registros de uma fonte. Mantenha o arquivo original sem alterações. Trabalhe em uma cópia separada para que as verificações posteriores não substituam as evidências anteriores. Registre os detalhes a seguir e mantenha-os privados: 1. A conta de proprietário associada ao registro. 2. O nome e o ID da playlist, se estiverem presentes. 3. A data do registro salvo. 4. O formato do arquivo e o nome do arquivo de origem. 5. O escopo do registro, incluindo as lacunas conhecidas. 6. Se a fonte preservou as posições e as entradas repetidas. Um ID é um identificador usado para distinguir um registro de outro. Um ID de playlist identifica a playlist. Um ID de vídeo identifica o vídeo. Eles são diferentes do ID de uma entrada dentro de uma playlist. Se você não tiver um inventário salvo, registre essa limitação antes de continuar. Você pode inspecionar as entradas atuais e salvar as evidências visíveis. Não é possível usar apenas essa visualização atual para identificar todos os vídeos que desapareceram antes da verificação. O problema do leitor envolve entradas ocultas de vídeos excluídos ou privados. Este método não depende da presença de um controle específico de exibição na sua conta. Inspecione o que a visualização de proprietário mostra. Mantenha registradas as lacunas restantes, em vez de presumir que a lista visível contém todas as entradas anteriores. ## Mantenha as entradas da playlist separadas dos vídeos Uma entrada na playlist vincula um vídeo a uma playlist. Um vídeo pode aparecer em mais de uma posição salva. Essas posições devem permanecer separadas na auditoria. O recurso oficial `playlistItem` do YouTube descreve essa distinção. O recurso tem ID próprio, ID da playlist, posição e ID do vídeo. O horário em `snippet.publishedAt` indica quando o item foi adicionado à playlist. Esse horário não é o horário de publicação do vídeo. Esta é uma referência de esquema, não uma prova de que esta pesquisa exportou a playlist privada de um proprietário. [Referência de PlaylistItems do YouTube — verificada em 25 de outubro de 2026; apenas a estrutura do recurso](https://developers.google.com/youtube/data/reference/rest/v3/playlistItems). Um esquema define os campos de um registro. Use o esquema oficial para entender os campos que sua fonte realmente contém. Não presuma que seu arquivo salvo contém todos os campos desse esquema. Crie uma tabela de entradas com uma linha para cada entrada original: | Campo salvo | O que preservar | | --- | --- | | Arquivo e linha de origem | Uma referência à entrada original | | ID da playlist | O identificador salvo da playlist, quando presente | | ID da entrada | O identificador salvo da entrada, quando presente | | Posição salva | A posição exatamente como foi registrada | | ID do vídeo | O identificador conhecido do vídeo, quando presente | | Título salvo | Evidência do título anterior, quando presente | | Data de inclusão na playlist | A data de adição registrada, quando presente | | Notas sobre a fonte | Lacunas conhecidas e significados dos campos | Estas são colunas propostas para a auditoria. Elas não representam afirmações sobre os campos retornados pelo Actor de métricas. Se a fonte não tiver um ID da entrada, preserve a referência ao arquivo e à linha de origem. Se o ID do vídeo estiver ausente, preserve a linha e marque-a como não resolvida. Não exclua a entrada por não ser possível incluí-la em uma consulta pública. Mantenha os títulos salvos separados dos títulos atuais. Mantenha as datas de inclusão na playlist separadas das datas de publicação dos vídeos. Preserve as datas desconhecidas como desconhecidas. A data da verificação de hoje não pode preencher uma data desconhecida no registro anterior. Preserve a posição salva mesmo que você ordene uma visualização de trabalho depois. A ordenação por título atual ou data de publicação do vídeo não deve substituir a ordem original. ## Siga o método de auditoria em oito etapas ### 1. Defina o inventário que você vai verificar Informe qual registro salvo da playlist a auditoria abrange. Conte as linhas de entradas antes de coletar os dados atuais. Essa é a contagem esperada de entradas para esse registro. Se o registro abranger apenas parte de uma playlist, informe isso. Uma comparação correta de um registro parcial continua sendo uma auditoria parcial. Ela não permite determinar todo o conteúdo anterior da playlist. ### 2. Preserve todas as linhas de entradas Copie os campos da fonte para sua tabela de entradas de trabalho. Verifique se a contagem de linhas ainda corresponde ao registro de origem. Preserve os IDs de vídeo repetidos. Um ID repetido não é um vídeo único adicional, mas cada ocorrência continua sendo uma entrada separada na playlist. Preserve também as linhas com IDs, títulos ou datas ausentes. ### 3. Crie uma lista separada de IDs de vídeo únicos Crie uma segunda tabela com uma linha para cada ID de vídeo conhecido e distinto. Essa lista serve para verificar metadados públicos. Metadados são dados descritivos, como um título ou uma data de publicação. Mantenha as entradas originais na primeira tabela. Remova os IDs repetidos apenas da segunda tabela. Registre quais linhas de entradas se vinculam a cada ID único. Use vídeos conhecidos como entrada para esta tarefa. A descoberta de canais públicos tem outro escopo e não comprova que um vídeo faz parte da sua playlist salva. O [guia de conjuntos de dados de canais do YouTube](/pt-BR/articles/chronometrica-vs-streamers-shorts-escolha-dados-de-canais-do-youtube/) explica esse limite separado de coleta. ### 4. Teste uma entrada de vídeo conhecido Comece com um vídeo relevante da sua lista de IDs únicos. Use a pequena entrada do Actor mostrada abaixo. Um Actor é um programa hospedado que coleta dados. Uma Task é uma configuração de entrada salva para esse programa. Inspecione o resultado antes de adicionar mais IDs. Verifique a identidade e o status retornados. Uma execução concluída, por si só, não prova que o vídeo pretendido forneceu dados úteis. ### 5. Associe os resultados às entradas originais Faça a correspondência de cada resultado aceito com seu ID de vídeo exato. Depois, associe-o a todas as entradas com esse ID. Essa operação se chama junção: ela conecta linhas por meio de um identificador compartilhado. Mantenha as linhas das entradas originais mesmo quando não houver resultado correspondente. Uma tabela de resultados não deve substituir o registro salvo da playlist. ### 6. Inspecione diretamente as entradas não resolvidas Abra a playlist relevante na sua conta de proprietário. Inspecione a página do vídeo conhecido e o player na fonte, quando possível. Se aparecer um motivo explícito, registre-o. Preserve o texto do motivo, a fonte, o horário da verificação e o contexto da conta. Se a fonte não fornecer um motivo claro, mantenha a entrada como não resolvida. Não determine uma causa com base em uma falha genérica de consulta. ### 7. Concilie as contagens Conciliação significa verificar se as entradas salvas e os resultados da auditoria correspondem ao mesmo total. Conte as entradas e os IDs de vídeo únicos separadamente. Cada entrada original deve ter um estado de auditoria. Os vídeos repetidos devem continuar nas linhas de suas entradas originais. As verificações de contagem abaixo mostram como confirmar isso. ### 8. Salve a auditoria e decida o que precisa de revisão Salve juntos o inventário original, a tabela de entradas de trabalho, a tabela de verificação de IDs únicos e as notas de evidências. Após a revisão, mantenha a auditoria como somente leitura. Não remova nem substitua entradas da playlist automaticamente. Decida separadamente se deve inspecionar uma entrada não resolvida outra vez ou fazer uma alteração manual na playlist. ## Use o Actor de métricas para verificar vídeos públicos conhecidos O [Chronometrica YouTube Metrics Scraper](https://apify.com/chronometrica/youtube-metrics-scraper) documenta a coleta de metadados públicos e métricas de vídeos a partir de entradas de vídeos conhecidos. Uma métrica é uma medida numérica, como uma contagem de visualizações. Esse escopo documentado atende à etapa de verificação pública da auditoria. Isso não torna o Actor uma ferramenta de exportação completa de playlists. O contrato público também oferece descoberta de canais com limites definidos. Esse recurso não fornece evidências de que um vídeo faz parte da sua playlist salva. Para este método, use seus IDs de vídeo conhecidos ou URLs diretas dos vídeos. Uma URL é um endereço da web. A pequena entrada a seguir passou por uma verificação estática do esquema. Essa verificação avaliou apenas a estrutura da entrada. Nenhuma execução de coleta foi realizada: ```json {"maxItems":1,"startUrls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]} ``` Use o Actor de métricas para verificar vídeos públicos conhecidos Substitua a URL de exemplo pela URL de um vídeo conhecido que você pretende verificar. O endereço de exemplo serve para demonstrar o esquema. Ele não é evidência de um resultado útil para sua playlist. O campo `startUrls` contém as entradas fornecidas. O campo `maxItems` limita o total de linhas de métricas em toda a execução. Aqui, um limite de um é adequado para uma primeira verificação de um vídeo. Ele não verifica um inventário com vários IDs únicos. Antes de um lote posterior, defina um limite adequado e confira se todos os IDs pretendidos foram contemplados. Não cole a URL de uma playlist como se isso garantisse a exportação de todas as entradas. A versão fixa do contrato não sustenta essa afirmação. Você também pode abrir a [Task youtube-engagement-metrics-tracker](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker) pública. Substitua as entradas de exemplo antes de usar. A página e o ID da Task foram encontrados em 25 de outubro de 2026. A entrada salva que exige autenticação e a execução não foram verificadas. O Actor lê dados públicos. Ele não lê seu registro de playlist exclusivo do proprietário nem vídeos privados. Ele não recupera conteúdo privado ou excluído. Os campos documentados de métricas públicas incluem uma contagem de comentários; isso não significa que ele coleta registros de comentários. Esses limites vêm do contrato verificado, não de um teste em execução. [Contrato do Actor da Chronometrica — verificado em 25 de outubro de 2026; esquema público e README da versão padrão, sem execução paga](https://apify.com/chronometrica/youtube-metrics-scraper). ## Salve os resultados sem perder as lacunas Mantenha uma tabela de verificação separada para os IDs de vídeo únicos. Preserve cada entrada usada em uma tentativa, mesmo que o resultado seja pouco claro. | Campo salvo | Finalidade | | --- | --- | | ID do vídeo pretendido | Vincular a tentativa ao inventário salvo | | `inputUrl` | Preservar a fonte enviada | | `postId` | Verificar a identidade do vídeo retornado | | `postUrl` | Preservar o endereço do vídeo retornado | | `title` | Manter a evidência do título atual separada | | `publishedAt` | Preservar o horário de publicação do vídeo | | `status` | Preservar o status do resultado retornado | | `scrapedAt` | Preservar o horário da coleta | | `postMetricStatus` | Preservar os detalhes de disponibilidade e precisão das métricas | | Estado da auditoria e notas | Registrar sua decisão com base nas evidências | A última linha descreve suas próprias colunas de auditoria. Não apresente essas colunas como saída do Actor. Verifique `postId` antes de aceitar uma correspondência. Não use a semelhança entre títulos como regra de junção. Se um resultado não tiver uma identidade claramente correspondente, preserve a tentativa e investigue. Mantenha os valores ausentes como ausentes. Um título ausente não é evidência de que o vídeo foi excluído. Uma contagem de visualizações indisponível não equivale a zero visualizações. Um zero retornado e um valor ausente têm significados diferentes. Um resultado de metadados resolvido ainda pode ter métricas indisponíveis. Não marque uma entrada da playlist como não resolvida apenas porque uma contagem opcional está ausente. Analise em conjunto a identidade, o status retornado e as evidências disponíveis. Da mesma forma, um resultado de metadados não prova que você reproduziu o vídeo. Se a reprodução for importante, registre uma verificação separada do player, com horário e contexto próprios. Esta auditoria não transforma uma consulta de metadados em um teste de disponibilidade. ## Use estados claros para falhas e evidências diretas Use estes estados na sua própria auditoria. São rótulos de trabalho, não valores de status documentados do Actor. | Estado da auditoria | Evidência necessária | Tratamento na contagem | | --- | --- | --- | | Verificada no momento | Metadados públicos correspondentes aceitos para o ID conhecido | Entrada verificada | | Explicitamente indisponível | Uma fonte direta mostra um motivo claro de indisponibilidade | Entrada verificada, com o motivo preservado | | Não resolvida | ID ausente, resultado pouco claro ou nenhuma explicação direta | Entrada não resolvida | Para fins de contagem, as entradas verificadas incluem tanto as verificadas no momento quanto as entradas com evidência explícita de indisponibilidade. Informe também esses dois grupos separadamente. Um motivo explícito se aplica ao contexto registrado da verificação. Preserve esse contexto. Não transforme uma observação específica de uma conta ou de um momento em uma afirmação sobre todos os espectadores ou todas as verificações futuras. Uma consulta pública que falhou não consegue distinguir, por si só, entre vídeo privado, vídeo excluído, restrição regional ou limitação temporária. O contrato do Actor declara essa limitação. Preserve o status retornado como evidência, mas não o reescreva como uma causa mais específica. [Contrato do Actor da Chronometrica — verificado em 25 de outubro de 2026; limitações documentadas das falhas, sem teste em execução](https://apify.com/chronometrica/youtube-metrics-scraper). Se uma verificação posterior fornecer evidências melhores, adicione um resultado com data. Preserve a observação anterior. Uma consulta posterior bem-sucedida pode resolver uma lacuna atual sem explicar por que a tentativa anterior falhou. Recuperar um título também não recupera o conteúdo original. Se sua próxima tarefa precisar das legendas de um vídeo conhecido, use o [guia de transcrições do YouTube e legendas ausentes](/pt-BR/articles/como-obter-transcri%C3%A7%C3%A3o-do-youtube-e-verificar-legendas-ausentes/), que é separado. Mantenha as evidências de legendas fora da decisão sobre a entrada na playlist. ## Acompanhe um exemplo fictício original Este exemplo é uma ficção original. Os IDs, as entradas e os resultados são inventados. Ele não descreve um teste de exportação nem um teste de disponibilidade de vídeos. Um inventário salvo tem três entradas: | Posição salva | ID do vídeo | Verificação de metadados públicos | Estado da auditoria | | --- | --- | --- | --- | | 1 | A | Resultado correspondente retornado para A | Verificada no momento | | 2 | B | Nenhum resultado aceito ou explicação direta | Não resolvida | | 3 | A | O mesmo resultado correspondente associado a esta entrada | Verificada no momento | A lista de IDs únicos contém A e B. A consulta fictícia retorna um resultado correspondente para A. Ela não resolve B. Associe o resultado de A às posições 1 e 3. Não una essas posições em uma só linha. O cálculo das entradas é: 3 entradas esperadas = 2 entradas verificadas + 1 entrada não resolvida. A contagem separada de identidades é: 2 IDs de vídeo únicos = 1 ID de vídeo único resolvido + 1 ID de vídeo único não resolvido. Há três entradas, não três vídeos únicos. Há duas entradas verificadas, não dois IDs de vídeo resolvidos separadamente. Essas contagens descrevem registros, não pessoas. Não existe um motivo explícito de indisponibilidade para B neste exemplo. Portanto, a contagem de entradas explicitamente indisponíveis é zero. Esse zero descreve esta categoria de evidência. Ele não significa que B esteja disponível, tenha sido excluído ou seja privado. A próxima ação é inspecionar B na playlist do proprietário e no player da fonte. Até que uma evidência direta explique o resultado, sua entrada permanece não resolvida. As posições 1, 2 e 3 continuam na auditoria. ## Verifique a auditoria concluída Antes de aceitar o relatório, conclua estas verificações: 1. Confirme que todas as linhas de entradas originais continuam presentes. 2. Confirme que as posições salvas e as entradas repetidas permanecem intactas. 3. Confirme que as linhas com IDs de vídeo ausentes permanecem não resolvidas. 4. Confirme que as junções usam IDs de vídeo e não descartam entradas sem correspondência. 5. Confirme que as datas de inclusão na playlist, as datas de publicação e os horários de verificação permanecem separados. 6. Confirme que cada motivo específico de indisponibilidade tem evidência direta. 7. Confirme que os valores ausentes de métricas não foram convertidos em zero. 8. Confirme que o total de entradas esperadas é igual à soma das entradas verificadas e não resolvidas. 9. Informe os IDs de vídeo únicos separadamente das entradas. 10. Informe o escopo do inventário e todas as lacunas restantes. O relatório deve permitir que outro leitor relacione cada decisão a uma entrada salva e às suas evidências. Um total que fecha confirma a contagem. Ele não prova que o inventário original abrangia toda a playlist. ## Execute a próxima ação Comece com um registro salvo da playlist e um ID de vídeo conhecido. Primeiro, preserve a tabela de entradas. Inspecione as entradas pouco claras na sua conta de proprietário. Depois, use o [Chronometrica YouTube Metrics Scraper](https://apify.com/chronometrica/youtube-metrics-scraper) para uma pequena verificação de metadados públicos. Amplie a verificação somente depois de confirmar a correspondência de identidade, os campos preservados e o método de contagem. Mantenha visíveis as entradas não resolvidas. Use evidências explícitas da fonte para explicar os itens indisponíveis. Trate qualquer remoção ou substituição posterior como uma decisão manual separada. ## Fontes e leituras adicionais - [YouTube Data API: PlaylistItems — verificada em 25 de outubro de 2026; campos das entradas e significados das datas, não é evidência de exportação de uma playlist privada](https://developers.google.com/youtube/data/reference/rest/v3/playlistItems) - [Chronometrica YouTube Metrics Scraper — verificado em 25 de outubro de 2026; esquema público e README da versão padrão, sem execução paga nem teste de funcionamento em execução](https://apify.com/chronometrica/youtube-metrics-scraper) - [Task youtube-engagement-metrics-tracker — verificada em 25 de outubro de 2026; página pública e ID da Task presentes, entrada salva e execução não testadas](https://apify.com/chronometrica/youtube-metrics-scraper/examples/youtube-engagement-metrics-tracker) - [Pergunta sobre playlists no Reddit — publicada em 26 de maio de 2026, observada em 25 de outubro de 2026; problema de um leitor, não é evidência de demanda ou desempenho da ferramenta](https://www.reddit.com/r/youtube/comments/1toj1zs/option_to_show_unavailable_videos_in_playlists/)