Blame - docs/dyn/gmail_v1.users.messages.html - platform/external/python/google-api-python-client

blob: 76b2329ebc25e173e89ad7ce08f22707702add1b [file] [log] [blame]

Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	1	<html><body>
				2	<style>
				3
				4	body, h1, h2, h3, div, span, p, pre, a {
				5	margin: 0;
				6	padding: 0;
				7	border: 0;
				8	font-weight: inherit;
				9	font-style: inherit;
				10	font-size: 100%;
				11	font-family: inherit;
				12	vertical-align: baseline;
				13	}
				14
				15	body {
				16	font-size: 13px;
				17	padding: 1em;
				18	}
				19
				20	h1 {
				21	font-size: 26px;
				22	margin-bottom: 1em;
				23	}
				24
				25	h2 {
				26	font-size: 24px;
				27	margin-bottom: 1em;
				28	}
				29
				30	h3 {
				31	font-size: 20px;
				32	margin-bottom: 1em;
				33	margin-top: 1em;
				34	}
				35
				36	pre, code {
				37	line-height: 1.5;
				38	font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
				39	}
				40
				41	pre {
				42	margin-top: 0.5em;
				43	}
				44
				45	h1, h2, h3, p {
				46	font-family: Arial, sans serif;
				47	}
				48
				49	h1, h2, h3 {
				50	border-bottom: solid #CCC 1px;
				51	}
				52
				53	.toc_element {
				54	margin-top: 0.5em;
				55	}
				56
				57	.firstline {
				58	margin-left: 2 em;
				59	}
				60
				61	.method {
				62	margin-top: 1em;
				63	border: solid 1px #CCC;
				64	padding: 1em;
				65	background: #EEE;
				66	}
				67
				68	.details {
				69	font-weight: bold;
				70	font-size: 14px;
				71	}
				72
				73	</style>
				74
				75	<h1><a href="gmail_v1.html">Gmail API</a> . <a href="gmail_v1.users.html">users</a> . <a href="gmail_v1.users.messages.html">messages</a></h1>
				76	<h2>Instance Methods</h2>
				77	<p class="toc_element">
				78	<code><a href="gmail_v1.users.messages.attachments.html">attachments()</a></code>
				79	</p>
				80	<p class="firstline">Returns the attachments Resource.</p>
				81
				82	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	83	<code><a href="#batchDelete">batchDelete(userId, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	84	<p class="firstline">Deletes many messages by message ID. Provides no guarantees that messages were not already deleted or even existed at all.</p>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	85	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	86	<code><a href="#batchModify">batchModify(userId, body=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	87	<p class="firstline">Modifies the labels on the specified messages.</p>
				88	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	89	<code><a href="#close">close()</a></code></p>
				90	<p class="firstline">Close httplib2 connections.</p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	91	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	92	<code><a href="#delete">delete(userId, id, x__xgafv=None)</a></code></p>
				93	<p class="firstline">Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer `messages.trash` instead.</p>
				94	<p class="toc_element">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	95	<code><a href="#get">get(userId, id, format=None, metadataHeaders=None, x__xgafv=None)</a></code></p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	96	<p class="firstline">Gets the specified message.</p>
				97	<p class="toc_element">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	98	<code><a href="#import_">import_(userId, body=None, neverMarkSpam=None, deleted=None, internalDateSource=None, processForCalendar=None, x__xgafv=None, media_body=None, media_mime_type=None)</a></code></p>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	99	<p class="firstline">Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. Does not send a message. Note: This function doesn't trigger forwarding rules or filters set up by the user.</p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	100	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	101	<code><a href="#insert">insert(userId, body=None, deleted=None, internalDateSource=None, x__xgafv=None, media_body=None, media_mime_type=None)</a></code></p>
				102	<p class="firstline">Directly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message.</p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	103	<p class="toc_element">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	104	<code><a href="#list">list(userId, includeSpamTrash=None, q=None, labelIds=None, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	105	<p class="firstline">Lists the messages in the user's mailbox.</p>
				106	<p class="toc_element">
				107	<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
				108	<p class="firstline">Retrieves the next page of results.</p>
				109	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	110	<code><a href="#modify">modify(userId, id, body=None, x__xgafv=None)</a></code></p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	111	<p class="firstline">Modifies the labels on the specified message.</p>
				112	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	113	<code><a href="#send">send(userId, body=None, x__xgafv=None, media_body=None, media_mime_type=None)</a></code></p>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	114	<p class="firstline">Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers.</p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	115	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	116	<code><a href="#trash">trash(userId, id, x__xgafv=None)</a></code></p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	117	<p class="firstline">Moves the specified message to the trash.</p>
				118	<p class="toc_element">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	119	<code><a href="#untrash">untrash(userId, id, x__xgafv=None)</a></code></p>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	120	<p class="firstline">Removes the specified message from the trash.</p>
				121	<h3>Method Details</h3>
				122	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	123	<code class="details" id="batchDelete">batchDelete(userId, body=None, x__xgafv=None)</code>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	124	<pre>Deletes many messages by message ID. Provides no guarantees that messages were not already deleted or even existed at all.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	125
				126	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	127	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	128	body: object, The request body.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	129	The object takes the form of:
				130
				131	{
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	132	"ids": [ # The IDs of the messages to delete.
				133	"A String",
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	134	],
				135	}
				136
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	137	x__xgafv: string, V1 error format.
				138	Allowed values
				139	1 - v1 error format
				140	2 - v2 error format
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	141	</pre>
				142	</div>
				143
				144	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	145	<code class="details" id="batchModify">batchModify(userId, body=None, x__xgafv=None)</code>
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	146	<pre>Modifies the labels on the specified messages.
				147
				148	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	149	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	150	body: object, The request body.
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	151	The object takes the form of:
				152
				153	{
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	154	"addLabelIds": [ # A list of label IDs to add to messages.
				155	"A String",
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	156	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	157	"removeLabelIds": [ # A list of label IDs to remove from messages.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	158	"A String",
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	159	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	160	"ids": [ # The IDs of the messages to modify. There is a limit of 1000 ids per request.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	161	"A String",
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	162	],
				163	}
				164
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	165	x__xgafv: string, V1 error format.
				166	Allowed values
				167	1 - v1 error format
				168	2 - v2 error format
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	169	</pre>
				170	</div>
				171
				172	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	173	<code class="details" id="close">close()</code>
				174	<pre>Close httplib2 connections.</pre>
				175	</div>
				176
				177	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	178	<code class="details" id="delete">delete(userId, id, x__xgafv=None)</code>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	179	<pre>Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer `messages.trash` instead.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	180
				181	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	182	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	183	id: string, The ID of the message to delete. (required)
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	184	x__xgafv: string, V1 error format.
				185	Allowed values
				186	1 - v1 error format
				187	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	188	</pre>
				189	</div>
				190
				191	<div class="method">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	192	<code class="details" id="get">get(userId, id, format=None, metadataHeaders=None, x__xgafv=None)</code>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	193	<pre>Gets the specified message.
				194
				195	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	196	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	197	id: string, The ID of the message to retrieve. (required)
				198	format: string, The format to return the message in.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	199	Allowed values
				200	minimal - Returns only email message ID and labels; does not return the email headers, body, or payload.
				201	full - Returns the full email message data with body content parsed in the `payload` field; the `raw` field is not used. Format cannot be used when accessing the api using the gmail.metadata scope.
				202	raw - Returns the full email message data with body content in the `raw` field as a base64url encoded string; the `payload` field is not used. Format cannot be used when accessing the api using the gmail.metadata scope.
				203	metadata - Returns only email message ID, labels, and email headers.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	204	metadataHeaders: string, When given and format is `METADATA`, only include headers specified. (repeated)
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	205	x__xgafv: string, V1 error format.
				206	Allowed values
				207	1 - v1 error format
				208	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	209
				210	Returns:
				211	An object of the form:
				212
				213	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	214	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	215	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	216	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	217	"A String",
				218	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	219	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	220	"mimeType": "A String", # The MIME type of the message part.
				221	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				222	# Object with schema name: MessagePart
				223	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	224	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				225	{
				226	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				227	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				228	},
				229	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	230	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				231	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	232	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				233	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	234	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	235	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	236	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	237	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	238	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	239	"internalDate": "A String", # 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.
				240	"raw": "A String", # 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.
				241	"historyId": "A String", # The ID of the last history record that modified this message.
				242	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	243	}</pre>
				244	</div>
				245
				246	<div class="method">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	247	<code class="details" id="import_">import_(userId, body=None, neverMarkSpam=None, deleted=None, internalDateSource=None, processForCalendar=None, x__xgafv=None, media_body=None, media_mime_type=None)</code>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	248	<pre>Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. Does not send a message. Note: This function doesn't trigger forwarding rules or filters set up by the user.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	249
				250	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	251	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	252	body: object, The request body.
				253	The object takes the form of:
				254
				255	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	256	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	257	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	258	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	259	"A String",
				260	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	261	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	262	"mimeType": "A String", # The MIME type of the message part.
				263	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				264	# Object with schema name: MessagePart
				265	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	266	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				267	{
				268	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				269	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				270	},
				271	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	272	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				273	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	274	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				275	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	276	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	277	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	278	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	279	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	280	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	281	"internalDate": "A String", # 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.
				282	"raw": "A String", # 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.
				283	"historyId": "A String", # The ID of the last history record that modified this message.
				284	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	285	}
				286
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	287	neverMarkSpam: boolean, Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	288	deleted: boolean, Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for G Suite accounts.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	289	internalDateSource: string, Source for Gmail's internal date of the message.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	290	Allowed values
				291	receivedTime - Internal message date set to current time when received by Gmail.
				292	dateHeader - Internal message time based on 'Date' header in email, when valid.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	293	processForCalendar: boolean, Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	294	x__xgafv: string, V1 error format.
Craig Citro	0e5b9bf	2014-10-15 10:26:14 -0700	[diff] [blame]	295	Allowed values
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	296	1 - v1 error format
				297	2 - v2 error format
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	298	media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	299	media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	300
				301	Returns:
				302	An object of the form:
				303
				304	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	305	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	306	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	307	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	308	"A String",
				309	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	310	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	311	"mimeType": "A String", # The MIME type of the message part.
				312	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				313	# Object with schema name: MessagePart
				314	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	315	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				316	{
				317	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				318	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				319	},
				320	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	321	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				322	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	323	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				324	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	325	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	326	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	327	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	328	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	329	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	330	"internalDate": "A String", # 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.
				331	"raw": "A String", # 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.
				332	"historyId": "A String", # The ID of the last history record that modified this message.
				333	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	334	}</pre>
				335	</div>
				336
				337	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	338	<code class="details" id="insert">insert(userId, body=None, deleted=None, internalDateSource=None, x__xgafv=None, media_body=None, media_mime_type=None)</code>
				339	<pre>Directly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	340
				341	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	342	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	343	body: object, The request body.
				344	The object takes the form of:
				345
				346	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	347	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	348	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	349	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	350	"A String",
				351	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	352	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	353	"mimeType": "A String", # The MIME type of the message part.
				354	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				355	# Object with schema name: MessagePart
				356	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	357	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				358	{
				359	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				360	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				361	},
				362	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	363	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				364	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	365	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				366	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	367	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	368	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	369	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	370	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	371	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	372	"internalDate": "A String", # 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.
				373	"raw": "A String", # 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.
				374	"historyId": "A String", # The ID of the last history record that modified this message.
				375	"threadId": "A String", # 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.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	376	}
				377
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	378	deleted: boolean, Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for G Suite accounts.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	379	internalDateSource: string, Source for Gmail's internal date of the message.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	380	Allowed values
				381	receivedTime - Internal message date set to current time when received by Gmail.
				382	dateHeader - Internal message time based on 'Date' header in email, when valid.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	383	x__xgafv: string, V1 error format.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	384	Allowed values
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	385	1 - v1 error format
				386	2 - v2 error format
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	387	media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
				388	media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
				389
				390	Returns:
				391	An object of the form:
				392
				393	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	394	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	395	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	396	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	397	"A String",
				398	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	399	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	400	"mimeType": "A String", # The MIME type of the message part.
				401	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				402	# Object with schema name: MessagePart
				403	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	404	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				405	{
				406	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				407	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				408	},
				409	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	410	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				411	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	412	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				413	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	414	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	415	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	416	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	417	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	418	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	419	"internalDate": "A String", # 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.
				420	"raw": "A String", # 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.
				421	"historyId": "A String", # The ID of the last history record that modified this message.
				422	"threadId": "A String", # 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.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	423	}</pre>
				424	</div>
				425
				426	<div class="method">
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	427	<code class="details" id="list">list(userId, includeSpamTrash=None, q=None, labelIds=None, maxResults=None, pageToken=None, x__xgafv=None)</code>
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	428	<pre>Lists the messages in the user's mailbox.
				429
				430	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	431	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
				432	includeSpamTrash: boolean, Include messages from `SPAM` and `TRASH` in the results.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	433	q: string, Only return messages matching the specified query. Supports the same query format as the Gmail search box. For example, `"from:someuser@example.com rfc822msgid: is:unread"`. Parameter cannot be used when accessing the api using the gmail.metadata scope.
				434	labelIds: string, Only return messages with labels that match all of the specified label IDs. (repeated)
				435	maxResults: integer, Maximum number of messages to return.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	436	pageToken: string, Page token to retrieve a specific page of results in the list.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	437	x__xgafv: string, V1 error format.
				438	Allowed values
				439	1 - v1 error format
				440	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	441
				442	Returns:
				443	An object of the form:
				444
				445	{
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	446	"messages": [ # List of messages. Note that each message resource contains only an `id` and a `threadId`. Additional message details can be fetched using the messages.get method.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	447	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	448	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	449	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	450	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	451	"A String",
				452	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	453	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	454	"mimeType": "A String", # The MIME type of the message part.
				455	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				456	# Object with schema name: MessagePart
				457	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	458	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				459	{
				460	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				461	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				462	},
				463	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	464	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				465	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	466	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				467	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	468	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	469	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	470	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	471	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	472	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	473	"internalDate": "A String", # 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.
				474	"raw": "A String", # 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.
				475	"historyId": "A String", # The ID of the last history record that modified this message.
				476	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	477	},
				478	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	479	"nextPageToken": "A String", # Token to retrieve the next page of results in the list.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	480	"resultSizeEstimate": 42, # Estimated total number of results.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	481	}</pre>
				482	</div>
				483
				484	<div class="method">
				485	<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
				486	<pre>Retrieves the next page of results.
				487
				488	Args:
				489	previous_request: The request for the previous page. (required)
				490	previous_response: The response from the request for the previous page. (required)
				491
				492	Returns:
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	493	A request object that you can call 'execute()' on to request the next
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	494	page. Returns None if there are no more items in the collection.
				495	</pre>
				496	</div>
				497
				498	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	499	<code class="details" id="modify">modify(userId, id, body=None, x__xgafv=None)</code>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	500	<pre>Modifies the labels on the specified message.
				501
				502	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	503	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	504	id: string, The ID of the message to modify. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	505	body: object, The request body.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	506	The object takes the form of:
				507
				508	{
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	509	"removeLabelIds": [ # A list IDs of labels to remove from this message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	510	"A String",
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	511	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	512	"addLabelIds": [ # A list of IDs of labels to add to this message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	513	"A String",
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	514	],
				515	}
				516
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	517	x__xgafv: string, V1 error format.
				518	Allowed values
				519	1 - v1 error format
				520	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	521
				522	Returns:
				523	An object of the form:
				524
				525	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	526	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	527	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	528	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	529	"A String",
				530	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	531	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	532	"mimeType": "A String", # The MIME type of the message part.
				533	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				534	# Object with schema name: MessagePart
				535	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	536	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				537	{
				538	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				539	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				540	},
				541	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	542	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				543	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	544	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				545	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	546	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	547	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	548	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	549	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	550	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	551	"internalDate": "A String", # 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.
				552	"raw": "A String", # 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.
				553	"historyId": "A String", # The ID of the last history record that modified this message.
				554	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	555	}</pre>
				556	</div>
				557
				558	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	559	<code class="details" id="send">send(userId, body=None, x__xgafv=None, media_body=None, media_mime_type=None)</code>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	560	<pre>Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	561
				562	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	563	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	564	body: object, The request body.
				565	The object takes the form of:
				566
				567	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	568	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	569	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	570	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	571	"A String",
				572	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	573	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	574	"mimeType": "A String", # The MIME type of the message part.
				575	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				576	# Object with schema name: MessagePart
				577	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	578	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				579	{
				580	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				581	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				582	},
				583	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	584	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				585	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	586	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				587	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	588	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	589	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	590	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	591	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	592	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	593	"internalDate": "A String", # 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.
				594	"raw": "A String", # 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.
				595	"historyId": "A String", # The ID of the last history record that modified this message.
				596	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	597	}
				598
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	599	x__xgafv: string, V1 error format.
				600	Allowed values
				601	1 - v1 error format
				602	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	603	media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	604	media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	605
				606	Returns:
				607	An object of the form:
				608
				609	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	610	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	611	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	612	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	613	"A String",
				614	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	615	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	616	"mimeType": "A String", # The MIME type of the message part.
				617	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				618	# Object with schema name: MessagePart
				619	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	620	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				621	{
				622	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				623	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				624	},
				625	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	626	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				627	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	628	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				629	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	630	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	631	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	632	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	633	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	634	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	635	"internalDate": "A String", # 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.
				636	"raw": "A String", # 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.
				637	"historyId": "A String", # The ID of the last history record that modified this message.
				638	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	639	}</pre>
				640	</div>
				641
				642	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	643	<code class="details" id="trash">trash(userId, id, x__xgafv=None)</code>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	644	<pre>Moves the specified message to the trash.
				645
				646	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	647	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	648	id: string, The ID of the message to Trash. (required)
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	649	x__xgafv: string, V1 error format.
				650	Allowed values
				651	1 - v1 error format
				652	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	653
				654	Returns:
				655	An object of the form:
				656
				657	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	658	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	659	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	660	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	661	"A String",
				662	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	663	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	664	"mimeType": "A String", # The MIME type of the message part.
				665	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				666	# Object with schema name: MessagePart
				667	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	668	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				669	{
				670	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				671	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				672	},
				673	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	674	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				675	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	676	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				677	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	678	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	679	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	680	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	681	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	682	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	683	"internalDate": "A String", # 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.
				684	"raw": "A String", # 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.
				685	"historyId": "A String", # The ID of the last history record that modified this message.
				686	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	687	}</pre>
				688	</div>
				689
				690	<div class="method">
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	691	<code class="details" id="untrash">untrash(userId, id, x__xgafv=None)</code>
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	692	<pre>Removes the specified message from the trash.
				693
				694	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	695	userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	696	id: string, The ID of the message to remove from Trash. (required)
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	697	x__xgafv: string, V1 error format.
				698	Allowed values
				699	1 - v1 error format
				700	2 - v2 error format
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	701
				702	Returns:
				703	An object of the form:
				704
				705	{ # An email message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	706	"sizeEstimate": 42, # Estimated size in bytes of the message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	707	"snippet": "A String", # A short part of the message text.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	708	"labelIds": [ # List of IDs of labels applied to this message.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	709	"A String",
				710	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	711	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	712	"mimeType": "A String", # The MIME type of the message part.
				713	"parts": [ # The child MIME message parts of this part. This only applies to container MIME message parts, for example `multipart/*`. For non- container MIME message part types, such as `text/plain`, this field is empty. For more information, see RFC 1521.
				714	# Object with schema name: MessagePart
				715	],
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	716	"headers": [ # List of headers on this message part. For the top-level message part, representing the entire message payload, it will contain the standard RFC 2822 email headers such as `To`, `From`, and `Subject`.
				717	{
				718	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				719	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				720	},
				721	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	722	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
				723	"body": { # The body of a single MIME message part. # The message part body for this part, which may be empty for container MIME message parts.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	724	"attachmentId": "A String", # When present, contains the ID of an external attachment that can be retrieved in a separate `messages.attachments.get` request. When not present, the entire content of the message part body is contained in the data field.
				725	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	726	"data": "A String", # The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	727	},
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	728	"partId": "A String", # The immutable ID of the message part.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	729	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	730	"id": "A String", # The immutable ID of the message.
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame^]	731	"internalDate": "A String", # 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.
				732	"raw": "A String", # 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.
				733	"historyId": "A String", # The ID of the last history record that modified this message.
				734	"threadId": "A String", # 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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	735	}</pre>
				736	</div>
				737
				738	</body></html>