Enviar un correo
Un mensaje ahora o más tarde, con adjuntos, o cien en una sola petición.
Enviar un mensaje
Map<String, Object> email = client.emails().send(Body.of( "from", "Acme Billing <[email protected]>", "to", List.of("[email protected]", Body.of("email", "[email protected]", "name", "Grace")), "replyTo", "[email protected]", "subject", "Your September invoice", "html", "<p>Invoice attached.</p>", "text", "Invoice attached."), RequestOptions.create().idempotencyKey("invoice-2026-09-ada")); System.out.println(email.get("id") + " " + email.get("status"));to, cc y bcc admiten una dirección o una lista, y una dirección es un texto como Ada <[email protected]> o un mapa con email y name. El cuerpo viene de html y text, de un template guardado o de un draftId.
Cada envío lleva una clave de idempotencia. El cliente crea una por llamada y la reutiliza cuando reintenta, así que una petición reintentada reproduce el primer mensaje. Pasa idempotencyKey en un RequestOptions para que eso se mantenga entre procesos y reinicios.
Adjuntos
byte[] report = "month,total".getBytes(StandardCharsets.UTF_8); client.emails().send(Body.of( "from", "[email protected]", "to", "[email protected]", "subject", "Your September report", "text", "The report is attached.", "attachments", List.of( Body.of("filename", "report.csv", "content", report, "contentType", "text/csv"), Body.of("fileId", "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f") )));content admite un byte[] o un Path, que el cliente codifica en base64, o texto que ya está en base64. fileId nombra un archivo subido con client.files().upload, que es como se envía un archivo de más de 5 MB.
Enviar más tarde
Map<String, Object> scheduled = client.emails().send(Body.of( "from", "[email protected]", "to", "[email protected]", "subject", "Your invoice is due tomorrow", "text", "A reminder that your invoice is due tomorrow.", "scheduledAt", Instant.now().plus(Duration.ofHours(1)))); String id = (String) scheduled.get("id"); client.emails().reschedule(id, Instant.now().plus(Duration.ofHours(2)));client.emails().cancel(id);scheduledAt admite un Instant, un instante ISO 8601 como texto o una duración como PT1H. Un Instant, un OffsetDateTime o un ZonedDateTime en cualquier parte de un cuerpo se envía como un instante ISO 8601 en UTC. Un mensaje programado se puede cambiar o cancelar hasta que sale.
Enviar un lote
BatchResult batch = client.emails().sendBatch(List.of( Body.of("from", "[email protected]", "to", "[email protected]", "subject", "Your invoice", "text", "Invoice attached."), Body.of("from", "[email protected]", "to", "[email protected]", "subject", "Your invoice", "text", "Invoice attached."))); for (Map<String, Object> item : batch) { if ("error".equals(item.get("status"))) { System.err.println(item.get("index") + " " + item.get("error")); }} System.out.println(batch.sent() + " sent, " + batch.failed() + " failed");Un lote admite hasta 100 mensajes y nunca es todo o nada: una dirección incorrecta hace fallar su propio elemento y el resto sale igualmente. Comprueba failed() y el status de cada elemento en lugar de confiar en una excepción.