Class GmailApp

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

// The code below creates a draft email with the current date and time.
const now = new Date();
GmailApp.createDraft(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• create Draft(recipient, subject, body, options)

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

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

پارامترها

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• create Draft(recipient, subject, body)

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

// Creates the label @FOO and logs label: FOO
Logger.log(`label: ${GmailApp.createLabel('FOO')}`);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• delete Label(label)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• create Label(name)

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

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

// Log the aliases for this Gmail account and send an email as the first one.
const me = Session.getActiveUser().getEmail();
const 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/

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

• send Email(recipient, subject, body, options)

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

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

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

پارامترها

بازگشت

Gmail Draft - پیش نویس با شناسه داده شده

پرتاب می کند

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

مجوز

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

• https://mail.google.com/

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

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

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

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

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

پارامترها

بازگشت

Gmail Thread[] - آرایه‌ای از رشته‌های 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
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
const messageId = message.getId();
// Now fetch the same message using that ID.
const messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() === messageById.getSubject());

پارامترها

بازگشت

Gmail Message - پیام با شناسه داده شده

پرتاب می کند

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

مجوز

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

• https://mail.google.com/

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

• get Thread By Id(id)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• get Messages For Threads(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• get Messages For Thread(thread)

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

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

Logger.log(
    `# of messages in your Priority Inbox: ${
        GmailApp.getPriorityInboxThreads().length}`,
);

بازگشت

Gmail Thread[] - آرایه ای از رشته های 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}`,
);

پارامترها

بازگشت

Gmail Thread[] - آرایه ای از رشته های 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}`);

بازگشت

Gmail Thread[] - آرایه ای از رشته های 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}`);

پارامترها

بازگشت

Gmail Thread[] - آرایه ای از رشته های 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}`);

بازگشت

Gmail Thread[] - آرایه‌ای از رشته‌های ستاره‌دار 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}`);

پارامترها

بازگشت

Gmail Thread[] - آرایه‌ای از رشته‌های ستاره‌دار 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(),
);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• get Message By Id(id)

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

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

Logger.log(`# of total trash threads: ${GmailApp.getTrashThreads().length}`);

بازگشت

Gmail Thread[] - آرایه‌ای از رشته‌های 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}`,
);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

const labelObject = GmailApp.getUserLabelByName('myLabel');

پارامترها

بازگشت

Gmail Label - برچسب جیمیل با نام مشخص شده

مجوز

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

• https://mail.google.com/

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

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Message Unread(message)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Message Read(message)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Messages Unread(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Messages Read(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Thread Unimportant(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Thread Unread(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Thread Important(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Thread Read(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Threads Unimportant(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Threads Unread(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Threads Important(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• mark Threads Read(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Messages To Trash(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Message To Trash(message)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Thread To Inbox(thread)
• move Thread To Spam(thread)
• move Thread To Trash(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Thread To Trash(thread)
• move Thread To Spam(thread)
• move Thread To Archive(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Thread To Trash(thread)
• move Thread To Inbox(thread)
• move Thread To Archive(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Thread To Inbox(thread)
• move Thread To Spam(thread)
• move Thread To Archive(thread)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Threads To Inbox(threads)
• move Threads To Spam(threads)
• move Threads To Trash(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Threads To Trash(threads)
• move Threads To Spam(threads)
• move Threads To Archive(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Threads To Inbox(threads)
• move Threads To Trash(threads)
• move Threads To Archive(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• move Threads To Inbox(threads)
• move Threads To Spam(threads)
• move Threads To Archive(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• refresh Messages(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• refresh Message(message)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• refresh Threads(threads)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• refresh Thread(thread)

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

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

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

پارامترها

بازگشت

Gmail Thread[] - آرایه‌ای از رشته‌های 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.
const threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

// The code below will send an email with the current date and time.
const now = new Date();
GmailApp.sendEmail(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• send Email(recipient, subject, body, options)

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

// Send an email with a file from Google Drive attached as a PDF.
const 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',
    },
);

پارامترها

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

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• send Email(recipient, subject, body)

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

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

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

پارامترها

مجوز

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

• https://mail.google.com/

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• star Messages(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• star Message(message)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• unstar Messages(messages)

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

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

پارامترها

بازگشت

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

مجوز

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

• https://mail.google.com/

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

• unstar Message(message)