Class GmailThread

موضوع جیمیل

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

روش ها

روش نوع برگشت شرح مختصر
add Label(label) Gmail Thread این برچسب را به موضوع اضافه می کند.
create Draft Reply(body) Gmail Draft یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته با استفاده از آدرس پاسخ به پاسخ می‌دهد.
create Draft Reply(body, options) Gmail Draft یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته با استفاده از آدرس پاسخ به، با آرگومان‌های اختیاری پاسخ می‌دهد.
create Draft Reply All(body) Gmail Draft با استفاده از آدرس پاسخ به و همه گیرندگان این پیام، یک پیام پیش‌نویس ایجاد می‌کند که به فرستنده آخرین پیام در این رشته پاسخ می‌دهد.
create Draft Reply All(body, options) Gmail Draft یک پیام پیش نویس برای پاسخ به فرستنده آخرین پیام در این رشته، با استفاده از آدرس پاسخ به و همه گیرندگان، با آرگومان های اختیاری ایجاد می کند.
get First Message Subject() String موضوع اولین پیام در تاپیک را دریافت می کند.
get Id() String شناسه این تاپیک را می گیرد.
get Labels() Gmail Label[] برچسب های ایجاد شده توسط کاربر در این رشته را برمی گرداند.
get Last Message Date() Date تاریخ آخرین پیام این موضوع را دریافت می کند.
get Message Count() Integer تعداد پیام های موجود در رشته را برمی گرداند.
get Messages() Gmail Message[] پیام های این تاپیک را دریافت می کند.
get Permalink() String یک پیوند ثابت برای این موضوع دریافت می کند.
has Starred Messages() Boolean نشان می دهد که آیا رشته پیام های ستاره دار دارد یا خیر.
is Important() Boolean نشان می دهد که آیا موضوع به عنوان مهم علامت گذاری شده است یا خیر.
is In Chats() Boolean نشان می دهد که آیا موضوع برچسب چت است یا خیر.
is In Inbox() Boolean نشان می دهد که آیا موضوع در صندوق ورودی است یا خیر.
is In Priority Inbox() Boolean اگر این موضوع در صندوق ورودی اولویت باشد، مقدار true را برمی‌گرداند. در غیر این صورت false برمی گرداند.
is In Spam() Boolean نشان می دهد که آیا موضوع به عنوان هرزنامه علامت گذاری شده است.
is In Trash() Boolean نشان می دهد که آیا موضوع در سطل زباله است.
is Unread() Boolean نشان می دهد که آیا رشته پیام های خوانده نشده ای دارد یا خیر.
mark Important() Gmail Thread این موضوع را به عنوان مهم علامت گذاری می کند.
mark Read() Gmail Thread این موضوع را به عنوان خوانده شده علامت گذاری می کند.
mark Unimportant() Gmail Thread این موضوع را به عنوان بی اهمیت علامت گذاری می کند.
mark Unread() Gmail Thread این موضوع را به عنوان خوانده نشده علامت گذاری می کند.
move To Archive() Gmail Thread این موضوع را به بایگانی منتقل می کند.
move To Inbox() Gmail Thread این موضوع را به صندوق ورودی منتقل می کند.
move To Spam() Gmail Thread این موضوع را به هرزنامه منتقل می کند.
move To Trash() Gmail Thread این موضوع را به سطل زباله منتقل می کند.
refresh() Gmail Thread این رشته و وضعیت مرتبط را از Gmail بارگیری مجدد می کند (در مواردی که برچسب ها، وضعیت خواندن و غیره تغییر کرده باشند مفید است).
remove Label(label) Gmail Thread این برچسب را از موضوع حذف می کند.
reply(body) Gmail Thread با استفاده از آدرس replyTo به فرستنده آخرین پیام در این موضوع پاسخ دهید.
reply(body, options) Gmail Thread با استفاده از آدرس replyTo، با آرگومان های اختیاری به فرستنده آخرین پیام در این رشته پاسخ دهید.
reply All(body) Gmail Thread به فرستنده (با استفاده از آدرس replyTo)، و همه گیرندگان آخرین پیام در این موضوع پاسخ دهید.
reply All(body, options) Gmail Thread به فرستنده (با استفاده از reply To آدرس)، و همه گیرندگان آخرین پیام در این رشته، با آرگومان های اختیاری پاسخ دهید.

مستندات دقیق

add Label(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 Gmail Label برچسبی که باید روی این موضوع اعمال شود

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

create Draft Reply(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 بدنه ایمیل

بازگشت

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

مجوز

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

  • https://mail.google.com/

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

create Draft Reply(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: 'another@example.com',
});

پارامترها

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

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

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

create Draft Reply All(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 بدنه ایمیل

بازگشت

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

مجوز

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

  • https://mail.google.com/

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

create Draft Reply All(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: 'another@example.com',
});

پارامترها

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

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

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

get First Message Subject()

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

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

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

get Id()

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

get Labels()

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

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

بازگشت

Gmail Label[] - آرایه‌ای از برچسب‌ها برای این رشته

مجوز

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

  • https://mail.google.com/

get Last Message Date()

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

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

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

get Message Count()

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

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

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

get Messages()

پیام های این تاپیک را دریافت می کند. 

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

بازگشت

Gmail Message[] - آرایه ای از پیام های جیمیل در این رشته

مجوز

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

  • https://mail.google.com/

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

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

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

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

بازگشت

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

has Starred Messages()

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

is Important()

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

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

is In Chats()

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

is In Inbox()

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

is In Priority Inbox()

اگر این موضوع در صندوق ورودی اولویت باشد، مقدار true را برمی‌گرداند. در غیر این صورت false برمی گرداند. 

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

مجوز

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

  • https://mail.google.com/

is In Spam()

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

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

is In Trash()

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

is Unread()

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

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

بازگشت

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

مجوز

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

  • https://mail.google.com/

mark Important()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

mark Read()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

mark Unimportant()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

mark Unread()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

move To Archive()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

move To Inbox()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

move To Spam()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

move To Trash()

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

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از 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 ...

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

remove Label(label)

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

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

پارامترها

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

reply(body)

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

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

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

پارامترها

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

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

reply(body, options)

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

// 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 یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

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

نام تایپ کنید توضیحات
cc String فهرستی از آدرس‌های ایمیل با کاما جدا شده به CC
bcc String فهرستی از آدرس‌های ایمیل با ویرگول جدا شده از BCC
html Body String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر تصاویر درون خطی برای ایمیل خود دارید، می توانید یک فیلد inline Images اختیاری در متن HTML اضافه کنید
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط Gmail App.getAliases() باشد.
reply To String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
no Reply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های Google Workspace امکان پذیر است، نه کاربران Gmail
attachments Blob Source[] مجموعه ای از فایل ها برای ارسال با ایمیل
inline Images Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( Blob Source ) . فرض بر این است که پارامتر html Body استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

reply All(body)

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

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

// 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 بدنه ایمیل

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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

reply All(body, options)

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

// 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 یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

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

نام تایپ کنید توضیحات
cc String فهرستی از آدرس‌های ایمیل با کاما جدا شده به CC
bcc String فهرستی از آدرس‌های ایمیل با ویرگول جدا شده از BCC
html Body String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر تصاویر درون خطی برای ایمیل خود دارید، می توانید یک فیلد inline Images اختیاری در متن HTML اضافه کنید
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
from String آدرسی که ایمیل باید از آن ارسال شود، که باید یکی از مقادیر بازگردانده شده توسط Gmail App.getAliases() باشد.
reply To String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)
no Reply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های G Suite امکان پذیر است، نه کاربران Gmail
attachments Blob Source[] مجموعه ای از فایل ها برای ارسال با ایمیل
inline Images Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( Blob Source ) . فرض بر این است که پارامتر html Body استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.

بازگشت

Gmail Thread - این رشته برای زنجیره‌بندی مفید است

مجوز

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

  • https://mail.google.com/

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