Correos electrónicos

Agrega "enrich": ["emails"] cuando pidas una estimación o empieces una recopilación. Mientras buscamos en cada cuadro, también buscamos correos electrónicos en el sitio web de cada negocio:

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

Solo buscamos en los cuadros que recorre la recopilación. Un lugar que ya teníamos guardado trae los correos que encontramos antes para él, si encontramos alguno. Una búsqueda nunca busca correos.

Necesitas dos cosas, y las revisamos en este orden:

1. Un plan con correos electrónicos: Starter, Pro y Scale. En cualquier otro plan la respuesta es 402 PLAN_GATE, y details.upgradeTo dice a qué plan pasar. Puedes cambiar de plan en la página Plan.
2. La política de uso aceptable, aceptada en tu cuenta. La aceptas en la consola, en Cuenta. Hasta entonces, la respuesta es 403 AUP_REQUIRED, y details.version dice qué versión aceptar. Cuando publicamos una versión nueva, la aceptas otra vez para que vuelvan los correos.

Una estimación responde con los mismos errores, así que puedes comprobarlo gratis.

Cada lugar nuevo cuesta 1 crédito, como siempre. Cuando encontramos al menos un correo electrónico de ese lugar, cuesta 1 más. Se cobra por lugar, no por dirección, y un lugar sin correo no cuesta nada extra. Los lugares que ya teníamos siguen siendo gratis, correos incluidos.

El maxCost de una estimación cuenta 2 créditos por lugar, lo máximo que puede costar. En el progreso en vivo, un lugar que llegó con un correo muestra cost: 2, y counts.creditsCharged incluye los créditos extra.

Los correos llegan en contact.emails, en cada lugar:

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

Los ves donde lees lugares: en los lugares de una recopilación, en una búsqueda, en un lugar consultado por sí solo y en la columna de correos de una exportación. Si un lugar no trae contact.emails, no tenemos ningún correo de ese lugar. El progreso en vivo nunca los trae, así que léelos desde la recopilación.

Solo las cuentas que pueden pedir correos pueden leerlos, incluidos los que guardamos antes. Si tu plan ya no incluye correos, o te espera una versión nueva de la política, los lugares llegan sin el campo y las exportaciones que hagas tienen la columna de correos vacía, hasta que puedas pedirlos de nuevo.

Un correo en el sitio web de un negocio es público, pero eso no hace legal cualquier uso. Nuestra política de uso aceptable dice:

• Un correo público no es permiso para enviar marketing, y pagarle a gmaps.dev tampoco te da ese permiso.
• Necesitas una base legal para cada mensaje: un motivo que la ley acepta, como el consentimiento cuando la ley lo pide.
• No hagas prospección comercial que la ley prohíba, ya sea donde estás tú o donde está el negocio.
• No contactes a quien pidió ser eliminado. Cuando alguien nos pide eliminar un correo, desde ese momento deja de aparecer en toda lectura y exportación. Los archivos que guardaste antes todavía lo tienen, así que quítalo también de ahí.

Suspendemos las cuentas que incumplen la política. Nuestra política de privacidad explica cómo encontramos los correos y por qué podemos hacerlo, y cualquier persona puede pedirnos que eliminemos el suyo con el formulario de eliminación.