Class GmailLabel

این برچسب را به رشته داده شده اضافه می کند و رشته را مجبور می کند تا رفرش شود ( GmailThread.refresh() ).

// label the first thread in the inbox with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
label.addToThread(firstThread);

پارامترها

بازگشت

GmailLabel - این برچسب برای زنجیر کردن.

مجوز

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

• https://mail.google.com/

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

• removeFromThread(thread)

این برچسب را به رشته های داده شده اضافه می کند و رشته ها را مجبور به تازه کردن می کند. شما می توانید برچسب هایی را برای حداکثر 100 رشته در هر دسته اضافه کنید.

// label the first three threads in the inbox with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = GmailApp.getInboxThreads(0,3);
label.addToThreads(threads);

پارامترها

بازگشت

GmailLabel - این برچسب برای زنجیر کردن.

مجوز

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

• https://mail.google.com/

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

• removeFromThreads(threads)

این برچسب را حذف می کند.

var label = GmailApp.getUserLabelByName("MyLabel");
label.deleteLabel();

پرتاب می کند

Error - اگر برچسب را نمی توان حذف کرد

مجوز

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

• https://mail.google.com/

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

• getName()

نام این برچسب را دریافت می کند.

var label = GmailApp.getUserLabelByName("MyLabel");
Logger.log(label.getName()); //logs MyLabel

بازگشت

String - نام برچسب.

مجوز

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

• https://mail.google.com/

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

این فراخوانی زمانی که اندازه همه رشته‌ها برای سیستم بسیار بزرگ باشد، انجام نمی‌شود. در جایی که اندازه رشته ناشناخته است، و احتمالاً بسیار بزرگ است، لطفاً از getThreads(start, max) استفاده کنید و محدوده رشته‌ها را برای بازیابی در هر تماس مشخص کنید.

// Log the subject lines of the threads labeled with MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = label.getThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

بازگشت

GmailThread[] - آرایه‌ای از رشته‌هایی که با این برچسب مشخص شده‌اند.

مجوز

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

• https://mail.google.com/

طیف وسیعی از موضوعات را که با این برچسب مشخص شده اند دریافت می کند.

// log the subject lines of up to the first 30 threads with the label MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = label.getThreads(0, 30);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

پارامترها

بازگشت

GmailThread[] - آرایه‌ای از رشته‌هایی که با این برچسب مشخص شده‌اند.

مجوز

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

• https://mail.google.com/

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

// log the number of unread threads labeled with MyLabel
var label = GmailApp.getUserLabelByName("MyLabel");
Logger.log(label.getUnreadCount());

بازگشت

Integer - تعداد رشته های برچسب دار خوانده نشده.

مجوز

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

• https://mail.google.com/

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

// remove the label MyLabel from the first thread in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
label.removeFromThread(firstThread);

پارامترها

بازگشت

GmailLabel - این برچسب برای زنجیر کردن.

مجوز

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

• https://mail.google.com/

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

• addToThread(thread)

این برچسب را از رشته های داده شده حذف می کند و رشته ها را مجبور به تازه کردن می کند. شما می توانید برچسب ها را برای حداکثر 100 رشته در هر دسته حذف کنید.

// remove the label MyLabel from the first three threads in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var threads = GmailApp.getInboxThreads(0,3);
label.removeFromThreads(threads);

پارامترها

بازگشت

GmailLabel - این برچسب برای زنجیر کردن.

مجوز

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

• https://mail.google.com/

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

• addToThreads(threads)