此页面由 Cloud Translation API 翻译。

Gmail Service

借助此服务，您可以发送电子邮件、撰写草稿、管理标签、标记邮件和会话，以及执行各种其他 Gmail 账号管理任务。另请参阅 Mail 服务，这是一项更简单的服务，仅允许发送电子邮件。

类

名称	简介
`GmailApp`	提供对 Gmail 线程、邮件和标签的访问权限。
`GmailAttachment`	来自 Gmail 的附件。
`GmailDraft`	用户在自己的 Gmail 账号中创建的草稿邮件。
`GmailLabel`	用户在自己的 Gmail 账号中创建的标签。
`GmailMessage`	用户 Gmail 账号中的邮件。
`GmailThread`	用户 Gmail 账号中的会话。

`GmailApp`

方法

方法	返回类型	简介
`createDraft(recipient, subject, body)`	`GmailDraft`	创建电子邮件草稿。
`createDraft(recipient, subject, body, options)`	`GmailDraft`	创建一封电子邮件草稿，其中包含可选实参。
`createLabel(name)`	`GmailLabel`	创建具有指定名称的新用户标签。
`deleteLabel(label)`	`GmailApp`	删除指定的标签。
`getAliases()`	`String[]`	获取在 Gmail 中设置为相应账号的别名的电子邮件地址列表。
`getDraft(draftId)`	`GmailDraft`	按 ID 检索电子邮件草稿。
`getDraftMessages()`	`GmailMessage[]`	检索所有草稿邮件。
`getDrafts()`	`GmailDraft[]`	获取所有 Gmail 邮件草稿。
`getInboxThreads()`	`GmailThread[]`	检索所有收件箱会话，无论其是否带有标签。
`getInboxThreads(start, max)`	`GmailThread[]`	检索一系列收件箱线程，而不考虑标签。
`getInboxUnreadCount()`	`Integer`	获取收件箱中未读消息串的数量。
`getMessageById(id)`	`GmailMessage`	根据 ID 获取消息。
`getMessagesForThread(thread)`	`GmailMessage[]`	检索指定会话串中的所有邮件。
`getMessagesForThreads(threads)`	`GmailMessage[][]`	检索指定会话串中的所有邮件。
`getPriorityInboxThreads()`	`GmailThread[]`	检索所有优先收件箱线程，无论其标签如何。
`getPriorityInboxThreads(start, max)`	`GmailThread[]`	检索一系列优先收件箱会话，而不考虑标签。
`getPriorityInboxUnreadCount()`	`Integer`	获取“优先收件箱”中未读对话的数量。
`getSpamThreads()`	`GmailThread[]`	检索所有垃圾内容会话，无论其标签如何。
`getSpamThreads(start, max)`	`GmailThread[]`	检索一系列垃圾邮件会话，而不考虑标签。
`getSpamUnreadCount()`	`Integer`	获取垃圾邮件未读消息串的数量。
`getStarredThreads()`	`GmailThread[]`	检索所有已加星标的对话串，无论其标签如何。
`getStarredThreads(start, max)`	`GmailThread[]`	检索一系列已加星标的对话串，无论其是否带有标签。
`getStarredUnreadCount()`	`Integer`	获取已加星标的未读对话数量。
`getThreadById(id)`	`GmailThread`	根据 ID 获取线程。
`getTrashThreads()`	`GmailThread[]`	检索所有回收站中的会话，无论其是否带有标签。
`getTrashThreads(start, max)`	`GmailThread[]`	检索回收站中的一系列线程，而不考虑标签。
`getUserLabelByName(name)`	`GmailLabel`	根据标签名称检索标签。
`getUserLabels()`	`GmailLabel[]`	检索用户创建的标签的列表。
`markMessageRead(message)`	`GmailApp`	将相应消息标记为已读，并强制刷新该消息。
`markMessageUnread(message)`	`GmailApp`	将相应消息标记为未读，并强制刷新该消息。
`markMessagesRead(messages)`	`GmailApp`	将这些消息标记为已读，并强制刷新消息。
`markMessagesUnread(messages)`	`GmailApp`	将这些消息标记为未读，并强制刷新消息。
`markThreadImportant(thread)`	`GmailApp`	将相应消息串标记为重要，并强制刷新该消息串。
`markThreadRead(thread)`	`GmailApp`	将相应消息串标记为已读，并强制刷新该消息串。
`markThreadUnimportant(thread)`	`GmailApp`	将相应消息串标记为不重要，并强制刷新该消息串。
`markThreadUnread(thread)`	`GmailApp`	将相应消息串标记为未读，并强制刷新该消息串。
`markThreadsImportant(threads)`	`GmailApp`	将这些线程标记为重要线程，并强制线程刷新。
`markThreadsRead(threads)`	`GmailApp`	将这些消息串标记为已读，并强制刷新消息串。
`markThreadsUnimportant(threads)`	`GmailApp`	将这些消息串标记为不重要，并强制刷新消息串。
`markThreadsUnread(threads)`	`GmailApp`	将这些消息串标记为未读，并强制刷新消息串。
`moveMessageToTrash(message)`	`GmailApp`	将邮件移至回收站，并强制刷新邮件。
`moveMessagesToTrash(messages)`	`GmailApp`	将指定的消息移至回收站，并强制刷新消息。
`moveThreadToArchive(thread)`	`GmailApp`	将相应线程移至归档，并强制刷新该线程。
`moveThreadToInbox(thread)`	`GmailApp`	将相应线程移至收件箱，并强制刷新该线程。
`moveThreadToSpam(thread)`	`GmailApp`	将相应线程移至“垃圾内容”文件夹，并强制刷新该线程。
`moveThreadToTrash(thread)`	`GmailApp`	将相应线程移至回收站，并强制刷新该线程。
`moveThreadsToArchive(threads)`	`GmailApp`	将这些线程移至归档文件夹，并强制刷新线程。
`moveThreadsToInbox(threads)`	`GmailApp`	将这些会话移至收件箱，并强制刷新会话。
`moveThreadsToSpam(threads)`	`GmailApp`	将这些对话移至“垃圾内容”文件夹，并强制刷新对话。
`moveThreadsToTrash(threads)`	`GmailApp`	将这些会话移至回收站，并强制会话刷新。
`refreshMessage(message)`	`GmailApp`	从 Gmail 重新加载消息和关联状态（如果标签、已读状态等发生更改，此方法非常有用）。
`refreshMessages(messages)`	`GmailApp`	从 Gmail 重新加载消息和关联状态（如果标签、已读状态等发生更改，此方法非常有用）。
`refreshThread(thread)`	`GmailApp`	从 Gmail 重新加载会话和关联状态（在标签、已读状态等发生更改时非常有用）。
`refreshThreads(threads)`	`GmailApp`	从 Gmail 重新加载会话和关联状态（如果标签、已读状态等发生变化，此方法非常有用）。
`search(query)`	`GmailThread[]`	使用指定查询搜索 Gmail。
`search(query, start, max)`	`GmailThread[]`	使用指定查询搜索 Gmail。
`sendEmail(recipient, subject, body)`	`GmailApp`	发送电子邮件。
`sendEmail(recipient, subject, body, options)`	`GmailApp`	发送带有可选实参的电子邮件。
`setCurrentMessageAccessToken(accessToken)`	`void`	设置当前消息访问令牌，使脚本能够访问当前的 `GmailMessage` 属性。
`starMessage(message)`	`GmailApp`	为相应消息加注星标，并强制刷新该消息。
`starMessages(messages)`	`GmailApp`	为这些消息添加星标，并强制刷新消息。
`unstarMessage(message)`	`GmailApp`	从此消息中移除星标，并强制刷新消息。
`unstarMessages(messages)`	`GmailApp`	移除这些消息的星标，并强制刷新消息。

`GmailAttachment`

方法

方法	返回类型	简介
`copyBlob()`	`Blob`	返回相应 blob 的副本。
`getAs(contentType)`	`Blob`	以转换为指定内容类型的 blob 形式返回此对象内的数据。
`getBytes()`	`Byte[]`	获取存储在此 blob 中的数据。
`getContentType()`	`String`	获取相应 blob 中字节的内容类型。
`getDataAsString()`	`String`	以 UTF-8 编码获取相应 blob 的数据（以字符串形式）。
`getDataAsString(charset)`	`String`	以指定编码获取相应 Blob 的数据（以字符串形式）。
`getHash()`	`String`	获取相应附件的 SHA1 内容哈希。
`getName()`	`String`	获取相应 blob 的名称。
`getSize()`	`Integer`	获取此附件的大小。
`isGoogleType()`	`Boolean`	返回相应 blob 是否为 Google Workspace 文件（Google 表格、Google 文档等）。
`setBytes(data)`	`Blob`	设置存储在此 blob 中的数据。
`setContentType(contentType)`	`Blob`	设置相应 blob 中字节的内容类型。
`setContentTypeFromExtension()`	`Blob`	根据文件扩展名设置相应 blob 中字节的内容类型。
`setDataFromString(string)`	`Blob`	根据采用 UTF-8 编码的字符串设置相应 blob 的数据。
`setDataFromString(string, charset)`	`Blob`	根据具有指定编码的字符串设置相应 blob 的数据。
`setName(name)`	`Blob`	设置相应 blob 的名称。

`GmailDraft`

方法

方法	返回类型	简介
`deleteDraft()`	`void`	删除此草稿消息。
`getId()`	`String`	获取相应草稿消息的 ID。
`getMessage()`	`GmailMessage`	返回表示相应草稿的 GmailMessage。
`getMessageId()`	`String`	返回表示相应草稿的 `GmailMessage` 的 ID。
`send()`	`GmailMessage`	发送此电子邮件草稿。
`update(recipient, subject, body)`	`GmailDraft`	替换相应草稿邮件的内容。
`update(recipient, subject, body, options)`	`GmailDraft`	使用可选实参替换相应草稿邮件的内容。

`GmailLabel`

方法

方法	返回类型	简介
`addToThread(thread)`	`GmailLabel`	将此标签添加到指定线程，并强制线程刷新 (`GmailThread.refresh()`)。
`addToThreads(threads)`	`GmailLabel`	将此标签添加到指定线程，并强制线程刷新。
`deleteLabel()`	`void`	删除此标签。
`getId()`	`String`	获取相应标签的 ID。
`getName()`	`String`	获取相应标签的名称。
`getThreads()`	`GmailThread[]`	获取标记有相应标签的线程。
`getThreads(start, max)`	`GmailThread[]`	获取标记有相应标签的一系列线程。
`getUnreadCount()`	`Integer`	获取带有相应标签的未读对话串的数量。
`removeFromThread(thread)`	`GmailLabel`	从指定线程中移除相应标签，并强制线程刷新。
`removeFromThreads(threads)`	`GmailLabel`	从指定线程中移除相应标签，并强制线程刷新。

`GmailMessage`

方法

方法	返回类型	简介
`createDraftReply(body)`	`GmailDraft`	使用“回复到”地址创建回复相应邮件发件人的邮件草稿。
`createDraftReply(body, options)`	`GmailDraft`	使用“回复”地址创建一封回复此邮件发件人的草稿邮件，并带有可选实参。
`createDraftReplyAll(body)`	`GmailDraft`	创建一封草稿邮件，使用“回复”地址和相应邮件的所有收件人回复发件人。
`createDraftReplyAll(body, options)`	`GmailDraft`	使用“回复”地址和所有收件人创建一封草稿邮件，以回复相应邮件的发送者，并可使用可选实参。
`forward(recipient)`	`GmailMessage`	将此邮件转发给新的收件人。
`forward(recipient, options)`	`GmailMessage`	将此消息转发给新收件人，并带有可选实参。
`getAttachments()`	`GmailAttachment[]`	获取相应消息的所有附件。
`getAttachments(options)`	`GmailAttachment[]`	获取相应消息的所有附件。
`getBcc()`	`String`	获取此消息中以英文逗号分隔的密送收件人。
`getBody()`	`String`	获取相应邮件正文的 HTML 内容。
`getCc()`	`String`	获取此消息中以英文逗号分隔的抄送收件人。
`getDate()`	`Date`	获取相应消息的日期和时间。
`getFrom()`	`String`	获取该邮件的发件人。
`getHeader(name)`	`String`	根据标头名称获取 RFC 2822 标头的值。
`getId()`	`String`	获取相应消息的 ID。
`getPlainBody()`	`String`	获取相应邮件正文的内容（不含 HTML 格式）。
`getRawContent()`	`String`	获取相应消息的原始内容。
`getReplyTo()`	`String`	获取相应邮件的回复地址（通常为发件人）。
`getSubject()`	`String`	获取该邮件的主题。
`getThread()`	`GmailThread`	获取包含相应消息的线程。
`getTo()`	`String`	获取相应消息的收件人（以英文逗号分隔）。
`isDraft()`	`Boolean`	获取相应消息是否为草稿。
`isInChats()`	`Boolean`	获取相应消息是否为聊天消息。
`isInInbox()`	`Boolean`	获取相应消息是否位于收件箱中。
`isInPriorityInbox()`	`Boolean`	如果相应邮件位于“优先收件箱”中，则返回 `true`；否则返回 `false`。
`isInTrash()`	`Boolean`	获取相应消息是否位于“已删除邮件”文件夹中。
`isStarred()`	`Boolean`	获取相应消息是否已加星标。
`isUnread()`	`Boolean`	获取相应消息是否未读。
`markRead()`	`GmailMessage`	将邮件标记为已读。
`markUnread()`	`GmailMessage`	将邮件标记为未读。
`moveToTrash()`	`GmailMessage`	将邮件移至回收站。
`refresh()`	`GmailMessage`	从 Gmail 重新加载此消息和关联状态（如果标签、已读状态等发生变化，此操作非常有用）。
`reply(body)`	`GmailMessage`	使用回复地址回复此邮件的发件人。
`reply(body, options)`	`GmailMessage`	使用回复地址回复此消息的发件人，并带有可选实参。
`replyAll(body)`	`GmailMessage`	回复发件人（使用回复地址）以及此邮件的所有收件人。
`replyAll(body, options)`	`GmailMessage`	使用回复地址和所有收件人回复此邮件的发送者，并提供可选实参。
`star()`	`GmailMessage`	为消息加注星标。
`unstar()`	`GmailMessage`	为消息移除星标。

`GmailThread`

方法

方法	返回类型	简介
`addLabel(label)`	`GmailThread`	将此标签添加到线程。
`createDraftReply(body)`	`GmailDraft`	创建一封草稿邮件，使用“回复到”地址回复相应线程中上一封邮件的发送者。
`createDraftReply(body, options)`	`GmailDraft`	使用回复地址创建一封草稿消息，以回复相应线程中最后一条消息的发送者，并可使用可选实参。
`createDraftReplyAll(body)`	`GmailDraft`	创建一封草稿邮件，回复相应线程中上一封邮件的发件人，并使用该邮件的“回复到”地址和所有收件人。
`createDraftReplyAll(body, options)`	`GmailDraft`	使用回复地址和所有收件人创建一封草稿邮件，回复相应线程中最后一条消息的发送者，并可使用可选实参。
`getFirstMessageSubject()`	`String`	获取消息串中第一条消息的主题。
`getId()`	`String`	获取相应线程的 ID。
`getLabels()`	`GmailLabel[]`	返回相应线程上用户创建的标签。
`getLastMessageDate()`	`Date`	获取相应线程中最新消息的日期。
`getMessageCount()`	`Integer`	返回相应线程中的消息数量。
`getMessages()`	`GmailMessage[]`	获取相应消息串中的消息。
`getPermalink()`	`String`	获取相应消息串的永久链接。
`hasStarredMessages()`	`Boolean`	返回相应线程是否包含任何已加星标的消息。
`isImportant()`	`Boolean`	返回相应线程是否被标记为重要。
`isInChats()`	`Boolean`	返回相应线程是否标记为对话。
`isInInbox()`	`Boolean`	返回相应会话是否位于收件箱中。
`isInPriorityInbox()`	`Boolean`	如果相应邮件会话位于优先收件箱中，则返回 true；否则返回 false。
`isInSpam()`	`Boolean`	返回相应线程是否被标记为垃圾内容。
`isInTrash()`	`Boolean`	返回相应线程是否位于回收站中。
`isUnread()`	`Boolean`	返回相应线程是否有未读消息。
`markImportant()`	`GmailThread`	将相应消息串标记为重要。
`markRead()`	`GmailThread`	将此消息串标记为已读。
`markUnimportant()`	`GmailThread`	将相应消息串标记为不重要。
`markUnread()`	`GmailThread`	将相应消息串标记为未读。
`moveToArchive()`	`GmailThread`	将相应对话移至归档。
`moveToInbox()`	`GmailThread`	将相应对话移至收件箱。
`moveToSpam()`	`GmailThread`	将相应对话移至“垃圾信息”文件夹。
`moveToTrash()`	`GmailThread`	将相应对话移至回收站。
`refresh()`	`GmailThread`	从 Gmail 重新加载此会话和关联状态（如果标签、已读状态等发生变化，此功能非常有用）。
`removeLabel(label)`	`GmailThread`	从相应消息串中移除此标签。
`reply(body)`	`GmailThread`	使用 replyTo 地址回复相应线程中最后一封邮件的发件人。
`reply(body, options)`	`GmailThread`	使用 replyTo 地址回复相应线程中最后一条消息的发件人，并可选择性地提供实参。
`replyAll(body)`	`GmailThread`	回复发件人（使用 replyTo 地址）以及此会话串中上一封邮件的所有收件人。
`replyAll(body, options)`	`GmailThread`	使用 `replyTo` 地址回复发件人以及此线程中上一条消息的所有收件人，并可选择性地提供实参。

Gmail Service 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

类

GmailApp

方法

GmailAttachment

方法

GmailDraft

方法

GmailLabel

方法

GmailMessage

方法

GmailThread

方法

Gmail Service

`GmailApp`

`GmailAttachment`

`GmailDraft`

`GmailLabel`

`GmailMessage`

`GmailThread`