Class GmailThread

Gmail 主題

使用者 Gmail 帳戶中的會話串。

方法

方法	傳回類型	簡短說明
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	如果這個會話串位於「優先收件匣」中，則傳回「是」；否則傳回「否」。
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 位址) 和這個會話串上最後一封郵件的所有收件者，並提供選用引數。

內容詳盡的說明文件

addLabel(label)

將此標籤新增至執行緒。

// Add label MyLabel to the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.addLabel(label);

參數

名稱	類型	說明
label	GmailLabel	要套用至這個會話串的標籤

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• removeLabel(label)

---

createDraftReply(body)

使用回覆地址，建立草稿訊息，回覆這個會話串中上一則訊息的寄件者。電子郵件大小 (包括標頭) 受到配額限制。

// Create a draft reply to the message author with an acknowledgement.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('Got your message');

參數

名稱	類型	說明
body	String	電子郵件內文

回攻員

GmailDraft：新建立的草稿訊息

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

使用回覆地址和選用引數，建立草稿訊息，回覆此執行緒中上次訊息的寄件者。

電子郵件可以同時包含純文字和 HTML 內文。電子郵件大小 (包括標頭) 受到配額限制。

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

參數

名稱	類型	說明
body	String	電子郵件內文
options	Object	指定進階參數的 JavaScript 物件，如下所列：

進階參數

名稱	類型	說明
attachments	BlobSource[]	要隨電子郵件傳送的檔案陣列
bcc	String	以半形逗號分隔的電子郵件地址清單 (用於副本收件人)
cc	String	以半形逗號分隔的電子郵件地址清單 (用於副本收件者)
from	String	電子郵件應傳送自的地址，必須是 GmailApp.getAliases() 傳回的其中一個值
htmlBody	String	如果已設定，則可轉換為可轉換 HTML 的裝置，而非使用必要的 body 引數；如果您為電子郵件內嵌圖片，則可在 HTML 主體中新增選用的 inlineImages 欄位
inlineImages	Object	JavaScript 物件，其中包含圖片鍵 (String) 與圖片資料 (BlobSource) 的對應關係；這項操作假設您會使用 htmlBody 參數，並以 <img src="cid:imageKey" /> 格式包含這些圖片的參照
name	String	電子郵件寄件者的名稱 (預設為使用者名稱)
replyTo	String	做為預設回覆地址的電子郵件地址 (預設值：使用者的電子郵件地址)
subject	String	電子郵件的新主旨行 (最多 250 個半形字元)

回攻員

GmailDraft：新建立的草稿訊息

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

使用回覆地址和此訊息的所有收件者，建立回覆此討論串中上一個訊息寄件者的草稿訊息。電子郵件大小 (包括標頭) 受到配額限制。

// Create a draft reply to all recipients (except those bcc'd) of the last email
// in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

參數

名稱	類型	說明
body	String	電子郵件內文

回攻員

GmailDraft：新建立的草稿訊息

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body, options)

使用回覆地址和所有收件者，搭配選用引數，建立回覆此執行緒中最後一則訊息寄件者的草稿訊息。

電子郵件可以同時包含純文字和 HTML 內文。電子郵件大小 (包括標頭) 受到配額限制。

// Create a draft reply, using an HTML text body, to all recipients (except
// those bcc'd) of the last email of in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

參數

名稱	類型	說明
body	String	電子郵件內文
options	Object	指定進階參數的 JavaScript 物件，如下所列：

進階參數

名稱	類型	說明
attachments	BlobSource[]	要隨電子郵件傳送的檔案陣列
bcc	String	以半形逗號分隔的電子郵件地址清單 (用於副本收件人)
cc	String	以半形逗號分隔的電子郵件地址清單 (用於副本收件者)
from	String	電子郵件應傳送自的地址，必須是 GmailApp.getAliases() 傳回的其中一個值
htmlBody	String	如果已設定，則可轉換為可轉換 HTML 的裝置，而非使用必要的 body 引數；如果您為電子郵件內嵌圖片，則可在 HTML 主體中新增選用的 inlineImages 欄位
inlineImages	Object	JavaScript 物件，其中包含圖片鍵 (String) 與圖片資料 (BlobSource) 的對應關係；這項操作假設您會使用 htmlBody 參數，並以 <img src="cid:imageKey" /> 格式包含這些圖片的參照
name	String	電子郵件寄件者的名稱 (預設為使用者名稱)
replyTo	String	做為預設回覆地址的電子郵件地址 (預設值：使用者的電子郵件地址)
subject	String	電子郵件的新主旨。長度上限為 250 個半形字元。

回攻員

GmailDraft：新建立的草稿訊息

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

getFirstMessageSubject()

取得討論串中第一則訊息的主旨。

// Log the subject of the first message in the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getFirstMessageSubject());

回攻員

String：討論串中第一則訊息的主旨

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• getLastMessageDate()

---

getId()

取得此執行緒的 ID。討論串的 ID 會因所含訊息而異；如要取得討論串中特定訊息的一致 ID，請改為呼叫 getMessages()[0].getId()。

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const thread = GmailApp.getThreadById(id);
Logger.log(
    thread.getFirstMessageSubject() === firstThread.getFirstMessageSubject(),
);  // True

回攻員

String：這個執行緒的 ID

---

getLabels()

傳回使用者在這個會話串中建立的標籤。

// Log the names of the labels attached to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

回攻員

GmailLabel[]：這個執行緒的標籤陣列

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

getLastMessageDate()

取得此執行緒最近一則訊息的日期。

// Log the date of the most recent message on the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

回攻員

Date：會話串中最新訊息的日期

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• getFirstMessageSubject()

---

getMessageCount()

傳回會話串中的訊息數量。

// Log the number of messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getMessageCount());

回攻員

Integer：會話串中的訊息數量

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• getMessages()

---

getMessages()

取得這個會話串中的訊息。

// Log the subjects of the messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
for (let i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

回攻員

GmailMessage[]：這個會話串中的 Gmail 郵件陣列

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• getMessageCount()

---

getPermalink()

取得這個會話串的永久連結。

請注意，這項功能僅適用於傳統版 Gmail 介面，不適用於 Inbox。

// Logs the permalink for the first thread in the inbox
const thread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(thread.getPermalink());

回攻員

String：這個討論串的永久連結

---

hasStarredMessages()

傳回會話串是否含有任何已加星號的訊息。

// Log if this thread has starred messages
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`has starred : ${firstThread.hasStarredMessages()}`);

回攻員

Boolean：如果討論串含有任何已加星號的訊息，則傳回 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isImportant()

傳回會話群組是否已標示為重要。

// Log if this thread is marked as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

回攻員

Boolean - 是否將會話串標示為重要。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isInChats()

傳回會話串是否標示為聊天。

// Log if this thread is a chat
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in chats? : ${firstThread.isInChats()}`);

回攻員

Boolean：如果會話標示為聊天，則為 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isInInbox()

傳回討論串是否位於收件匣中。

// Log if this thread is in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

回攻員

Boolean：如果會話串位於收件匣中，則為 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isInPriorityInbox()

如果這個會話串位於「優先收件匣」中，則傳回「是」；否則傳回「否」。

// Log if this thread is in the priority inbox
const firstThread = GmailApp.getPriorityInboxThreads(0, 1)[0];
Logger.log(`is in priority inbox? ${firstThread.isInPriorityInbox()}`);

回攻員

Boolean：如果會話位於「優先收件匣」，則為 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isInSpam()

傳回討論串是否已標示為垃圾內容。

// Log if this thread is in the spam folder
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Spam? ${firstThread.isInSpam()}`);

回攻員

Boolean：是否已將這個會話串標示為垃圾內容。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isInTrash()

傳回討論串是否位於垃圾桶中。

// Log if this thread is in the trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

回攻員

Boolean：如果執行緒位於垃圾桶中，則為 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

isUnread()

傳回會話串是否有未讀訊息。

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

回攻員

Boolean：如果有未讀訊息，則為 true

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

markImportant()

將這個會話串標示為重要。

// Mark first inbox thread as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markImportant();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• markUnimportant()

---

markRead()

將這個討論串標示為已讀。

// Mark first inbox thread as read
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markRead();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• markUnread()

---

markUnimportant()

將此執行緒標示為不重要。

// Mark first inbox thread as unimportant
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnimportant();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• markImportant()

---

markUnread()

將這個會話串標示為未讀。

// Mark first inbox thread as unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnread();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• markRead()

---

moveToArchive()

將這個執行緒移至封存區。

// Archive first inbox thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToArchive();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

moveToInbox()

將這個會話串移至收件匣。

// Move first non-inbox thread to inbox
const firstThread = GmailApp.search('-in:inbox')[0];
firstThread.moveToInbox();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

moveToSpam()

將這個會話移至垃圾郵件。

// Move first inbox thread to spam
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToSpam();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

moveToTrash()

將這個會話串移至垃圾桶。

// Move first inbox thread to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToTrash();

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

refresh()

重新載入此執行緒和 Gmail 的相關狀態 (如果標籤、已讀狀態等有所變更，這項操作就很實用)。

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// ...Do something that may take a while here....
firstThread.refresh();  // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

---

removeLabel(label)

從會話串中移除這個標籤。

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

參數

名稱	類型	說明
label	GmailLabel	要從這個會話串移除的標籤

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• addLabel(label)

---

reply(body)

使用 replyTo 地址回覆會話串中最後一則訊息的寄件者。

請注意，電子郵件 (包括所有標頭) 的總大小不得超過 20 KB。

// Respond to author of last email in thread with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('Got your message');

參數

名稱	類型	說明
body	String	電子郵件內文

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

使用 replyTo 位址回覆會話串中最後一則訊息的寄件者，並加上選用引數。電子郵件可以同時包含純文字和 HTML 內文。請注意，電子郵件的總大小 (包括所有標頭，但不含附件) 不得超過 20 KB。

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

參數

名稱	類型	說明
body	String	電子郵件內文
options	Object	指定進階參數的 JavaScript 物件，如下所列：

進階參數

名稱	類型	說明
cc	String	以半形逗號分隔的副本收件者電子郵件地址清單
bcc	String	以半形逗號分隔的副本電子郵件地址清單
htmlBody	String	如果已設定，則可轉換為可轉換 HTML 的裝置，而非使用必要的 body 引數；如果您為電子郵件內嵌圖片，則可在 HTML 主體中新增選用的 inlineImages 欄位
name	String	電子郵件寄件者的名稱 (預設為使用者名稱)
from	String	電子郵件應傳送自的地址，必須是 GmailApp.getAliases() 傳回的其中一個值
replyTo	String	做為預設回覆地址的電子郵件地址 (預設值：使用者的電子郵件地址)
noReply	Boolean	true 如果電子郵件應從一般不回覆電子郵件地址傳送，以免收件者回覆電子郵件；這個選項僅適用於 Google Workspace 帳戶，不適用於 Gmail 使用者
attachments	BlobSource[]	要隨電子郵件傳送的檔案陣列
inlineImages	Object	JavaScript 物件，其中包含圖片鍵 (String) 與圖片資料 (BlobSource) 的對應關係；這項操作假設您會使用 htmlBody 參數，並以 <img src="cid:imageKey" /> 格式包含這些圖片的參照

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

回覆寄件者 (使用 replyTo 地址) 和這個會話串上最後一封郵件的所有收件者。

請注意，電子郵件 (包括所有標頭) 的總大小不得超過 20 KB。

// Respond to all with acknowledgment to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('Got your message');

參數

名稱	類型	說明
body	String	電子郵件內文

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body, options)
• reply(body)
• replyAll(body, options)

---

replyAll(body, options)

回覆寄件者 (使用 replyTo 位址) 和這個會話串上最後一封郵件的所有收件者，並附上選用引數。電子郵件可以包含純文字和 HTML 內文。請注意，電子郵件的總大小 (包括所有標頭，但不含附件) 不得超過 20 KB。

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

參數

名稱	類型	說明
body	String	電子郵件內文
options	Object	指定進階參數的 JavaScript 物件，如下所列：

進階參數

名稱	類型	說明
cc	String	以半形逗號分隔的副本收件者電子郵件地址清單
bcc	String	以半形逗號分隔的副本電子郵件地址清單
htmlBody	String	如果已設定，則可轉換為可轉換 HTML 的裝置，而非使用必要的 body 引數；如果您為電子郵件內嵌圖片，則可在 HTML 主體中新增選用的 inlineImages 欄位
name	String	電子郵件寄件者的名稱 (預設為使用者名稱)
from	String	電子郵件應傳送自的地址，必須是 GmailApp.getAliases() 傳回的其中一個值
replyTo	String	做為預設回覆地址的電子郵件地址 (預設值：使用者的電子郵件地址)
noReply	Boolean	true 電子郵件是否應從一般不回覆電子郵件地址傳送，以免收件者回覆電子郵件；此選項僅適用於 G Suite 帳戶，不適用於 Gmail 使用者
attachments	BlobSource[]	要隨電子郵件傳送的檔案陣列
inlineImages	Object	JavaScript 物件，其中包含圖片鍵 (String) 與圖片資料 (BlobSource) 的對應關係；這項操作假設您會使用 htmlBody 參數，並以 <img src="cid:imageKey" /> 格式包含這些圖片的參照

回攻員

GmailThread：這個執行緒可用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

• https://mail.google.com/

另請參閱

• reply(body)
• replyAll(body)
• replyAll(body, options)