Por que o limite de caracteres das tags do YouTube cobra aspas e vírgulas

Qual é o limite de caracteres das tags do YouTube?

O Google define o limite de caracteres das tags do YouTube em 500 caracteres para a lista inteira de tags de um vídeo, e conta vírgulas e aspas implícitas nesse total. A regra fica na propriedade snippet.tags[] do recurso videos na referência da YouTube Data API, que diz: "A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters." Os 500 são um orçamento para a lista inteira. Nenhuma tag tem teto próprio, e o YouTube não documenta um número máximo de tags.

O mesmo recurso videos define os outros dois limites de texto de um upload, em unidades diferentes.

Campo	Limite documentado	Unidade	Propriedade na API
Lista de tags	500	caracteres	snippet.tags[]
Título do vídeo	100	caracteres	snippet.title
Descrição do vídeo	5000	bytes	snippet.description

A descrição é a exceção, medida em bytes, e a nossa análise do limite de caracteres da descrição do YouTube explica essa unidade.

Como o YouTube conta os caracteres da lista de tags?

O YouTube conta cada letra de cada tag, mais um caractere por vírgula entre as tags, mais dois caracteres pelas aspas em volta de qualquer tag que tenha espaço. A referência da API detalha as duas cobranças extras na descrição da propriedade:

"The property value is a list, and commas between items in the list count toward the limit. If a tag contains a space, the API server handles the tag value as though it were wrapped in quotation marks, and the quotation marks count toward the character limit. So, for the purposes of character limits, the tag Foo-Baz contains seven characters, but the tag Foo Baz contains nine characters."

Foo-Baz e Foo Baz têm sete teclas cada. A que tem espaço custa 9, porque o servidor a conta como "Foo Baz".

A cobrança da vírgula vale mesmo quando você nunca digita uma vírgula. Pela API, você envia as tags como um array JSON, e o servidor ainda acrescenta um caractere para cada intervalo entre os itens. Uma lista de 20 tags carrega 19 vírgulas que você não vê.

Juntando tudo, a fórmula de uma lista de tags é curta:

1. Some as letras, os dígitos, os espaços e a pontuação de todas as tags.
2. Some 2 para cada tag que tenha pelo menos um espaço.
3. Some o número de tags menos 1, pelas vírgulas.
4. Compare o resultado com 500.

Uma tag com três espaços continua custando só 2 a mais. A cobrança das aspas vale uma vez por tag, não uma vez por espaço.

Quantos caracteres uma lista de tags real usa?

Uma lista de tags real usa mais caracteres do que as suas letras, e a diferença cresce a cada tag com várias palavras. Veja seis tags que um canal de pães colocaria em um tutorial de fermento natural.

Tag	Letras e espaços	Cobrança das aspas	Custo
sourdough	9	0	9
sourdough starter	17	2	19
sour dough	10	2	12
how to feed a sourdough starter	31	2	33
no knead bread	14	2	16
levain	6	0	6
Vírgulas entre 6 tags			5
Total	87	8	100

Um contador que soma as tags como foram digitadas informa 87. O YouTube cobra 100, um acréscimo de 15 por cento em seis tags. A tag sour dough está ali de propósito, porque erros de grafia são o único trabalho que o YouTube diz que as tags fazem bem.

Quantas tags cabem em 500 caracteres?

O número de tags que cabem em 500 caracteres depende do tamanho das tags e de quantas delas têm espaços, então não existe uma quantidade fixa. A fórmula dá respostas exatas para qualquer lista, e alguns formatos mostram a variação.

Formato da lista de tags	Custo por tag	Vírgulas	Total da lista	Cabe?
20 tags de uma palavra, 24 letras cada	24	19	499	Sim
20 tags de duas palavras, 22 letras e espaços cada	24	19	499	Sim
20 tags de duas palavras, 23 letras e espaços cada	25	19	519	Não
21 tags de duas palavras, 20 letras e espaços cada	22	20	482	Sim
50 tags de uma palavra, 9 letras cada	9	49	499	Sim

As linhas dois e três mostram como a margem é pequena. Uma letra a mais por tag em 20 tags de várias palavras leva a lista de 499 para 519. É assim que uma lista que o seu app de notas conta com 460 caracteres acaba rejeitada em 519.

A última linha é permitida e mesmo assim é má ideia, pelos motivos que as páginas de ajuda do YouTube apresentam.

As tags do YouTube ainda importam para a descoberta?

As tags do YouTube importam menos do que o título, a miniatura e a descrição, e o YouTube diz isso na sua página de ajuda sobre como adicionar tags: "Your video's title, thumbnail, and description are more important pieces of metadata for your video's discovery." A mesma página cita o caso em que as tags valem a pena: "Tags can be useful if the content of your video is commonly misspelled. Otherwise, tags play a minimal role in your video's discovery."

Eu leio isso como uma regra de gasto para os 500 caracteres. Gaste-os com os erros de grafia e as grafias alternativas que as pessoas digitam na busca, como sour dough ao lado de sourdough, e com termos que não cabem naturalmente no título. Não os gaste com 40 quase-duplicatas do título. A página de ajuda acrescenta um aviso sobre o sentido oposto: "Adding excessive tags to your video description is against our policies on spam, deceptive practices, and scams."

Uma palavra-chave que importa para você vai primeiro no título e depois nas linhas iniciais da descrição, onde as regras de formatação de texto do YouTube decidem o que é renderizado.

Qual é a diferença entre tags e hashtags do YouTube?

As tags do YouTube são palavras-chave ocultas no campo de tags, e as hashtags são palavras visíveis com # no título ou na descrição que levam a uma página de resultados da hashtag. Elas saem de orçamentos diferentes. As tags contam para o limite de 500 caracteres das tags. As hashtags contam para os 100 caracteres do título ou para os 5000 bytes da descrição.

A página de política de hashtags do YouTube define regras próprias para o tipo visível. "Out of all the hashtags you add to the video's description, up to three hashtags that are considered most engaging will appear by your video title." Ela também define um limite rígido: "If a video or playlist has more than 60 hashtags, we'll ignore each hashtag on that content." A mesma página fecha a brecha de colar uma lista de tags na descrição: "adding ordinary descriptive tags or repetitive sentences in the description is (still) prohibited."

Uma lista de tags que não cabe em 500 caracteres também não deve ir para a descrição. O nosso explicativo sobre o que é uma hashtag trata das hashtags nas outras redes.

O que acontece quando a lista de tags passa de 500 caracteres?

Um upload cuja lista de tags quebra a regra dos 500 caracteres falha, e o erro que a referência de videos.insert lista para tags inválidas é invalidTags, com status 400 Bad Request. A tabela de erros o descreve como "The request metadata specifies invalid video keywords." Esse texto não cita nem o limite nem a regra de contagem, então um desenvolvedor que nunca leu a nota da propriedade não recebe nenhuma pista de que vírgulas e aspas estouraram a lista.

Um 400 rejeita a requisição de insert inteira, não só as tags, então um upload agendado perde o horário até alguém encurtar a lista e enviá-la de novo. Se você publica pela API com agendamento, o nosso guia para agendar um vídeo pela API do YouTube passa pelo resto da requisição de upload.

O que acontece quando uma lista de tags ultrapassa 500 caracteres

1

A contagem sai alta. Uma lista de 20 tags de duas palavras com 23 letras e espaços cada uma soma 519 caracteres, acima do limite de 500.

2

O pedido de inserção falha. O videos.insert devolve um 400 Bad Request com o erro invalidTags.

3

Todo o pedido é rejeitado. Não só o campo de tags, o upload inteiro falha.

4

O horário agendado é perdido. O upload espera até alguém reduzir a lista e reenviá-la.

Como reduzir uma lista de tags do YouTube para caber no limite?

Reduza uma lista de tags do YouTube contando do jeito que a API conta e cortando as tags que repetem o título antes de cortar os erros de grafia.

1. Cole a lista em uma planilha, uma tag por linha.
2. Na coluna seguinte, calcule o tamanho de cada tag e some 2 quando a tag tiver espaço.
3. Some essa coluna e depois acrescente o número de linhas menos 1.
4. Se o total passar de 500, apague primeiro as tags que repetem palavras que já estão no título.
5. Troque tags com espaço por palavras únicas quando o sentido se mantiver. nokneadbread não mantém o sentido, então fique com no knead bread e corte em outro lugar.
6. Guarde os erros de grafia comuns e as grafias alternativas para o fim. São essas as tags que a página de ajuda do YouTube diz que são úteis.
7. Mire alguns caracteres abaixo de 500, para que uma edição de última hora em uma tag não faça a lista estourar.

Uma fórmula de planilha como =LEN(A2)+IF(ISNUMBER(SEARCH(" ",A2)),2,0) faz o passo 2 de uma vez só.

Como o AdaptlyPost lida com as tags do YouTube?

O AdaptlyPost permite definir as tags de um vídeo do YouTube junto com o título, a descrição, a miniatura e o horário de publicação, e depois publica o vídeo no canal conectado no horário agendado. O agendador de vídeos do YouTube cobre o fluxo pelo painel, e a API de upload de vídeos do YouTube documenta o fluxo programático. Na API, youtubeConfigs.tags aceita até 20 tags, e uma requisição com mais de 20 tags, ou com um videoTitle acima de 100 caracteres, volta como 400 na chamada de criação, antes de qualquer post existir. O teto de 20 tags é do AdaptlyPost. O orçamento de 500 caracteres, com as cobranças de vírgulas e aspas, é do YouTube e vale por cima disso. Vinte tags longas de várias palavras podem passar pela primeira verificação e ainda assim quebrar a segunda, então faça a conta acima antes de agendar. As mesmas regras de metadados valem quando você agenda YouTube Shorts.

Perguntas frequentes

O limite de tags do YouTube é de 500 caracteres por tag ou para todas as tags?

O limite de 500 caracteres cobre a lista inteira de tags de um vídeo. A YouTube Data API o documenta na propriedade de lista snippet.tags[], e nenhuma tag tem teto separado.

As vírgulas contam para o limite de caracteres das tags do YouTube?

Sim. A referência da API afirma que "commas between items in the list count toward the limit." Uma lista de 20 tags carrega 19 vírgulas, que custam 19 caracteres mesmo quando você envia as tags como array JSON e nunca digita uma vírgula.

Por que uma tag com espaço custa dois caracteres a mais?

O servidor da API trata qualquer tag com espaço como se estivesse entre aspas, e essas duas aspas contam para os 500. A referência dá o exemplo de que Foo-Baz custa 7 caracteres e Foo Baz custa 9. A cobrança é de 2 por tag, não importa quantos espaços a tag tenha.

Quantas tags um vídeo do YouTube pode ter?

O YouTube não documenta um número máximo de tags, apenas o orçamento de 500 caracteres para a lista. Cinquenta tags curtas de uma palavra cabem, e vinte tags longas de várias palavras não. A API do AdaptlyPost acrescenta o seu próprio teto de 20 tags por vídeo.

Que erro o YouTube lista para tags inválidas?

A tabela de erros de videos.insert lista invalidTags, um 400 Bad Request descrito como "The request metadata specifies invalid video keywords." A requisição de upload inteira falha. A mensagem não menciona o limite de 500 nem as cobranças de vírgulas e aspas.

Vale a pena adicionar tags no YouTube?

Vale a pena adicionar tags para erros de grafia e grafias alternativas do seu tema. A página de ajuda do YouTube diz que as tags "can be useful if the content of your video is commonly misspelled" e que, fora isso, "play a minimal role" na descoberta. Coloque a sua palavra-chave principal no título e na descrição primeiro.

Como contar os caracteres de uma lista de tags antes de publicar?

Cole as tags em uma planilha, uma por linha, e calcule o comprimento de cada tag mais 2 para qualquer tag com espaço. Some essa coluna e acrescente o número de tags menos um pelas vírgulas. Uma fórmula como =LEN(A2)+IF(ISNUMBER(SEARCH(" ",A2)),2,0) faz o comprimento e o custo das aspas de uma vez só. Mire em ficar alguns caracteres abaixo de 500, para que um ajuste de última hora não empurre a lista para além do limite.

O limite de tags do AdaptlyPost é igual ao orçamento de 500 caracteres do YouTube?

Não, a API do AdaptlyPost limita uma lista de tags a 20 tags, um limite separado do orçamento de 500 caracteres do YouTube. Os dois valem ao mesmo tempo, então um pedido com mais de 20 tags falha antes mesmo de existir uma publicação, e uma lista de 20 tags que passa nessa checagem ainda pode quebrar a regra dos 500 caracteres do YouTube por causa das vírgulas e aspas. Vinte tags longas de várias palavras são a forma com mais chance de esbarrar nos dois limites.

A palavra-chave principal deve ir nas tags ou no título?

Primeiro no título, depois nas primeiras linhas da descrição, onde as regras de formatação de texto do YouTube decidem o que aparece. A própria página de ajuda do YouTube coloca título, miniatura e descrição acima das tags para a descoberta. As tags são o lugar para erros de ortografia e variações de grafia, não para a palavra-chave principal.

As regras da lista de tags também valem para os YouTube Shorts agendados pelo AdaptlyPost?

As mesmas regras de metadados valem ao agendar YouTube Shorts pelo AdaptlyPost como para vídeos normais. O orçamento de 500 caracteres para tags, os custos de vírgulas e aspas, e o limite de 20 tags do AdaptlyPost continuam os mesmos.