Google: Gets the specified message — response body
Gets the specified message.: response body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Gets the specified message — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An email message. |
classificationLabelValues | array | Optional | Classification Label values on the message. Available Classification Label schemas can be queried using the Google Drive Labels API. Each classification label ID must be unique. If duplicate IDs are provided, only one will be retained, and the selection is arbitrary. Only used for Google Workspace accounts. There’s a limit of 20 Classification Label values per request. If the Classification Label values exceeds the maximum allowed number, the request fails. |
classificationLabelValues[] | Model | Each item | Expand Gets the specified message — response body — classification Label Values item |
historyId | string | Optional | The ID of the last history record that modified this message. Format: uint64 |
id | string | Optional | The immutable ID of the message. |
internalDate | string | Optional | The internal message creation timestamp (epoch ms), which determines ordering in the inbox. For normal SMTP-received email, this represents the time the message was originally accepted by Google, which is more reliable than the `Date` header. However, for API-migrated mail, it can be configured by client to be based on the `Date` header. Format: int64 |
labelIds | array | Optional | List of IDs of labels applied to this message. |
labelIds[] | string | Each item | |
payload | Model | Optional | Expand Gets the specified message — response body — payload The parsed email structure in the message parts. |
raw | string | Optional | The entire email message in an RFC 2822 formatted and base64url encoded string. Returned in `messages.get` and `drafts.get` responses when the `format=RAW` parameter is supplied. @required gmail.users.drafts.create gmail.users.drafts.update Format: byte |
sizeEstimate | JSON | Optional | |
sizeEstimate (anyOf 1) | integer | Alternative | Estimated size in bytes of the message. Format: int32 |
sizeEstimate (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
snippet | string | Optional | A short part of the message text. |
threadId | string | Optional | The ID of the thread the message belongs to. To add a message or draft to a thread, the following criteria must be met: 1. The requested `threadId` must be specified on the `Message` or `Draft.Message` you supply with your request. 2. The `References` and `In-Reply-To` headers must be set in compliance with the [RFC 2822](https://tools.ietf.org/html/rfc2822) standard. 3. The `Subject` headers must match. |
Referenced models: Gets the specified message — response body — classification Label Values item, Gets the specified message — response body — payload