---
description: Concepts used in Gmail BDK Book.
---

# Concepts

### Gmail email

A Gmail Email represents an email message in Gmail.

| Field Name                                   | Description                                                | Type                                 |
| -------------------------------------------- | ---------------------------------------------------------- | ------------------------------------ |
| `id`                                         | The unique identifier for the email.                       | `text`                               |
| `thread_id`                                  | The unique identifier for the thread containing the email. | `text`                               |
| [`labels`](#list-of-text)                    | The list of labels applied to the email.                   | `list of text`                       |
| `state`                                      | The state of the email (draft, unread, or read).           | `text`                               |
| `sender`                                     | The sender of the email.                                   | `text`                               |
| [`recipients`](#list-of-text)                | The recipients of the email.                               | `list of text`                       |
| `message_id`                                 | The unique identifier for the message.                     | `optional[text]`                     |
| [`cc_recipients`](#list-of-text)             | The cc recipients of the email.                            | `list of text`                       |
| [`bcc_recipients`](#list-of-text)            | The bcc recipients of the email.                           | `list of text`                       |
| [`attachments`](#gmail-attachment-reference) | The attachments of the email.                              | `list of gmail attachment reference` |
| `subject`                                    | The subject of the email.                                  | `optional[text]`                     |
| `plain_body`                                 | The plain text body of the email.                          | `optional[text]`                     |
| `html_body`                                  | The html body of the email.                                | `optional[text]`                     |
| `sent_date_time`                             | The date and time the email was sent.                      | `optional[datetime]`                 |
| `received_date_time`                         | The date and time the email was received.                  | `optional[datetime]`                 |

### Gmail attachment reference

A Gmail Attachment Reference represents a reference to a file attached to an email in Gmail.

| Field Name  | Description                               | Type     |
| ----------- | ----------------------------------------- | -------- |
| `id`        | The unique identifier for the attachment. | `text`   |
| `email_id`  | The unique identifier for the email.      | `text`   |
| `file_name` | The name of the attachment.               | `text`   |
| `file_size` | The size of the file in bytes.            | `number` |

### Gmail attachment

A Gmail Attachment represents a file with name.

| Field Name  | Description                    | Type   |
| ----------- | ------------------------------ | ------ |
| `file_name` | The name of the attachment.    | `text` |
| `content`   | The content of the attachment. | `file` |
