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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - 新しく作成された下書きメッセージ

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - 新しく作成された下書きメッセージ

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - 新しく作成された下書きメッセージ

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - 新しく作成された下書きメッセージ

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - スレッドの最初のメッセージの件名。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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[] - このスレッドのラベルの配列

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - スレッド内の最新のメッセージの日付

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - スレッド内のメッセージ数

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 のメールの配列

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getMessageCount()

このスレッドのパーマリンクを取得します。

なお、これは以前の Gmail インターフェースでのみ動作し、Inbox では機能しません。

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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - スレッドが重要としてマークされているかどうかを示します。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - このスレッドを迷惑メールとしてマークするかどうかを指定します。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このスレッドを重要としてマークします。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• markUnimportant()

このスレッドを既読にします。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• markUnread()

このスレッドを重要でないとマークします。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• markImportant()

このスレッドを未読にします。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• markRead()

このスレッドをアーカイブに移動します。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このスレッドを受信トレイに移動します。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このスレッドを迷惑メールに移動します。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このスレッドをゴミ箱に移動します。

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

戻る

GmailThread - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• addLabel(label)

返信先アドレスを使用して、このスレッドの最後のメッセージの送信者に返信します。

メールの合計サイズ（すべてのヘッダーを含む）が 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

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

返信先アドレス（この引数は省略可）を使用して、このスレッドの最後のメッセージの送信者に返信します。メールには、書式なしテキストと 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

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

送信者（replyTo アドレスを使用）と、このスレッドの最後のメッセージの受信者全員に返信します。

メールの合計サイズ（すべてのヘッダーを含む）が 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する 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 - このスレッド。チェーンに便利です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

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