Google Gmail API

Can I search emails by sender, date, and label with the Gmail API?

Yes, the GET /gmail/v1/users/{userId}/messages endpoint accepts a 'q' parameter using the same query syntax as the Gmail search box. You can combine operators like 'from:sender@example.com after:2024/01/01 label:inbox has:attachment' to filter messages precisely. Results return message IDs that you then fetch individually for full content.

What are the rate limits for the Gmail API?

The Gmail API enforces a per-user sending limit of 2,000 messages per day for Google Workspace accounts (500 for free Gmail accounts). API calls are limited to 250 quota units per user per second. Batch operations like batchDelete and batchModify count as single API calls but are limited to 1,000 message IDs per request.

How do I set up real-time email notifications with the Gmail API through Jentic?

Use Jentic to search for 'watch gmail inbox for new messages,' then execute the POST /gmail/v1/users/{userId}/watch endpoint with a Google Cloud Pub/Sub topic name. The watch delivers push notifications for 7 days before requiring renewal. Install Jentic with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, and search for the watch operation to get the full schema.

Is the Gmail API free to use?

The Gmail API itself is free - there are no per-call charges. You need a Google Cloud project with the Gmail API enabled. Usage is governed by quota limits (250 units/second per user) rather than pricing tiers. Google Workspace accounts get higher sending limits than free Gmail accounts.

Can I send emails with attachments using the Gmail API?

Yes, use the POST /gmail/v1/users/{userId}/messages/send endpoint with a multipart MIME message body. Attachments are base64url-encoded in the MIME payload. The API supports attachments up to 25 MB for regular sends and up to 35 MB when using the upload endpoint with resumable upload protocol.

How do I read full email content including HTML and attachments?

Call GET /gmail/v1/users/{userId}/messages/{id} with format=full to receive the complete MIME structure. The response includes all message parts (text/plain, text/html) and attachment metadata. For large attachments, use the separate GET /gmail/v1/users/{userId}/messages/{id}/attachments/{attachmentId} endpoint to download attachment data.

Can I limit what my agent is allowed to do with the Gmail API?

Yes. Because Jentic One is self-hosted, you decide which Gmail operations your agent may call and which OAuth credential it uses, and the Gmail API only ever addresses the authenticated user's own mailbox. You can scope the agent to just the operations it needs, such as sending a message or listing threads, so higher-impact actions like creating labels or setting up a watch stay off unless you explicitly add them. Your OAuth credential is stored once by your own Jentic One instance and injected at execution time, so it never enters the agent's prompt or context.