Set up Gmail Inbox
alphaSetup guide coming soon. Gmail Inbox has no step-by-step guide in the catalogue yet. Until it does, here is what a connection needs, and where to read more.
What a connection holds
| Field | Secret | Where it comes from |
|---|---|---|
OAuth client IDclientId | Not secret | From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation. This connector requests a RESTRICTED scope, and Google verifies per OAuth client: sharing one client with the other Google connectors (one consent, one grant) puts every Google feature behind the annual CASA assessment; a separate client for this connector keeps it here alone, at the cost of a second consent. Your choice. |
OAuth client secretclientSecret | Secret | The client secret for the same OAuth app. One value for the whole installation. |
Access tokenaccessToken | Secret | Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token. |
Refresh tokenrefreshToken | Secret | Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour. |
Push audience (optional)pushAudience | Not secret | The audience set on the Pub/Sub PUSH subscription (normally the endpoint URL your host mounts for message_received). Every push's Google-signed token must name it; an unchecked audience accepts any token Google signs for anyone. Needed only for the message_received trigger. |
Push service account (optional)pushServiceAccount | Not secret | The service account the push subscription authenticates as (its email). Every push's token must be for exactly this account: a stranger's subscription aimed at your URL carries a token Google signed correctly, and only this check refuses it. Needed only for message_received. |
Links
Gmail Inbox API docs
Consent is requested at https://accounts.google.com/o/oauth2/v2/auth
React (editor surface, every host)
@particle-academy/gmail-inbox-ui v0.4.1Python
fancy-gmail-inbox v0.4.1
