What we use the Google APIs for — and what we do not
Mail does not travel through the Gmail API. It arrives over SMTP and leaves over
SMTP. The APIs are used for three things, each one authorized by you through
domain-wide delegation:
- Verifying your setup before cutover
- Confirming the inbound gateway and
routing are right before the MX record moves.
- Finding and removing delivered copies Beta testing
- Searching for every copy of a
message that turned out to be malicious after delivery, and moving them out. A
separate scope from reading, granted separately.
- Account risk telemetry Beta testing
- Google's login audit — suspicious sign-ins,
leaked-password lockouts, government-attack warnings — and Gmail forwarding
settings and filters that send mail to an outside address. Read-only, off until
you turn it on per domain.
Domain-wide delegation is account-wide by construction: a service
account authorized for these scopes can act on any mailbox in the Workspace
account. Google provides no per-mailbox restriction equivalent to Exchange
Online's application access policy. That is how Google's delegation model works,
and it is worth weighing before granting anything.
Current status. Each of the three API uses above is built and
covered by tests against a simulated Google API, and is not yet in use on a live customer
Workspace account. The mail path is separate and is ordinary SMTP: domains protected
today relay to customer-operated mail servers, and no production domain delivers through
a Workspace inbound gateway yet, so a Workspace evaluation comes with a cut-over we work
through with you.