رشته ای در حساب کاربری جیمیل یک کاربر.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
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/