E-mails

Mande "enrich": ["emails"] ao pedir a estimativa ou começar uma coleta. Enquanto buscamos cada quadrado, também procuramos e-mails no próprio site de cada empresa:

curl -X POST https://api.gmaps.dev/v1/collections \
  -H "Authorization: Bearer $GMAPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["padaria"],
    "geo": { "location": "Curitiba, PR" },
    "enrich": ["emails"]
  }'

Só procuramos nos quadrados que a coleta busca. Um lugar que já tínhamos salvado vem com os e-mails que encontramos para ele antes, se encontramos algum. Uma busca nunca procura e-mails.

Você precisa de duas coisas, e conferimos nesta ordem:

1. Um plano com e-mails: Starter, Pro e Scale. Em qualquer outro plano, a resposta é 402 PLAN_GATE, e o details.upgradeTo diz para qual plano mudar. Você troca de plano na página Plano.
2. A política de uso aceitável, aceita na sua conta. Você aceita no console, em Conta. Até lá, a resposta é 403 AUP_REQUIRED, e o details.version diz qual versão aceitar. Quando publicamos uma versão nova, você aceita de novo para os e-mails voltarem.

A estimativa responde com os mesmos erros, então dá para conferir de graça.

Cada lugar novo custa 1 crédito, como sempre. Quando encontramos pelo menos um e-mail dele, custa 1 a mais. A conta é por lugar, não por endereço, e um lugar sem e-mail não custa nada a mais. Lugares que já tínhamos continuam de graça, com e-mail e tudo.

O maxCost da estimativa conta 2 créditos por lugar, o máximo que pode dar. No progresso ao vivo, um lugar que veio com e-mail mostra cost: 2, e o counts.creditsCharged inclui os créditos a mais.

Os e-mails vêm em contact.emails, em cada lugar:

{
  "contact": {
    "phones": ["+55 41 0000-0000"],
    "website": "https://padariaestrela.example",
    "emails": ["contato@padariaestrela.example"]
  }
}

Você os vê onde lê lugares: nos lugares de uma coleta, numa busca, num lugar consultado sozinho e na coluna E-mails de uma exportação. Se um lugar vier sem contact.emails, não temos nenhum e-mail dele. O progresso ao vivo nunca traz e-mails, então leia na coleta.

Só contas que podem pedir e-mails conseguem lê-los, inclusive os que salvamos antes. Se o seu plano deixar de ter e-mails, ou uma versão nova da política estiver esperando o seu aceite, os lugares voltam sem o campo e as exportações que você criar vêm com a coluna E-mails vazia, até você poder pedir de novo.

Um e-mail no site de uma empresa é público, mas isso não torna qualquer uso dele legal. A nossa política de uso aceitável diz:

• Um e-mail público não é autorização para mandar marketing, e pagar o gmaps.dev também não dá essa autorização.
• Você precisa de uma base legal para cada mensagem, ou seja, um motivo que a lei aceita, como o consentimento quando a lei exige.
• Não faça prospecção que a lei proíbe, onde você está ou onde a empresa está.
• Não contate quem pediu remoção. Quando alguém nos pede para remover um e-mail, ele sai de todas as leituras e exportações a partir dali. Arquivos que você salvou antes ainda têm o e-mail, então tire de lá também.

Suspendemos contas que descumprem a política. A nossa política de privacidade explica como encontramos os e-mails e por que podemos fazer isso, e qualquer pessoa pode pedir a remoção do seu pelo formulário de remoção.