Class GmailThread

將這個標籤新增至執行緒。

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

參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• removeLabel(label)

建立草稿訊息，以回覆地址回覆這個會話串中最後一則訊息的寄件者。電子郵件大小 (包含標頭) 有配額限制。

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

參數

回攻員

GmailDraft：新建立的訊息草稿

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

建立草稿訊息，並使用回覆地址 (選用引數) 回覆這個執行緒中最後一封郵件的寄件者。

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

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

參數

進階參數

回攻員

GmailDraft：新建立的訊息草稿

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

建立草稿訊息，以回覆這個討論串中最後一則訊息的寄件者，以及這個訊息的所有收件者。電子郵件大小 (包括標頭) 有配額限制。

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

參數

回攻員

GmailDraft：新建立的訊息草稿

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• replyAll(body)
• createDraftReply(body)
• createDraftReply(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.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

參數

進階參數

回攻員

GmailDraft：新建立的訊息草稿

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

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

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

回攻員

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

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• getLastMessageDate()

取得此執行緒的 ID。執行緒的 ID 取決於其包含的訊息；如果在執行緒中的特定訊息有一致的 ID，請改為呼叫 getMessages()[0].getId()。

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

回攻員

String：這個執行緒的 ID

傳回使用者在這個執行緒上建立的標籤。

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

回攻員

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

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

取得這個討論串最新訊息的日期。

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

回攻員

Date：討論串中最新郵件的日期

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• getFirstMessageSubject()

傳回執行緒中的郵件數量。

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

回攻員

Integer：討論串中的郵件數量

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• getMessages()

取得這個執行緒中的訊息。

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

回攻員

GmailMessage[]：這個討論串中 Gmail 郵件的陣列

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• getMessageCount()

取得這個執行緒的永久連結。

請注意，這種做法僅適用於傳統版 Gmail 介面，不適用於收件匣。

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

回攻員

String：這個執行緒的永久連結

傳回討論串中是否有已加星號的訊息。

// Log if this thread has starred messages
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('has starred : ' + firstThread.hasStarredMessages());

回攻員

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

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

傳回執行緒是否標示為重要。

// Log if this thread is marked as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

回攻員

Boolean：執行緒是否標示為重要。

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

傳回討論串是否標示為即時通訊。

// Log if this thread is a chat
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in chats? : ' + firstThread.isInChats());

回攻員

Boolean — 如果討論串標示為即時通訊則為 true

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

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

// Log if this thread is in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

回攻員

Boolean：如果討論串位於收件匣，則為 true

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

如果這個討論串位於優先收件匣，則傳回 true，否則傳回 false。

// Log if this thread is in the priority inbox
var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0];
Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());

回攻員

Boolean：如果討論串位於優先收件匣，則為 true

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

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

// Log if this thread is in the spam folder
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Spam? ' + firstThread.isInSpam());

回攻員

Boolean：這個討論串是否標示為垃圾內容。

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

傳回執行緒是否在垃圾桶中。

// Log if this thread is in the trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

回攻員

Boolean：如果討論串在垃圾桶中則為 true

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

傳回討論串是否有未讀訊息。

// Log if this thread is unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

回攻員

Boolean — 如有未讀訊息，則為 true

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

將這個討論串標示為重要。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• markUnimportant()

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

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• markUnread()

將這個討論串標示為不重要。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• markImportant()

將這個討論串標示為未讀取。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• markRead()

將這個討論串移至封存。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

將這個討論串移至收件匣。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

將這個討論串移至垃圾內容。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

將這個討論串移至垃圾桶。

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

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

從 Gmail 重新載入這個執行緒和相關狀態 (當標籤、讀取狀態等已變更時相當實用)。

var 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/

從執行緒中移除這個標籤。

var myLabel = GmailApp.getUserLabelByName('<your label>');
var threads = myLabel.getThreads();
for (var x in threads) {
  var thread = threads[x];
  thread.removeLabel(myLabel);
}

參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

• addLabel(label)

使用 ReplyTo 地址回覆這個會話串中最後一封郵件的寄件者。

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

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

參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

使用 ReplyTo 地址回覆這個執行緒上最後一則訊息的寄件者，並可選擇是否加入引數。電子郵件可以含有純文字和 HTML 內文。請注意，電子郵件的總大小 (包括所有標頭，但不含附件) 不得超過 20 KB。

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

參數

進階參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

回覆寄件者 (使用回覆地址)，以及這個會話串中最後一則訊息的所有收件者。

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

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

參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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

使用 replyTo 地址回覆寄件者，以及這個執行緒中最後一則訊息的所有收件者，並提供選用引數。電子郵件可以包含純文字和 HTML 內文。請注意，電子郵件的總大小 (包括所有標頭，但不含附件) 不得超過 20 KB。

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

參數

進階參數

回攻員

GmailThread：這個執行緒，適合用於鏈結

授權

使用這個方法的指令碼必須取得下列一或多個範圍 (或相關的 REST API) 的適當範圍授權：

• https://mail.google.com/

另請參閱

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