# Por que as marcações de tempo do seu vídeo no YouTube não aparecem como capítulos

As marcações de tempo do seu vídeo no YouTube podem não cumprir as regras de capítulos, ou o recurso de capítulos pode estar indisponível para seu canal. Confira primeiro a descrição do vídeo: comece em 00:00, inclua pelo menos três linhas com marcação de tempo e título em ordem crescente e garanta que cada capítulo tenha pelo menos 10 segundos. Confira o último capítulo com base no fim real do vídeo. Depois, verifique o acesso aos recursos avançados na sua conta de proprietário. Salve a descrição e confira o player do vídeo. A formatação correta, por si só, não garante que os capítulos apareçam. Essas verificações seguem as [instruções do YouTube sobre capítulos](https://support.google.com/youtube/answer/9884579?hl=en).

Comece com um vídeo seu ou que você pode editar. O YouTube Studio é a interface de gerenciamento de vídeos do proprietário. É nele que você adiciona a descrição e verifica o acesso da conta. Uma ferramenta de legendas públicas pode ajudar a preparar os horários de início dos capítulos. Ela não pode confirmar as configurações da sua conta nem comprovar que o player aceitou seus capítulos.

O método abaixo produz dois registros separados: uma lista de capítulos conferida e uma verificação de acesso da conta. Mantenha os registros separados para que uma lista correta não oculte um problema de acesso ainda não resolvido.

## 1. Confirme o vídeo, a duração e o acesso do proprietário

Um capítulo é uma parte de um vídeo que recebe um nome. Sua marcação de tempo indica quando ele começa. Sua duração vai desse início até o próximo capítulo ou, no caso do último capítulo, até o fim do vídeo.

Antes de editar, siga estas etapas:

1. Abra o vídeo exato que você pretende alterar.
2. Confirme que o vídeo é seu ou que você tem permissão para editar sua descrição.
3. Registre a URL e o ID do vídeo. O ID é o código curto que identifica o vídeo.
4. Confira a duração exata no próprio vídeo e registre esse valor.
5. Guarde uma cópia da descrição atual.
6. Verifique o acesso aos recursos avançados na sua conta de proprietário.

Registre o resultado do acesso como confirmado, indisponível ou não verificado. Uma configuração não verificada tem estado desconhecido. Não a registre como indisponível.

Mantenha os capítulos manuais separados dos capítulos automáticos. Os capítulos manuais são as linhas com marcação de tempo e título que você adiciona. O YouTube cria capítulos automáticos por um processo separado. Os capítulos manuais substituem os automáticos, segundo a [Ajuda do YouTube](https://support.google.com/youtube/answer/9884579?hl=en).

A ausência de capítulos automáticos não comprova que sua lista manual é inválida. Confira a lista manual com base nas regras próprias dela. Se você investigar se o vídeo pode ter capítulos automáticos, guarde esse resultado em uma anotação separada.

Um resultado de legendas públicas não pode confirmar esses dados da conta do proprietário. Confira esses dados na conta que gerencia o vídeo.

## 2. Prepare os inícios dos capítulos com base no vídeo real

Uma divisão entre capítulos é o ponto em que um capítulo termina e o próximo começa. Escolha esses pontos com base no conteúdo do vídeo antes de conferir o intervalo entre eles.

Assista à abertura, a cada mudança de assunto e ao encerramento. Coloque cada início no ponto em que o próximo assunto realmente começa. Um título falado pode ajudar, mas o vídeo também pode mudar de assunto por meio de uma demonstração sem fala ou de uma ação na tela.

Siga esta sequência:

1. Escreva uma lista curta das principais partes do vídeo.
2. Assista ao início de cada parte.
3. Registre um horário de início proposto.
4. Escreva um título curto que descreva essa parte.
5. Assista novamente à transição para confirmar o horário e o título.

Mantenha o primeiro início em 00:00. Dê à abertura um título útil que corresponda ao conteúdo.

Use títulos que ajudem o espectador a escolher uma parte. “Prepare os materiais” informa mais que “Parte dois”. Confira se o título descreve o capítulo como um todo. Uma breve menção a um assunto nem sempre justifica dar esse nome ao capítulo inteiro.

Legendas com marcações de tempo podem ajudar a localizar mudanças de assunto na fala. Elas não podem confirmar uma mudança visual sem fala. Assista a cada ponto de divisão proposto, mesmo quando o texto da legenda parecer claro.

Esta tarefa divide seu próprio vídeo em capítulos. Se você só precisa encontrar uma explicação na aula de outra pessoa, o [guia de navegação por conceitos](/pt-BR/articles/como-encontrar-um-conceito-em-uma-aula-longa-no-youtube/) trata dessa tarefa mais específica. Um trecho útil para estudo não precisa servir como capítulo em uma lista completa publicada.

## 3. Use as legendas existentes quando elas ajudarem

Você pode preparar capítulos manuais apenas assistindo ao vídeo. Use legendas quando elas facilitarem a localização de possíveis mudanças de assunto.

Uma faixa de legendas é um conjunto de segmentos de texto com marcações de tempo para um vídeo. Um segmento é um trecho de texto com início e fim. Uma transcrição reúne esses trechos.

O [YouTube Transcript Scraper](https://apify.com/chronometrica/youtube-transcript-scraper) lê faixas de legendas públicas existentes. Um Actor é um programa hospedado que coleta dados. Uma Task é uma configuração de entrada salva para um Actor.

O Actor documentado aceita URLs diretas ou IDs de vídeos públicos do YouTube. Ele não aceita canais, playlists ou páginas de busca como entrada para coleta. Ele não cria texto novo a partir da fala nem baixa áudio ou vídeo. Se não houver legendas, continue assistindo ao vídeo manualmente.

O pequeno exemplo de entrada fornecido é:

```json
{"includeFailedInputDetails":true,"outputFormats":["json"],"preferredLanguages":[],"startUrls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]}
```

3. Use as legendas existentes quando elas ajudarem

Substitua toda a lista de exemplo em `startUrls` pela URL do vídeo público escolhido. A URL de exemplo mostra apenas uma estrutura de entrada válida. Ela não comprova que esse vídeo é útil para preparar capítulos.

As configurações têm estas funções:

- `startUrls` contém a entrada do vídeo. Use um vídeo para esta verificação.
- `outputFormats` solicita JSON, um formato de texto estruturado que preserva as marcações de tempo dos segmentos.
- `preferredLanguages` está vazio, então o Actor seleciona a melhor faixa de legendas disponível. Isso não garante legendas em inglês.
- `includeFailedInputDetails` solicita detalhes de falhas no registro OUTPUT da execução. OUTPUT é o resumo da execução.

Se você definir preferências de idioma, o Actor tentará usá-las na ordem indicada. Se nenhum desses idiomas estiver disponível, ele informará uma falha de idioma indisponível, em vez de selecionar outro idioma sem aviso. Confira o idioma retornado antes de usar as legendas.

A [Task pública de transcrição com marcações de tempo](https://apify.com/chronometrica/youtube-transcript-scraper/examples/youtube-timestamped-transcript-json) é um ponto de partida documentado para este trabalho. A página e o ID da Task foram encontrados na verificação de fontes fornecida. Essa verificação não acessou a entrada salva que exige autenticação nem executou a Task. Confira a entrada por conta própria antes de iniciar uma execução.

A entrada de exemplo passou pela verificação de esquema fornecida, que confere a estrutura da entrada. Nenhuma execução paga do Actor foi feita para este artigo. Todas as etapas de coleta descritas aqui são ações propostas para o leitor.

### Confira o resultado das legendas antes de usá-lo

Após sua própria execução, confirme a identidade do vídeo e o idioma selecionado. Confira `videoId`, `videoUrl`, `transcriptLanguageCode`, `status` e `statusReason`. Depois, leia o OUTPUT da execução para obter detalhes das entradas com falha.

Cada vídeo único processado com sucesso produz uma linha no conjunto de dados, ou seja, um resultado de vídeo. Uma entrada com falha não se torna uma linha de transcrição bem-sucedida. Portanto, a ausência de uma linha exige uma verificação de falhas. Ela não comprova que o vídeo não tem pontos de divisão úteis para capítulos.

Para cada segmento retornado, use `text`, `startSeconds` e `endSeconds` para localizar o trecho. Preserve `durationSeconds` como foi retornado, inclusive se o valor for null. Null significa que o valor está ausente ou é desconhecido. Não significa zero segundos.

Trate `videoDurationSeconds` da mesma forma. Se o valor estiver ausente, obtenha a duração no próprio vídeo. Não use o fim da última legenda como o fim do vídeo. O vídeo pode continuar depois que a fala termina.

As informações de idioma, as informações sobre a origem das legendas e `videoCoverageRatio` não comprovam a exatidão das palavras. Guarde o resultado original e confira os inícios propostos durante a reprodução. O [contrato público do Actor](https://apify.com/chronometrica/youtube-transcript-scraper) dá suporte à coleta de legendas, não à aprovação automática da sua lista de capítulos.

As marcações de tempo dos capítulos também são diferentes das entradas de legenda. Uma entrada de legenda tem seu próprio início e fim de exibição do texto. Use o [guia de conversão de legendas](/pt-BR/articles/conversao-de-legendas-do-youtube/) se precisar de arquivos de legenda. Você não precisa converter as legendas em arquivos de legenda para adicionar capítulos manuais.

## 4. Confira o formato e a duração de cada capítulo

Depois de escolher pontos de divisão úteis, escreva uma marcação de tempo e um título em cada linha da descrição. Comece a primeira linha em 00:00. Inclua pelo menos três linhas, cada uma com um horário posterior ao da linha anterior.

Rejeite horários repetidos. Rejeite horários fora do vídeo. Uma marcação de tempo no fim do vídeo ou depois dele não pode iniciar um capítulo de pelo menos 10 segundos.

Converta cada horário de início em segundos para conferir a duração. Multiplique os minutos por 60 e depois some os segundos. Por exemplo, 01:20 corresponde a 1 × 60 + 20 = 80 segundos.

Para cada capítulo, exceto o último, subtraia seu início do início seguinte. Para o último capítulo, subtraia seu início da duração do vídeo.

Cada resultado deve ser de pelo menos 10 segundos. Confira todos os resultados, inclusive o último. Uma lista pode ter intervalos válidos entre as marcações de tempo visíveis e ainda deixar pouco tempo depois da última marcação.

Se um capítulo for curto demais, volte ao conteúdo. Decida se deve uni-lo a um capítulo próximo ou escolher outro ponto de divisão que ainda corresponda a uma mudança real de assunto. Depois, confira a duração novamente. Não altere um horário apenas para atender ao cálculo se o novo horário fizer o título descrever o trecho errado do vídeo.

As [regras oficiais do YouTube](https://support.google.com/youtube/answer/9884579?hl=en) exigem início em 00:00, pelo menos três marcações de tempo em ordem crescente e duração mínima de 10 segundos por capítulo. Passar nessas verificações confirma que o formato atende às regras. Isso não confirma o acesso da conta nem a aceitação pelo player.

## 5. Exemplo resolvido: um vídeo fictício original de dois minutos

Este exemplo é uma ficção original. O vídeo, os títulos e as edições propostas são inventados. Nenhum vídeo real de um proprietário foi editado, e nenhum player de vídeo publicado foi verificado. Os cálculos ensinam apenas a conferir a duração.

Suponha que o vídeo fictício termine em 02:00. Isso corresponde a 2 × 60 = 120 segundos. As linhas propostas para sua descrição são:

```text
00:00 Prepare
00:35 Collect
01:20 Check
```

5. Exemplo resolvido: um vídeo fictício original de dois minutos

Os inícios são 0, 35 e 80 segundos. Confira cada capítulo:

| Capítulo | Início | Próximo início ou fim do vídeo | Cálculo | Duração |
| --- | --- | --- | --- | --- |
| Preparar | 00:00 | 00:35 | 35 − 0 | 35 segundos |
| Coletar | 00:35 | 01:20 | 80 − 35 | 45 segundos |
| Conferir | 01:20 | 02:00 fim | 120 − 80 | 40 segundos |

Os três capítulos duram pelo menos 10 segundos. O primeiro início é 00:00, e os três inícios estão em ordem crescente.

As durações também somam 35 + 45 + 40 = 120 segundos. Isso corresponde à duração do vídeo fictício. Esse total confere os cálculos. Ele não comprova que os títulos correspondem a um conteúdo real nem que o YouTube exibirá os capítulos.

Agora, suponha que você adicione um quarto capítulo em 01:55. Seu início é 1 × 60 + 55 = 115 segundos.

O capítulo anterior duraria 115 − 80 = 35 segundos. Esse intervalo atende à regra. Mas o último capítulo duraria apenas 120 − 115 = 5 segundos. Ele não atende à regra de 10 segundos.

Remova ou revise esse ponto de divisão proposto depois de revisar o conteúdo fictício. Não adicione 02:00 como início de outro capítulo. Isso daria uma duração final de 120 − 120 = 0 segundos.

Em uma verificação real, um horário de término desconhecido deve continuar como desconhecido até você conferir o vídeo. Você não pode aprovar a duração do último capítulo sem esse horário.

## 6. Salve a descrição e confira o player

Depois de conferir o conteúdo, o formato e as durações, publique a lista pela conta do proprietário:

1. Abra o vídeo do proprietário no YouTube Studio.
2. Guarde uma cópia da descrição anterior.
3. Adicione à descrição as linhas conferidas com marcação de tempo e título.
4. Salve a descrição.
5. Abra a página do vídeo após salvar.
6. Confirme que a descrição contém as linhas desejadas.
7. Confira o player para ver se os capítulos aparecem.
8. Confira se os inícios dos capítulos exibidos correspondem às mudanças de assunto escolhidas.

Registre o resultado observado. “Descrição salva” e “capítulos exibidos” são resultados separados. Salvar o texto, por si só, não confirma que o player mostra os capítulos.

Se os capítulos não aparecerem, confira novamente as linhas salvas, as durações e o acesso aos recursos avançados. Não informe que a publicação foi bem-sucedida com base apenas em um rascunho ou em uma verificação de formato. As fontes fornecidas não garantem a exibição nem estabelecem um prazo fixo de espera.

## 7. Mantenha uma tabela de capítulos e um registro de acesso separado

Guarde informações suficientes para repetir a verificação após uma edição. Uma versão é um estado salvo da sua lista de capítulos. Dê a cada versão um nome e uma data de verificação.

Use uma linha por capítulo:

| Campo salvo | O que registrar |
| --- | --- |
| ID e URL do vídeo | O vídeo exato que você conferiu |
| Versão da lista | A versão usada nesta edição |
| Duração do vídeo | A duração confirmada em segundos |
| Ordem do capítulo | Sua posição na lista |
| Título do capítulo | O texto colocado na descrição |
| Horário de início | A marcação de tempo na descrição |
| Início em segundos | O mesmo início expresso em segundos |
| Próximo início ou fim | O valor usado para calcular a duração |
| Duração do capítulo | O resultado da subtração, em segundos |
| Verificação de conteúdo | O que você viu no ponto de divisão |
| Data da verificação | Quando você revisou esta versão |

Mantenha um registro separado para o vídeo com o acesso de edição, o acesso aos recursos avançados, a descrição salva e o resultado observado no player. Inclua estados desconhecidos quando você ainda não tiver concluído uma verificação.

Se usar legendas, guarde também o idioma selecionado, `scrapedAt` e qualquer anotação de falha. `scrapedAt` registra a data e a hora da coleta das legendas. Não é a data e a hora em que você conferiu a configuração da conta do proprietário ou o player.

Depois de cortar ou substituir o vídeo, confira novamente todos os inícios de capítulos posteriores à alteração. Confirme de novo a duração total e a duração do último capítulo. Os cálculos anteriores se aplicam à versão anterior.

## 8. Escolha a próxima verificação com base na falha

Use a falha observada para decidir o que conferir em seguida.

| Estado observado | Próxima verificação |
| --- | --- |
| A primeira marcação de tempo não é 00:00 | Corrija a primeira linha e revise seu título |
| Há menos de três linhas com marcações de tempo | Revise o conteúdo para criar uma lista completa e válida |
| Há horários repetidos ou em ordem decrescente | Corrija a ordem e recalcule as durações |
| Um capítulo tem menos de 10 segundos | Revise esse ponto de divisão e o conteúdo próximo a ele |
| A duração do último capítulo é desconhecida | Confirme o fim real do vídeo |
| As legendas estão indisponíveis | Assista ao vídeo manualmente |
| O idioma solicitado está indisponível | Revise a falha e sua escolha de idioma |
| A descrição salva difere do rascunho | Corrija e salve a versão desejada |
| O formato atende às regras, mas os capítulos não aparecem | Confira o acesso do proprietário e registre o resultado não resolvido no player |

A ausência de uma faixa de legendas é uma limitação da coleta. Ela não comprova um problema de acesso da conta. Uma transcrição pública correta também não comprova o acesso do proprietário.

Se todas as verificações documentadas forem aprovadas, mas o player ainda não mostrar capítulos, mantenha esse resultado como não resolvido. Guarde a lista conferida e as observações da conta. As evidências fornecidas não identificam todas as causas possíveis. Portanto, não atribua uma causa sem evidências.

## Aplique a verificação a um vídeo seu

Comece com um vídeo que você pode editar. Confirme sua duração, revise cada mudança de assunto e calcule a duração de cada capítulo. Salve a descrição e confira o player. Seu registro final deve mostrar tanto a lista conferida quanto os resultados observados na conta e no player.

Se as legendas públicas existentes ajudarem a localizar mudanças de assunto, use o [YouTube Transcript Scraper](https://apify.com/chronometrica/youtube-transcript-scraper) com a URL do vídeo escolhido. Confira o resultado antes de usá-lo para preparar a lista. Faça a seleção final dos capítulos, a verificação de acesso na conta do proprietário e a inspeção do player como ações separadas.

## Fontes e leituras adicionais

- [Ajuda do YouTube: capítulos de vídeo — verificada em 25 de outubro de 2026; regras de capítulos manuais, substituição de capítulos automáticos e orientações sobre recursos avançados; sem garantia de exibição](https://support.google.com/youtube/answer/9884579?hl=en)
- [YouTube Transcript Scraper — verificado em 25 de outubro de 2026; contrato público da compilação padrão 0.1.43; sem execução paga nem teste em execução](https://apify.com/chronometrica/youtube-transcript-scraper)
- [Task de transcrição com marcações de tempo — verificada em 25 de outubro de 2026; apenas presença da página pública e do ID da Task; entrada salva e execução não testadas](https://apify.com/chronometrica/youtube-transcript-scraper/examples/youtube-timestamped-transcript-json)