本頁面由 Cloud Translation API 翻譯而成。

Gmail Service

這項服務可讓您傳送電子郵件、撰寫草稿、管理標籤、標示郵件和會話串，以及執行其他各種 Gmail 帳戶管理工作。另請參閱郵件服務，這項簡易的服務僅允許傳送電子郵件。

類別

名稱	簡短說明
`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`	取得這個 blob 資料，並以 UTF-8 編碼做為字串。
`getDataAsString(charset)`	`String`	以指定的編碼方式取得這個 blob 的資料。
`getHash()`	`String`	取得這個附件的 SHA1 內容雜湊。
`getName()`	`String`	取得這個 blob 的名稱。
`getSize()`	`Integer`	取得這個附件的大小。
`isGoogleType()`	`Boolean`	傳回這個 blob 是否為 Google Workspace 檔案 (試算表、文件等)。
`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`	刪除這個標籤。
`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`	取得這封郵件的收件者副本 (密件副本)。#39;d
`getBody()`	`String`	取得這個訊息內文的 HTML 內容。
`getCc()`	`String`	取得該郵件的半形逗號收件者副本 (#39;d)。
`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`	使用回覆地址回覆這個討論串中最後一則訊息的寄件者。
`reply(body, options)`	`GmailThread`	使用回覆引數 (包括選用引數) 回覆這個執行緒中最後一則訊息的寄件者。
`replyAll(body)`	`GmailThread`	回覆這個寄件者 (使用回覆至地址) 以及這個會話串中最後一則訊息的所有收件者。
`replyAll(body, options)`	`GmailThread`	使用選用引數回覆寄件者 (使用 `replyTo` 位址)，以及這個會話串中最後一則訊息的所有收件者。