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

blob: 17e1b71562ef03979bdc6f68af4a760aad90cf51 [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">
Yoshi Automation Bot	c2228be	2020-11-24 15:48:03 -0800	[diff] [blame]	95	<code><a href="#get">get(userId, id, metadataHeaders=None, format=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">
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	98	<code><a href="#import_">import_(userId, body=None, neverMarkSpam=None, internalDateSource=None, deleted=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">
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	101	<code><a href="#insert">insert(userId, body=None, internalDateSource=None, deleted=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]	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">
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	104	<code><a href="#list">list(userId, q=None, pageToken=None, maxResults=None, labelIds=None, includeSpamTrash=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	{
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	154	"ids": [ # The IDs of the messages to modify. There is a limit of 1000 ids per request.
				155	"A String",
				156	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	157	"removeLabelIds": [ # A list of label IDs to remove from messages.
				158	"A String",
				159	],
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	160	"addLabelIds": [ # A list of label IDs to add to messages.
				161	"A String",
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	162	],
Jon Wayne Parrott	692617a	2017-01-06 09:58:29 -0800	[diff] [blame]	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">
Yoshi Automation Bot	c2228be	2020-11-24 15:48:03 -0800	[diff] [blame]	192	<code class="details" id="get">get(userId, id, metadataHeaders=None, format=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)
Yoshi Automation Bot	c2228be	2020-11-24 15:48:03 -0800	[diff] [blame]	198	metadataHeaders: string, When given and format is `METADATA`, only include headers specified. (repeated)
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	199	format: string, The format to return the message in.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	200	Allowed values
				201	minimal - Returns only email message ID and labels; does not return the email headers, body, or payload.
				202	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.
				203	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.
				204	metadata - Returns only email message ID, labels, and email headers.
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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	214	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	215	"labelIds": [ # List of IDs of labels applied to this message.
				216	"A String",
				217	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	218	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	219	"id": "A String", # The immutable ID of the message.
				220	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	221	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	222	"mimeType": "A String", # The MIME type of the message part.
				223	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	224	"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.
				225	# Object with schema name: MessagePart
				226	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	227	"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`.
				228	{
				229	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				230	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				231	},
				232	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	233	"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.
				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.
				235	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				236	"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.
				237	},
				238	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	239	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	240	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	241	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	242	"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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	243	}</pre>
				244	</div>
				245
				246	<div class="method">
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	247	<code class="details" id="import_">import_(userId, body=None, neverMarkSpam=None, internalDateSource=None, deleted=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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	256	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	257	"labelIds": [ # List of IDs of labels applied to this message.
				258	"A String",
				259	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	260	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	261	"id": "A String", # The immutable ID of the message.
				262	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	263	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	264	"mimeType": "A String", # The MIME type of the message part.
				265	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	266	"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.
				267	# Object with schema name: MessagePart
				268	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	269	"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`.
				270	{
				271	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				272	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				273	},
				274	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	275	"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.
				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.
				277	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				278	"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.
				279	},
				280	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	281	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	282	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	283	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	284	"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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	285	}
				286
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	287	neverMarkSpam: boolean, Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	288	internalDateSource: string, Source for Gmail's internal date of the message.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	289	Allowed values
				290	receivedTime - Internal message date set to current time when received by Gmail.
				291	dateHeader - Internal message time based on 'Date' header in email, when valid.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	292	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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	305	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	306	"labelIds": [ # List of IDs of labels applied to this message.
				307	"A String",
				308	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	309	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	310	"id": "A String", # The immutable ID of the message.
				311	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	312	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	313	"mimeType": "A String", # The MIME type of the message part.
				314	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	315	"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.
				316	# Object with schema name: MessagePart
				317	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	318	"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`.
				319	{
				320	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				321	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				322	},
				323	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	324	"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.
				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.
				326	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				327	"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.
				328	},
				329	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	330	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	331	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	332	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	333	"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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	334	}</pre>
				335	</div>
				336
				337	<div class="method">
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	338	<code class="details" id="insert">insert(userId, body=None, internalDateSource=None, deleted=None, x__xgafv=None, media_body=None, media_mime_type=None)</code>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	347	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	348	"labelIds": [ # List of IDs of labels applied to this message.
				349	"A String",
				350	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	351	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	352	"id": "A String", # The immutable ID of the message.
				353	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	354	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	355	"mimeType": "A String", # The MIME type of the message part.
				356	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	357	"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.
				358	# Object with schema name: MessagePart
				359	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	360	"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`.
				361	{
				362	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				363	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				364	},
				365	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	366	"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.
				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.
				368	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				369	"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.
				370	},
				371	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	372	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	373	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	374	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	375	"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.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	376	}
				377
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	378	internalDateSource: string, Source for Gmail's internal date of the message.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	379	Allowed values
				380	receivedTime - Internal message date set to current time when received by Gmail.
				381	dateHeader - Internal message time based on 'Date' header in email, when valid.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	382	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	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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	394	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	395	"labelIds": [ # List of IDs of labels applied to this message.
				396	"A String",
				397	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	398	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	399	"id": "A String", # The immutable ID of the message.
				400	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	401	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	402	"mimeType": "A String", # The MIME type of the message part.
				403	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	404	"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.
				405	# Object with schema name: MessagePart
				406	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	407	"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`.
				408	{
				409	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				410	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				411	},
				412	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	413	"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.
				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.
				415	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				416	"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.
				417	},
				418	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	419	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	420	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	421	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	422	"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.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	423	}</pre>
				424	</div>
				425
				426	<div class="method">
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	427	<code class="details" id="list">list(userId, q=None, pageToken=None, maxResults=None, labelIds=None, includeSpamTrash=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)
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	432	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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	433	pageToken: string, Page token to retrieve a specific page of results in the list.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	434	maxResults: integer, Maximum number of messages to return.
				435	labelIds: string, Only return messages with labels that match all of the specified label IDs. (repeated)
				436	includeSpamTrash: boolean, Include messages from `SPAM` and `TRASH` in the results.
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	{
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	446	"nextPageToken": "A String", # Token to retrieve the next page of results in the list.
				447	"resultSizeEstimate": 42, # Estimated total number of results.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	448	"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]	449	{ # An email message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	450	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	451	"labelIds": [ # List of IDs of labels applied to this message.
				452	"A String",
				453	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	454	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	455	"id": "A String", # The immutable ID of the message.
				456	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	457	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	458	"mimeType": "A String", # The MIME type of the message part.
				459	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	460	"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.
				461	# Object with schema name: MessagePart
				462	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	463	"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`.
				464	{
				465	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				466	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				467	},
				468	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	469	"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.
				470	"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.
				471	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				472	"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.
				473	},
				474	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	475	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	476	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	477	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	478	"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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	479	},
				480	],
				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	{
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	509	"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]	510	"A String",
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	511	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	512	"removeLabelIds": [ # A list IDs of labels to remove from 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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	526	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	527	"labelIds": [ # List of IDs of labels applied to this message.
				528	"A String",
				529	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	530	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	531	"id": "A String", # The immutable ID of the message.
				532	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	533	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	534	"mimeType": "A String", # The MIME type of the message part.
				535	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	536	"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.
				537	# Object with schema name: MessagePart
				538	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	539	"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`.
				540	{
				541	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				542	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				543	},
				544	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	545	"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.
				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.
				547	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				548	"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.
				549	},
				550	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	551	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	552	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	553	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	554	"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.
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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	568	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	569	"labelIds": [ # List of IDs of labels applied to this message.
				570	"A String",
				571	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	572	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	573	"id": "A String", # The immutable ID of the message.
				574	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	575	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	576	"mimeType": "A String", # The MIME type of the message part.
				577	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	578	"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.
				579	# Object with schema name: MessagePart
				580	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	581	"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`.
				582	{
				583	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				584	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				585	},
				586	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	587	"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.
				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.
				589	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				590	"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.
				591	},
				592	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	593	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	594	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	595	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	596	"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.
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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	610	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	611	"labelIds": [ # List of IDs of labels applied to this message.
				612	"A String",
				613	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	614	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	615	"id": "A String", # The immutable ID of the message.
				616	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	617	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	618	"mimeType": "A String", # The MIME type of the message part.
				619	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	620	"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.
				621	# Object with schema name: MessagePart
				622	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	623	"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`.
				624	{
				625	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				626	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				627	},
				628	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	629	"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.
				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.
				631	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				632	"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.
				633	},
				634	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	635	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	636	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	637	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	638	"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.
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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	658	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	659	"labelIds": [ # List of IDs of labels applied to this message.
				660	"A String",
				661	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	662	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	663	"id": "A String", # The immutable ID of the message.
				664	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	665	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	666	"mimeType": "A String", # The MIME type of the message part.
				667	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	668	"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.
				669	# Object with schema name: MessagePart
				670	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	671	"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`.
				672	{
				673	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				674	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				675	},
				676	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	677	"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.
				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.
				679	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				680	"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.
				681	},
				682	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	683	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	684	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	685	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	686	"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.
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.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	706	"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.
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	707	"labelIds": [ # List of IDs of labels applied to this message.
				708	"A String",
				709	],
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	710	"sizeEstimate": 42, # Estimated size in bytes of the message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	711	"id": "A String", # The immutable ID of the message.
				712	"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.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	713	"payload": { # A single MIME message part. # The parsed email structure in the message parts.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	714	"mimeType": "A String", # The MIME type of the message part.
				715	"partId": "A String", # The immutable ID of the message part.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	716	"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.
				717	# Object with schema name: MessagePart
				718	],
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	719	"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`.
				720	{
				721	"name": "A String", # The name of the header before the `:` separator. For example, `To`.
				722	"value": "A String", # The value of the header after the `:` separator. For example, `someuser@example.com`.
				723	},
				724	],
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	725	"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.
				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.
				727	"size": 42, # Number of bytes for the message part data (encoding notwithstanding).
				728	"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.
				729	},
				730	"filename": "A String", # The filename of the attachment. Only present if this message part represents an attachment.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	731	},
Yoshi Automation Bot	0d561ef	2020-11-25 07:50:41 -0800	[diff] [blame]	732	"snippet": "A String", # A short part of the message text.
Yoshi Automation Bot	b6971b0	2020-11-26 17:16:03 -0800	[diff] [blame]	733	"historyId": "A String", # The ID of the last history record that modified this message.
Yoshi Automation Bot	0bf565c	2020-12-09 08:56:03 -0800	[diff] [blame]	734	"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.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame]	735	}</pre>
				736	</div>
				737
				738	</body></html>