Class GmailApp

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

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());

پارامترها

بازگشت

GmailDraft - GmailDraft تازه ایجاد شده

مجوز

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

• https://mail.google.com/

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

• createDraft(recipient, subject, body, options)

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

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

پارامترها

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

بازگشت

GmailDraft - GmailDraft تازه ایجاد شده

مجوز

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

• https://mail.google.com/

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

• createDraft(recipient, subject, body)

یک برچسب کاربری جدید با نام داده شده ایجاد کنید.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

پارامترها

بازگشت

GmailLabel - برچسب تازه ایجاد شده

مجوز

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

• https://mail.google.com/

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

• deleteLabel(label)

برچسب مشخص شده را حذف می کند.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• createLabel(name)

فهرستی از ایمیل هایی را دریافت می کند که به عنوان نام مستعار برای این حساب در Gmail تنظیم شده اند.

با استفاده از آرگومان اختیاری "from" می توانید از هر یک از این نام های مستعار پیام ارسال کنید.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

بازگشت

String[] - آرایه ای از نام مستعار برای این حساب

مجوز

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

• https://mail.google.com/

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

• sendEmail(recipient, subject, body, options)

پیش نویس پیام ایمیل را با شناسه بازیابی کنید.

از این به همراه getId() در پیش نویس های Gmail استفاده کنید.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

پارامترها

بازگشت

GmailDraft - پیش نویس با شناسه داده شده

پرتاب می کند

Error - اگر هیچ پیش نویس با شناسه داده شده یافت نشد

مجوز

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

• https://mail.google.com/

همه پیام های پیش نویس را بازیابی می کند.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

بازگشت

GmailMessage[] - آرایه‌ای از پیام‌های پیش‌نویس Gmail

مجوز

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

• https://mail.google.com/

همه پیام‌های پیش‌نویس Gmail را دریافت می‌کند.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

بازگشت

GmailDraft[] - آرایه‌ای از پیام‌های پیش‌نویس Gmail

مجوز

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

• https://mail.google.com/

همه رشته‌های صندوق ورودی را بدون در نظر گرفتن برچسب‌ها بازیابی می‌کند.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در صندوق ورودی

مجوز

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

• https://mail.google.com/

طیفی از رشته‌های صندوق ورودی را بدون توجه به برچسب‌ها بازیابی می‌کند.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

پارامترها

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در صندوق ورودی

مجوز

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

• https://mail.google.com/

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

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

بازگشت

Integer - تعداد رشته‌هایی در صندوق ورودی که پیام‌های خوانده نشده دارند

مجوز

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

• https://mail.google.com/

با شناسه پیام می گیرد.

از این در ارتباط با getId() در پیام‌های Gmail استفاده کنید.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

پارامترها

بازگشت

GmailMessage - پیام با شناسه داده شده

پرتاب می کند

Error - اگر هیچ پیامی با شناسه داده شده یافت نشد

مجوز

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

• https://mail.google.com/

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

• getThreadById(id)

همه پیام های موجود در رشته مشخص شده را بازیابی کنید.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

پارامترها

بازگشت

GmailMessage[] - آرایه ای از پیام های مربوط به این رشته

مجوز

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

• https://mail.google.com/

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

• getMessagesForThreads(threads)

همه پیام ها را در رشته های مشخص شده بازیابی کنید.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

پارامترها

بازگشت

GmailMessage[][] - آرایه‌ای از آرایه‌ها از پیام‌ها، که در آن هر مورد در آرایه بیرونی مربوط به یک رشته است و آرایه داخلی حاوی پیام‌های موجود در آن رشته است.

مجوز

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

• https://mail.google.com/

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

• getMessagesForThread(thread)

همه رشته‌های صندوق ورودی اولویتی را بدون توجه به برچسب‌ها بازیابی می‌کند.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در صندوق ورودی اولویتی

مجوز

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

• https://mail.google.com/

طیفی از رشته‌های صندوق ورودی اولویتی را بدون توجه به برچسب‌ها بازیابی می‌کند.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

پارامترها

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در صندوق ورودی اولویتی

مجوز

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

• https://mail.google.com/

تعداد رشته های خوانده نشده را در صندوق ورودی اولویتی دریافت می کند.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

بازگشت

Integer - تعداد رشته‌هایی در صندوق ورودی اولویتی که پیام‌های خوانده نشده دارند

مجوز

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

• https://mail.google.com/

همه رشته های هرزنامه را بدون در نظر گرفتن برچسب ها بازیابی می کند.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در پوشه هرزنامه

مجوز

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

• https://mail.google.com/

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

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

پارامترها

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در پوشه هرزنامه

مجوز

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

• https://mail.google.com/

تعداد رشته های خوانده نشده که هرزنامه هستند را دریافت می کند.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

بازگشت

Integer - تعداد رشته‌های هرزنامه که پیام‌های خوانده نشده دارند

مجوز

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

• https://mail.google.com/

همه رشته های ستاره دار را بدون در نظر گرفتن برچسب ها بازیابی می کند.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

بازگشت

GmailThread[] - آرایه ای از رشته های ستاره دار Gmail

مجوز

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

• https://mail.google.com/

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

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

پارامترها

بازگشت

GmailThread[] - آرایه ای از رشته های ستاره دار Gmail

مجوز

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

• https://mail.google.com/

تعداد رشته های خوانده نشده ستاره دار را دریافت می کند.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

بازگشت

Integer - تعداد رشته های ستاره دار که پیام های خوانده نشده دارند

مجوز

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

• https://mail.google.com/

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

از این در ارتباط با getId() در موضوعات Gmail استفاده کنید.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

پارامترها

بازگشت

GmailThread - رشته ای با شناسه داده شده یا در صورت یافت نشدن null .

مجوز

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

• https://mail.google.com/

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

• getMessageById(id)

همه رشته های زباله را بدون در نظر گرفتن برچسب ها بازیابی می کند.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در سطل زباله

مجوز

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

• https://mail.google.com/

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

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

پارامترها

بازگشت

GmailThread[] - آرایه ای از رشته های Gmail در سطل زباله

مجوز

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

• https://mail.google.com/

برچسبی را با نام برچسب بازیابی می کند.

var labelObject = GmailApp.getUserLabelByName("myLabel");

پارامترها

بازگشت

GmailLabel - برچسب Gmail با نام داده شده

مجوز

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

• https://mail.google.com/

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

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

بازگشت

GmailLabel[] - آرایه ای از برچسب های ایجاد شده توسط کاربر

مجوز

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

• https://mail.google.com/

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

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markMessageUnread(message)

این پیام را به عنوان خوانده‌نشده علامت‌گذاری می‌کند و پیام را مجبور به بازخوانی می‌کند.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markMessageRead(message)

این پیام‌ها را به‌عنوان خوانده‌شده علامت‌گذاری می‌کند و پیام‌ها را مجبور به بازخوانی می‌کند.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markMessagesUnread(messages)

این پیام‌ها را به عنوان خوانده نشده علامت‌گذاری می‌کند و پیام‌ها را مجبور به بازخوانی می‌کند.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• markMessagesRead(messages)

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

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• markThreadUnimportant(thread)

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

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadUnread(thread)

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

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadImportant(thread)

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

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadRead(thread)

این رشته‌ها را به‌عنوان مهم علامت‌گذاری می‌کند و رشته‌ها را مجبور به تازه کردن می‌کند.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadsUnimportant(threads)

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

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadsUnread(threads)

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

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadsImportant(threads)

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

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• markThreadsRead(threads)

پیام را به سطل زباله منتقل می کند و پیام را مجبور به بازخوانی می کند.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

پارامترها

بازگشت

GmailApp — سرویس جیمیل (مفید برای زنجیره زدن)

مجوز

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

• https://mail.google.com/

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

• moveMessagesToTrash(messages)

پیام های مشخص شده را به سطل زباله منتقل می کند و پیام ها را مجبور به بازخوانی می کند.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

پارامترها

بازگشت

GmailApp — سرویس جیمیل (مفید برای زنجیره زدن)

مجوز

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

• https://mail.google.com/

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

• moveMessageToTrash(message)

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

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

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

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

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

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

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

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

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

این رشته ها را به بایگانی منتقل می کند و رشته ها را مجبور به تازه کردن می کند.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

این رشته‌ها را به صندوق ورودی منتقل می‌کند و رشته‌ها را مجبور به تازه‌سازی می‌کند.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

این رشته ها را به هرزنامه منتقل می کند و رشته ها را مجبور به بازخوانی می کند.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

این رشته‌ها را به سطل زباله منتقل می‌کند و رشته‌ها را مجبور به تازه کردن می‌کند.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

پیام و وضعیت مرتبط را از Gmail مجدداً بارگیری می کند (برای مواردی که برچسب ها، وضعیت خواندن و غیره تغییر کرده باشند مفید است).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• refreshMessages(messages)

پیام‌ها و وضعیت مرتبط را از Gmail بارگیری مجدد می‌کند (در مواردی که برچسب‌ها، وضعیت خواندن و غیره تغییر کرده باشند مفید است).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• refreshMessage(message)

رشته و وضعیت مرتبط را از Gmail بارگیری مجدد می کند (در مواردی که برچسب ها، وضعیت خواندن و غیره تغییر کرده باشند مفید است).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• refreshThreads(threads)

رشته ها و وضعیت مرتبط را از Gmail بارگیری مجدد می کند (در مواردی که برچسب ها، وضعیت خواندن و غیره تغییر کرده باشند مفید است).

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• refreshThread(thread)

جیمیل را با عبارت مورد نظر جستجو کنید.

زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، این تماس با شکست مواجه می‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از فراخوانی «صفحه‌شده» استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

پارامترها

بازگشت

GmailThread[] - آرایه‌ای از رشته‌های Gmail که با این جستار مطابقت دارند

مجوز

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

• https://mail.google.com/

جیمیل را با عبارت مورد نظر جستجو کنید.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

پارامترها

بازگشت

GmailThread[] - آرایه‌ای از رشته‌های Gmail که با این جستار مطابقت دارند

مجوز

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

• https://mail.google.com/

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

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("mike@example.com", "current time", "The time is: " + now.toString());

پارامترها

بازگشت

GmailApp - سرویس جیمیل، مفید برای زنجیره زدن

مجوز

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

• https://mail.google.com/

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

• sendEmail(recipient, subject, body, options)

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

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('mike@example.com', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

پارامترها

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

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• sendEmail(recipient, subject, body)

رمز دسترسی پیام فعلی را تنظیم می کند که اسکریپت را قادر می سازد به ویژگی های GmailMessage فعلی دسترسی پیدا کند.

فقط پروژه‌های افزودنی Google Workspace با استفاده از دامنه پیام فعلی Gmail به این روش نیاز دارند.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

پارامترها

مجوز

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

• https://mail.google.com/

یک ستاره به این پیام اضافه می کند و پیام را مجبور می کند تا به روز شود.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• starMessages(messages)

به این پیام‌ها ستاره اضافه می‌کند و پیام‌ها را مجبور به تازه‌سازی می‌کند.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• starMessage(message)

ستاره ای را از این پیام حذف می کند و پیام را مجبور به بازخوانی می کند.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• unstarMessages(messages)

ستاره‌ها را از این پیام‌ها حذف می‌کند و پیام‌ها را مجبور به بازخوانی می‌کند.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

پارامترها

بازگشت

GmailApp - سرویس Gmail، مفید برای زنجیره‌سازی

مجوز

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

• https://mail.google.com/

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

• unstarMessage(message)