Gmail Unread Count — A2UI Atomic Catalog

Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.

Surfaces

apps-script-webmeet-stage

Fields

Field	Type
labels	array. Gmail label names to count. Default ["INBOX"].	optional
title	string. Card heading. Default is "Gmail".	optional
accent	string. Badge colour for non-zero counts. Default red.	optional
counts	object (static connector). Label→count map for non-GAS surfaces.	required
auth_token	string (api connector). OAuth2 bearer token for REST API.	required

Example payload

{
  "type": "gmail_unread_count",
  "counts": "42",
  "auth_token": "your-api-token"
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:gmail_unread_count",
  "displayName": "Gmail Unread Count",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/gmail_unread_count",
  "capabilities": [
    "apps-script-web",
    "meet-stage"
  ],
  "description": "Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.",
  "representativeQueries": [
    "show a unread count badges for Gmail labels",
    "unread message count badges for one or more gmail labels, shown as a pill row. zero counts are displ",
    "render a gmail unread count"
  ]
}

Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy

Full deploy guide →