Send email and manage drafts (send/draft/metadata-level access only)
https://gmail.googleapis.com/gmail/v1/users/me/messages/send
| Param | Type | Required | Description |
|---|---|---|---|
| raw | string | required | The entire RFC 2822 formatted email (headers + body), base64url-encoded (matches Gmail API's messages.send resource) |
| threadId | string | optional | Thread ID to associate this message with, for replies |
/users/me/messages
| Param | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Gmail search query, e.g. 'from:someone@example.com is:unread' |
| labelIds | array | optional | Only return messages with all of these label IDs |
| maxResults | integer | optional | Maximum number of messages to return |
| pageToken | string | optional | Page token for pagination |
| includeSpamTrash | boolean | optional | Include SPAM and TRASH in results |
/users/me/labels
/users/me/drafts
| Param | Type | Required | Description |
|---|---|---|---|
| message | object | required | Draft message resource, e.g. { raw: '<base64url RFC 2822 message>', threadId?: '...' } |
/users/me/drafts
| Param | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Gmail search query to filter drafts |
| maxResults | integer | optional | Maximum number of drafts to return |
| pageToken | string | optional | Page token for pagination |
| includeSpamTrash | boolean | optional | Include SPAM and TRASH in results |
/users/me/drafts/{id}
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
| format | string | optional | Response format: full, metadata, minimal, or raw |
/users/me/drafts/{id}
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
| message | object | required | Replacement draft message resource, e.g. { raw: '<base64url RFC 2822 message>', threadId?: '...' } |
/users/me/drafts/{id}
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
/users/me/drafts/send
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID to send |