Aplicar Hash em Endereços de E-mail Corretamente no Google Planilhas

Equipe 8apps·

O hash de e-mail falha por causa de maiúsculas, espaços invisíveis e das regras de ponto do Gmail – não do hash. A ordem de normalização que faz os digests baterem.

O hash está certo. O problema é a entrada.

John@Example.com, john@example.com e john@example.com (com espaço no fim) são uma caixa de e-mail e três digests SHA-256 completamente diferentes. Toda correspondência de e-mail que falha remonta a um momento assim – por isso esta página trata sobretudo dos três segundos anteriores ao hash.

A passagem universal: aparar e depois minúsculas

As duas grandes plataformas concordam na base. Meta: "Trim any leading and trailing spaces. Convert all characters to lowercase." Google Ads: minúsculas, sem espaços nas pontas. No Planilhas:

=LOWER(TRIM(A2))

Duas armadilhas sobrevivem a essa fórmula:

  • O espaço não separável. TRIM() não remove o CHAR(160), aquele caractere invisível que exportações CSV e colagens plantam. Se uma célula visualmente limpa produz um digest errado: =SUBSTITUTE(A2, CHAR(160), "") antes.
  • Caracteres ocultos de fontes formatadas. Endereços colados de clientes de e-mail às vezes carregam caracteres de largura zero. Uma conferência de comprimento contra o esperado (=LEN(A2)) é o detector mais barato.

A bifurcação: os pontos e o mais do Gmail

Aqui as plataformas realmente divergem, e copiar a regra de uma para a outra corrompe os dados:

  • Google Ads documenta uma limpeza adicional apenas para endereços gmail.com e googlemail.com: remova os pontos do nome de usuário e tudo a partir de um +. Jane.Doe+Shopping@googlemail.comjanedoe@googlemail.com. Aplicar isso a outros domínios é errado – pontos são significativos na maioria dos sistemas de e-mail, e a regra do Google nomeia apenas esses dois domínios.
  • A Meta não documenta regra alguma de ponto ou mais. Aparar e passar para minúsculas é a instrução documentada inteira.

Ou seja, uma lista com muitos endereços Gmail precisa de duas colunas de e-mail – uma normalizada para o Google, outra para a Meta – exatamente como acontece com telefones (essa história está no nosso guia de hash de telefone).

Então aplique o hash – e prove uma vez

SHA-256, saída hexadecimal em minúsculas – a documentação da Meta especifica hex minúsculo explicitamente. O Planilhas não tem função de hash embutida (não há nada criptográfico em toda a lista de funções do Google), então o digest vem de Apps Script ou de um complemento. Seja qual for, prove o fluxo uma vez: a Meta publica o digest esperado para john_smith@gmail.com

62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f

– então aplique hash exatamente nessa string. A resposta certa valida toda a sua cadeia; qualquer outra coisa significa consertar a fórmula antes de tocar na lista.

A lista de conferência

  1. SUBSTITUTE(…, CHAR(160), "") se a origem foi CSV ou colagem
  2. LOWER(TRIM(…)) – sempre
  3. Limpeza de ponto/mais do Gmail – só na coluna do Google Ads, só nesses dois domínios
  4. SHA-256, hexadecimal minúsculo
  5. Conferência com o vetor de teste – uma vez por fluxo, não por lista

Onde o Hash Data se encaixa

O Hash Data coloca as funções de hash na planilha, ao lado dessas fórmulas, de modo que normalizar-e-aplicar-hash vira um arrastar para baixo em vez de um script para manter – vários algoritmos, saída hexadecimal padrão, dentro da planilha em que a lista já vive.

Fontes