Como resolvi um bug de mais de 10 anos no Gmail (Google, por favor, corrija)

O Mistério dos E-mails com Estrela Desaparecidos no Gmail: A Descoberta dos Rótulos Secretos

Existe um bug persistente no Gmail, que data de pelo menos uma década, no qual e-mails marcados com estrela ocasionalmente parecem sumir da lista de e-mails favoritados. O problema é que, mesmo com a estrela visível na interface web do e-mail individual, ele não aparece na lista geral de “Starred” (Favoritos), nem quando se utiliza o filtro de pesquisa `is:starred`, ou mesmo o filtro específico por cor `has:yellow-star`. Além disso, o status de “flagged” (bandeira), que corresponde à estrela em aplicativos como o Apple Mail, também não é exibido.

Felizmente, a causa raiz deste comportamento estranho foi finalmente identificada, e ela está ligada a rótulos (labels) internos do sistema do Gmail. Ao investigar, foram encontrados mais de 75 e-mails com esse problema em múltiplas contas, alguns datando de 13 anos atrás.

O que torna a situação mais preocupante é que, sem uma forma de buscar esses e-mails “bugados”, o usuário não tem certeza da extensão do problema. O status de estrela só era visível ao abrir o e-mail diretamente ou se ele aparecesse acidentalmente em uma lista de resultados por outros filtros.

### A Investigação dos Rótulos Secretos

A chave para desvendar o mistério foi analisar o código que exibe a interface web do Gmail, utilizando o painel de desenvolvedor do Chrome. Ao inspecionar as requisições de rede que carregam os dados dos e-mails na caixa de entrada (filtrando por `/fd` na aba de rede), foi possível ver propriedades internas como `^smartlabel_promo` ou `^sq_ig_i_personal`.

A pesquisa por essas propriedades levou à descoberta de um documento do Google intitulado “Google Secret System Labels” (Rótulos Secretos do Sistema do Google), o que abriu o caso.

Ao comparar os rótulos ocultos de e-mails corretamente favoritados com os e-mails problemáticos, foi identificada a diferença crucial:

* **E-mails Corretamente Favoritados:** Possuem dois rótulos relacionados a estrelas:
1. O `^t` (que significa “starred” e está em uma lista oficial de tags do Google).
2. O `^ss_sy` (que significa “superstar star yellow”, correspondendo à cor da estrela).
* **E-mails com o Bug:** Possuem o rótulo de cor (`^ss_sy`), mas **não** possuem o rótulo padrão `^t`.

Todos os filtros de pesquisa do Gmail dependem exclusivamente do rótulo `^t` para determinar se um e-mail está marcado com estrela. Se o `^t` está ausente, mesmo que o rótulo de cor esteja presente, o e-mail não aparecerá nas listas ou buscas de favoritos. A interface web, no entanto, parece exibir a estrela baseada apenas no rótulo de cor.

### Buscando os E-mails Problemáticos

Com o conhecimento dos rótulos ocultos, tornou-se possível buscar diretamente pelos e-mails afetados, utilizando os rótulos secretos na pesquisa, desde que colocados entre aspas.

A busca se baseia em encontrar e-mails que possuam um rótulo de cor, mas que **não** possuam o rótulo padrão de estrela (`^t`). Isso revelou cerca de 75 e-mails em várias contas, alguns de 2012.

### A Causa do Desalinhamento dos Rótulos

A investigação prosseguiu para entender o que causava a ausência do rótulo `^t`. Inicialmente, suspeitou-se do uso do aplicativo Apple Mail para marcar/desmarcar e-mails, já que ele sincroniza o status de estrela com o Gmail.

Testes revelaram que:

1. **Marcar no Web:** Adiciona os rótulos `^t` e o rótulo de cor correspondente (ex: `^ss_sy`). Desmarcar no web remove ambos.
2. **Marcar no Apple Mail:** Adiciona apenas o rótulo `^t`. *Isso resulta em um e-mail corretamente favoritado, pois a interface web não exige o rótulo de cor.*
3. **Desmarcar no Apple Mail (após marcar no web):** Se um e-mail for marcado na interface web (adicionando ambos os rótulos) e depois desmarcado usando o Apple Mail, isso resulta no e-mail “bugado”: o Apple Mail remove apenas o `^t`, deixando para trás o rótulo de cor.

Este comportamento não é um erro do Apple Mail, mas sim uma consequência de como a API do Gmail interage com os rótulos.

### O Papel da API do Gmail

Ao testar o endpoint `messages.modify` da API do Gmail, foi constatado que a maneira oficial de estrelar/desestrelar via API usa apenas o rótulo básico `STARRED` (que corresponde ao `^t`). A API não manipula os rótulos específicos de cor (`^ss_sy`, etc.).

Se um e-mail é estrelado na interface web (adicionando o rótulo de cor) e depois desmarcado via API, o rótulo de cor permanece. Esse comportamento é o mesmo que ocorre quando o Apple Mail desmarca a estrela, pois ambos os métodos de desmarcação falham em remover o rótulo de cor.

Este problema na API já foi reportado no Google Bug Tracker desde 2018, mas a conexão com os rótulos ocultos não havia sido feita nas discussões anteriores.

### Consequências e Soluções Propostas

O mesmo erro se manifesta de forma oposta em relatórios de desenvolvedores: eles têm dificuldade em desmarcar e-mails, pois o rótulo de cor permanece, enquanto usuários da interface web e aplicativos como o Apple Mail notam que os e-mails somem da lista de favoritos (porque o `^t` foi removido).

Existem duas possíveis correções:

1. **Correção na API:** A API deveria ser atualizada para remover todos os rótulos relacionados à estrela (tanto o `^t` quanto o de cor) quando um e-mail é desmarcado, espelhando o comportamento da interface nativa do Gmail.
2. **Correção na Interface Web:** O lado da interface web poderia ser ajustado para não exibir o ícone de estrela quando o e-mail possui apenas o rótulo de cor e não o rótulo base `^t`. Isso resolveria o problema visual, embora os rótulos “órfãos” de cor permaneceriam no sistema.

Enfim, este bug, que pode ter existido desde o início do Gmail, finalmente foi diagnosticado em sua raiz técnica.

### Perguntas Frequentes

  • Como posso verificar se meus e-mails com estrela estão afetados por este bug?
    Você pode usar filtros de busca avançada no Gmail que procuram por e-mails que possuem um rótulo de cor, mas não possuem o rótulo padrão de estrela, como indicado no artigo.
  • Qual a diferença entre os rótulos ^t e ^ss_sy?
    O rótulo ^t é o indicador padrão universal de que um e-mail está marcado como estrela. O rótulo ^ss_sy (e outros similares) indica especificamente a cor da estrela utilizada (amarela, neste caso).
  • É possível que este bug afete todos os meus e-mails com estrela?
    Não. O bug só ocorre quando há uma inconsistência na remoção dos rótulos, geralmente após usar o Gmail Web para marcar e um aplicativo de terceiros que usa a API (como o Apple Mail) para desmarcar.
  • Por que os e-mails bugados aparecem no web, mas não na lista de favoritos?
    A interface web exibe a estrela baseada no rótulo de cor (como ^ss_sy), mas os filtros de lista e busca usam exclusivamente o rótulo base ^t, que está ausente nos e-mails afetados.
  • Qual a melhor forma de corrigir os e-mails que já estão com o bug?
    Para os e-mails já afetados, a solução manual é marcá-los com estrela novamente (preferencialmente pela interface web) para forçar a adição do rótulo ^t, ou usar os filtros de busca para identificar e remover o rótulo de cor remanescente.