رشته ای در حساب کاربری جیمیل یک کاربر.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
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/
همچنین ببینید
getPermalink()
یک پیوند ثابت برای این موضوع دریافت می کند.
توجه داشته باشید که این فقط با رابط کلاسیک 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/