Class GmailThread

GmailThread

رشته ای در حساب کاربری جیمیل یک کاربر.

روش ها

روش نوع برگشت شرح مختصر
addLabel(label) GmailThread این برچسب را به موضوع اضافه می کند.
createDraftReply(body) GmailDraft یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته با استفاده از آدرس پاسخ به پاسخ می‌دهد.
createDraftReply(body, options) GmailDraft یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته با استفاده از آدرس پاسخ به، با آرگومان‌های اختیاری پاسخ می‌دهد.
createDraftReplyAll(body) GmailDraft با استفاده از آدرس پاسخ به و همه گیرندگان این پیام، یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته پاسخ می‌دهد.
createDraftReplyAll(body, options) GmailDraft یک پیام پیش نویس برای پاسخ به فرستنده آخرین پیام در این رشته، با استفاده از آدرس پاسخ به و همه گیرندگان، با آرگومان های اختیاری ایجاد می کند.
getFirstMessageSubject() String موضوع اولین پیام در تاپیک را دریافت می کند.
getId() String شناسه این تاپیک را می گیرد.
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 )، و همه گیرندگان آخرین پیام در این رشته، با آرگومان های اختیاری پاسخ دهید.

مستندات دقیق

addLabel(label)

این برچسب را به موضوع اضافه می کند.

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

پارامترها

نام تایپ کنید توضیحات
label GmailLabel برچسبی که باید روی این موضوع اعمال شود

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


createDraftReply(body)

یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته با استفاده از آدرس پاسخ به پاسخ می‌دهد. اندازه ایمیل (شامل سرصفحه ها) محدود است.

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

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل

بازگشت

GmailDraft - پیام پیش نویس تازه ایجاد شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


createDraftReply(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"
});

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل
options Object یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

پارامترهای پیشرفته

نام تایپ کنید توضیحات
attachments BlobSource[] مجموعه ای از فایل ها برای ارسال با ایمیل
bcc String فهرستی از آدرس‌های ایمیل به BCC که با کاما از هم جدا شده‌اند
cc String فهرستی از آدرس‌های ایمیل به CC جدا شده با کاما
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط GmailApp.getAliases() باشد.
htmlBody String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید
inlineImages Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( BlobSource ). فرض بر این است که پارامتر htmlBody استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
replyTo String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
subject String یک موضوع جدید برای ایمیل (حداکثر 250 کاراکتر)

بازگشت

GmailDraft - پیام پیش نویس تازه ایجاد شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


createDraftReplyAll(body)

با استفاده از آدرس پاسخ به و همه گیرندگان این پیام، یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته پاسخ می‌دهد. اندازه ایمیل (شامل سرصفحه ها) محدود است.

// 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");

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل

بازگشت

GmailDraft - پیام پیش نویس تازه ایجاد شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


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"
});

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل
options Object یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

پارامترهای پیشرفته

نام تایپ کنید توضیحات
attachments BlobSource[] مجموعه ای از فایل ها برای ارسال با ایمیل
bcc String فهرستی از آدرس‌های ایمیل به BCC که با کاما از هم جدا شده‌اند
cc String فهرستی از آدرس‌های ایمیل به CC جدا شده با کاما
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط GmailApp.getAliases() باشد.
htmlBody String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید
inlineImages Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( BlobSource ). فرض بر این است که پارامتر htmlBody استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
replyTo String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
subject String یک موضوع جدید برای ایمیل حداکثر اندازه 250 کاراکتر است.

بازگشت

GmailDraft - پیام پیش نویس تازه ایجاد شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


getFirstMessageSubject()

موضوع اولین پیام در تاپیک را دریافت می کند.

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

همچنین ببینید


getId()

شناسه این تاپیک را می گیرد. شناسه یک رشته بر اساس پیام هایی که دارد متفاوت است. برای یک شناسه ثابت برای یک پیام خاص در رشته، در عوض 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 - شناسه این رشته


getLabels()

برچسب های ایجاد شده توسط کاربر در این رشته را برمی گرداند.

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

getLastMessageDate()

تاریخ آخرین پیام این موضوع را دریافت می کند.

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

همچنین ببینید


getMessageCount()

تعداد پیام های موجود در رشته را برمی گرداند.

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

همچنین ببینید


یک پیوند ثابت برای این موضوع دریافت می کند.

توجه داشته باشید که این فقط با رابط کلاسیک Gmail کار می کند، نه Inbox.

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

بازگشت

String - پیوند ثابت برای این موضوع


hasStarredMessages()

نشان می دهد که آیا رشته پیام های ستاره دار دارد یا خیر.

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

بازگشت

Boolean - اگر رشته پیام‌های ستاره‌دار داشته باشد درست است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

isImportant()

نشان می دهد که آیا موضوع به عنوان مهم علامت گذاری شده است یا خیر.

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

isInChats()

نشان می دهد که آیا موضوع برچسب چت است یا خیر.

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

بازگشت

Boolean - درست است اگر موضوع برچسب چت باشد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

isInInbox()

نشان می دهد که آیا موضوع در صندوق ورودی است یا خیر.

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

بازگشت

Boolean - اگر رشته در صندوق ورودی باشد درست است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

isInPriorityInbox()

اگر این موضوع در صندوق ورودی اولویت باشد، مقدار 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 - اگر رشته در صندوق ورودی اولویت باشد درست است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

isInSpam()

نشان می دهد که آیا موضوع به عنوان هرزنامه علامت گذاری شده است.

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

isInTrash()

نشان می دهد که آیا موضوع در سطل زباله است.

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

بازگشت

Boolean - اگر رشته در سطل زباله باشد درست است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

isUnread()

نشان می دهد که آیا رشته پیام های خوانده نشده ای دارد یا خیر.

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

بازگشت

Boolean - اگر پیام های خوانده نشده وجود داشته باشد درست است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

markImportant()

این موضوع را به عنوان مهم علامت گذاری می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


markRead()

این موضوع را به عنوان خوانده شده علامت گذاری می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


markUnimportant()

این موضوع را به عنوان بی اهمیت علامت گذاری می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


markUnread()

این موضوع را به عنوان خوانده نشده علامت گذاری می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


moveToArchive()

این موضوع را به بایگانی منتقل می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

moveToInbox()

این موضوع را به صندوق ورودی منتقل می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

moveToSpam()

این موضوع را به هرزنامه منتقل می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

moveToTrash()

این موضوع را به سطل زباله منتقل می کند.

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

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

refresh()

این رشته و وضعیت مرتبط را از 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/

removeLabel(label)

این برچسب را از موضوع حذف می کند.

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

پارامترها

نام تایپ کنید توضیحات
label GmailLabel برچسبی که باید از این موضوع حذف شود

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


reply(body)

با استفاده از آدرس replyTo به فرستنده آخرین پیام در این موضوع پاسخ دهید.

توجه داشته باشید که حجم کل ایمیل (شامل تمام سرصفحه ها) ممکن است از 20 کیلوبایت بیشتر نباشد.

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

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


reply(body, options)

با استفاده از آدرس replyTo، با آرگومان های اختیاری به فرستنده آخرین پیام در این رشته پاسخ دهید. ایمیل می تواند شامل متن ساده و همچنین یک متن HTML باشد. توجه داشته باشید که حجم کل ایمیل (شامل تمام سرصفحه ها، به استثنای پیوست ها) ممکن است از 20 کیلوبایت تجاوز نکند.

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

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل
options Object یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

پارامترهای پیشرفته

نام تایپ کنید توضیحات
cc String فهرستی از آدرس‌های ایمیل با کاما جدا شده به CC
bcc String فهرستی از آدرس‌های ایمیل با ویرگول جدا شده از BCC
htmlBody String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط GmailApp.getAliases() باشد.
replyTo String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
noReply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های Google Workspace امکان پذیر است، نه کاربران Gmail
attachments BlobSource[] مجموعه ای از فایل ها برای ارسال با ایمیل
inlineImages Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( BlobSource ). فرض بر این است که پارامتر htmlBody استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


replyAll(body)

به فرستنده (با استفاده از آدرس replyTo)، و همه گیرندگان آخرین پیام در این موضوع پاسخ دهید.

توجه داشته باشید که حجم کل ایمیل (شامل تمام سرصفحه ها) ممکن است از 20 کیلوبایت بیشتر نباشد.

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

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید


replyAll(body, options)

به فرستنده (با استفاده از آدرس replyTo )، و همه گیرندگان آخرین پیام در این رشته، با آرگومان های اختیاری پاسخ دهید. ایمیل می تواند شامل متن ساده و همچنین یک متن HTML باشد. توجه داشته باشید که حجم کل ایمیل (شامل تمام سرصفحه ها، به استثنای پیوست ها) ممکن است از 20 کیلوبایت تجاوز نکند.

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

پارامترها

نام تایپ کنید توضیحات
body String بدنه ایمیل
options Object یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

پارامترهای پیشرفته

نام تایپ کنید توضیحات
cc String فهرستی از آدرس‌های ایمیل با کاما جدا شده به CC
bcc String فهرستی از آدرس‌های ایمیل با ویرگول جدا شده از BCC
htmlBody String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط GmailApp.getAliases() باشد.
replyTo String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
noReply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های G Suite امکان پذیر است، نه کاربران Gmail
attachments BlobSource[] مجموعه ای از فایل ها برای ارسال با ایمیل
inlineImages Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( BlobSource ). فرض بر این است که پارامتر htmlBody استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.

بازگشت

GmailThread - این رشته، برای زنجیره کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

  • https://mail.google.com/

همچنین ببینید