Class GmailApp

الطريقة	نوع الإرجاع	وصف قصير
`createDraft(recipient, subject, body)`	`GmailDraft`	إنشاء مسوّدة رسالة إلكترونية.
`createDraft(recipient, subject, body, options)`	`GmailDraft`	إنشاء مسودة رسالة إلكترونية باستخدام وسيطات اختيارية.
`createLabel(name)`	`GmailLabel`	إنشاء تصنيف مستخدم جديد للاسم المحدد.
`deleteLabel(label)`	`GmailApp`	حذف التصنيف المحدد.
`getAliases()`	`String[]`	يحصل على قائمة برسائل البريد الإلكتروني التي تم إعدادها كأسماء مستعارة لهذا الحساب في Gmail.
`getDraft(draftId)`	`GmailDraft`	استرداد مسودة رسالة إلكترونية باستخدام رقم التعريف
`getDraftMessages()`	`GmailMessage[]`	لاسترداد جميع مسودات الرسائل.
`getDrafts()`	`GmailDraft[]`	الحصول على جميع مسودات الرسائل في Gmail.
`getInboxThreads()`	`GmailThread[]`	لاسترداد جميع سلاسل محادثات البريد الوارد بغض النظر عن التصنيفات.
`getInboxThreads(start, max)`	`GmailThread[]`	لاسترداد نطاق من سلاسل محادثات البريد الوارد بغض النظر عن التصنيفات.
`getInboxUnreadCount()`	`Integer`	للحصول على عدد سلاسل المحادثات غير المقروءة في البريد الوارد.
`getMessageById(id)`	`GmailMessage`	يتلقّى الرسالة بواسطة رقم التعريف.
`getMessagesForThread(thread)`	`GmailMessage[]`	يمكنك استرداد جميع الرسائل في سلسلة المحادثات المُحدَّدة.
`getMessagesForThreads(threads)`	`GmailMessage[][]`	يمكنك استرداد جميع الرسائل في سلاسل المحادثات المحدَّدة.
`getPriorityInboxThreads()`	`GmailThread[]`	لاسترداد جميع سلاسل البريد الوارد ذات الأولوية بغض النظر عن التصنيفات.
`getPriorityInboxThreads(start, max)`	`GmailThread[]`	لاسترداد نطاق من سلاسل محادثات البريد الهام بغض النظر عن التصنيفات.
`getPriorityInboxUnreadCount()`	`Integer`	يعرض عدد سلاسل المحادثات غير المقروءة في "البريد الهام".
`getSpamThreads()`	`GmailThread[]`	لاسترداد جميع سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات.
`getSpamThreads(start, max)`	`GmailThread[]`	لاسترداد نطاق من سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات.
`getSpamUnreadCount()`	`Integer`	الحصول على عدد سلاسل المحادثات غير المقروءة.
`getStarredThreads()`	`GmailThread[]`	لاسترداد جميع سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات.
`getStarredThreads(start, max)`	`GmailThread[]`	لاسترداد نطاق من سلاسل المحادثات المميزة بنجمة بغض النظر عن التصنيفات.
`getStarredUnreadCount()`	`Integer`	لعرض عدد سلاسل المحادثات غير المقروءة التي تم تمييزها بنجمة.
`getThreadById(id)`	`GmailThread`	الحصول على سلسلة محادثات حسب رقم التعريف.
`getTrashThreads()`	`GmailThread[]`	لاسترداد جميع سلاسل محادثات المهملات بغض النظر عن التصنيفات.
`getTrashThreads(start, max)`	`GmailThread[]`	لاسترداد نطاق من سلاسل المحادثات للمهملات بغض النظر عن التصنيفات.
`getUserLabelByName(name)`	`GmailLabel`	استرداد تصنيف نظرًا لاسم التصنيف.
`getUserLabels()`	`GmailLabel[]`	لاسترداد قائمة التصنيفات التي أنشأها المستخدم.
`markMessageRead(message)`	`GmailApp`	وضع علامة على هذه الرسالة كمقروءة وفرض إعادة تحميلها.
`markMessageUnread(message)`	`GmailApp`	وضع علامة على هذه الرسالة كغير مقروءة وفرض إعادة تحميل الرسالة.
`markMessagesRead(messages)`	`GmailApp`	وضع علامة على هذه الرسائل للقراءة وفرض إعادة تحميل الرسائل.
`markMessagesUnread(messages)`	`GmailApp`	وضع علامة على هذه الرسائل كغير مقروءة وفرض إعادة تحميل الرسائل.
`markThreadImportant(thread)`	`GmailApp`	وضع علامة على سلسلة المحادثات هذه باعتبارها مهمة وتفرض إعادة تحميل سلسلة المحادثات.
`markThreadRead(thread)`	`GmailApp`	وضع علامة على سلسلة المحادثات هذه كمقروءة وفرض إعادة تحميل سلسلة المحادثات.
`markThreadUnimportant(thread)`	`GmailApp`	وضع علامة على سلسلة المحادثات هذه على أنها غير مهمة وفرض إعادة تحميل سلسلة المحادثات.
`markThreadUnread(thread)`	`GmailApp`	وضع علامة على سلسلة المحادثات هذه كغير مقروءة وفرض إعادة تحميل سلسلة المحادثات.
`markThreadsImportant(threads)`	`GmailApp`	وضع علامة على سلاسل المحادثات هذه كرسائل مهمة وفرض إعادة تحميل سلاسل المحادثات.
`markThreadsRead(threads)`	`GmailApp`	وضع علامة على سلاسل المحادثات هذه كمقروءة وفرض إعادة تحميل سلاسل المحادثات.
`markThreadsUnimportant(threads)`	`GmailApp`	وضع علامة "غير مهمّة" على سلاسل المحادثات هذه وفرض إعادة تحميل سلاسل المحادثات
`markThreadsUnread(threads)`	`GmailApp`	وضع علامة "غير مقروءة" على سلاسل المحادثات هذه وفرض إعادة تحميل سلاسل المحادثات
`moveMessageToTrash(message)`	`GmailApp`	نقل الرسالة إلى المهملات وفرض إعادة تحميل الرسالة
`moveMessagesToTrash(messages)`	`GmailApp`	لنقل الرسائل المحددة إلى المهملات وفرض إعادة تحميل الرسائل.
`moveThreadToArchive(thread)`	`GmailApp`	تنقل سلسلة المحادثات هذه إلى الأرشيف وتفرض إعادة تحميل سلسلة المحادثات.
`moveThreadToInbox(thread)`	`GmailApp`	لنقل سلسلة المحادثات هذه إلى البريد الوارد وفرض إعادة تحميل سلسلة المحادثات
`moveThreadToSpam(thread)`	`GmailApp`	نقل سلسلة المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها وفرض إعادة تحميل سلسلة المحادثات
`moveThreadToTrash(thread)`	`GmailApp`	ينقل سلسلة المحادثات هذه إلى المهملات وفرض إعادة تحميل سلسلة المحادثات
`moveThreadsToArchive(threads)`	`GmailApp`	يؤدي إلى نقل سلاسل المحادثات هذه إلى الأرشيف وفرض إعادة تحميل سلاسل المحادثات.
`moveThreadsToInbox(threads)`	`GmailApp`	يؤدي إلى نقل سلاسل المحادثات هذه إلى البريد الوارد وفرض إعادة تحميل سلاسل المحادثات.
`moveThreadsToSpam(threads)`	`GmailApp`	نقل سلاسل المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها وفرض إعادة تحميل سلاسل المحادثات
`moveThreadsToTrash(threads)`	`GmailApp`	يؤدي إلى نقل سلاسل المحادثات هذه إلى المهملات وفرض إعادة تحميل سلاسل المحادثات.
`refreshMessage(message)`	`GmailApp`	لإعادة تحميل الرسالة والحالة المرتبطة بها من Gmail (يُعد مفيدًا في حالة تغيير التصنيفات وحالة القراءة وما إلى ذلك).
`refreshMessages(messages)`	`GmailApp`	إعادة تحميل الرسائل والحالة المرتبطة بها من Gmail (مفيدة في حالة تغيير التصنيفات وحالة القراءة وما إلى ذلك)
`refreshThread(thread)`	`GmailApp`	لإعادة تحميل سلسلة المحادثات والحالة المرتبطة بها من Gmail (يُعد مفيدًا في حال تغيير التصنيفات وحالة القراءة وما إلى ذلك).
`refreshThreads(threads)`	`GmailApp`	لإعادة تحميل سلاسل المحادثات والحالة المرتبطة بها من Gmail (يُعد مفيدًا في حالة تغيير التصنيفات وحالة القراءة وما إلى ذلك).
`search(query)`	`GmailThread[]`	ابحث في Gmail باستخدام طلب البحث المحدد.
`search(query, start, max)`	`GmailThread[]`	ابحث في Gmail باستخدام طلب البحث المحدد.
`sendEmail(recipient, subject, body)`	`GmailApp`	إرسال رسالة إلكترونية
`sendEmail(recipient, subject, body, options)`	`GmailApp`	يتم إرسال رسالة إلكترونية تتضمن وسيطات اختيارية.
`setCurrentMessageAccessToken(accessToken)`	`void`	تُحدِّد الرمز المميز للوصول إلى الرسالة الحالية الذي يُفعِّل النص البرمجي للوصول إلى خصائص `GmailMessage` الحالية.
`starMessage(message)`	`GmailApp`	لإضافة نجمة إلى هذه الرسالة، وفرض إعادة تحميل الرسالة.
`starMessages(messages)`	`GmailApp`	تعمل على إضافة نجوم إلى هذه الرسائل وفرض إعادة تحميل الرسائل.
`unstarMessage(message)`	`GmailApp`	إزالة نجمة من هذه الرسالة وفرض إعادة تحميل الرسالة.
`unstarMessages(messages)`	`GmailApp`	إزالة النجوم من هذه الرسائل وفرض إعادة تحميل الرسائل.

الطريقة	نوع الإرجاع	وصف قصير
`getChatThreads()`	`GmailThread[]`	يحصل على جميع سلاسل محادثات Google Hangouts الكلاسيكي وسلاسل محادثات Google Chat حتى تُبدِّل Google جميع مستخدمي تطبيق Hangouts الكلاسيكي إلى Chat في وقت لاحق من هذا العام.
`getChatThreads(start, max)`	`GmailThread[]`	يحصل على مجموعة من سلاسل محادثات Google Hangouts الكلاسيكي وسلاسل محادثات Google Chat حتى تبدِّل Google جميع مستخدمي تطبيق Hangouts الكلاسيكي إلى Chat في وقت لاحق من هذا العام.

`createDraft(recipient, subject, body)`

إنشاء مسوّدة رسالة إلكترونية. حجم الرسالة الإلكترونية (بما في ذلك العناوين) محدود.

// 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());

المعلّمات

الاسم	النوع	الوصف
`recipient`	`String`	قائمة بعناوين البريد الإلكتروني مفصولة بفواصل
`subject`	`String`	موضوع الرسالة الإلكترونية
`body`	`String`	نص الرسالة الإلكترونية

تذكرة ذهاب وعودة

GmailDraft — مسودة Gmail التي تم إنشاؤها حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

createDraft(recipient, subject, body, options)

`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'
});

المعلّمات

الاسم	النوع	الوصف
`recipient`	`String`	عناوين المستلِم
`subject`	`String`	سطر الموضوع
`body`	`String`	نص الرسالة الإلكترونية
`options`	`Object`	عنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

المعلمات المتقدمة

الاسم	النوع	الوصف
`attachments`	`BlobSource[]`	مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
`bcc`	`String`	قائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة مخفية الوجهة
`cc`	`String`	قائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
`from`	`String`	العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها `getAliases()`
`htmlBody`	`String`	في حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل `inlineImages` اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
`inlineImages`	`Object`	عنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (`String`) إلى بيانات الصورة (`BlobSource`)، ويفترض ذلك أنّه يتم استخدام المعلّمة `htmlBody` وتتضمن إشارات إلى هذه الصور بالتنسيق `<img src="cid:imageKey" />`.
`name`	`String`	اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
`replyTo`	`String`	عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)

تذكرة ذهاب وعودة

GmailDraft — مسودة Gmail التي تم إنشاؤها حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

createDraft(recipient, subject, body)

`createLabel(name)`

إنشاء تصنيف مستخدم جديد للاسم المحدد.

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

المعلّمات

الاسم	النوع	الوصف
`name`	`String`	اسم التصنيف الجديد

تذكرة ذهاب وعودة

GmailLabel - التصنيف الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

deleteLabel(label)

`deleteLabel(label)`

حذف التصنيف المحدد.

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

المعلّمات

الاسم	النوع	الوصف
`label`	`GmailLabel`	التصنيف الذي تريد حذفه

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

createLabel(name)

`getAliases()`

يحصل على قائمة برسائل البريد الإلكتروني التي تم إعدادها كأسماء مستعارة لهذا الحساب في 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 ذات الصلة:

https://mail.google.com/

راجع أيضًا

sendEmail(recipient, subject, body, options)

`getDraft(draftId)`

استرداد مسودة رسالة إلكترونية باستخدام رقم التعريف

يمكنك استخدام هذا جنبًا إلى جنب مع 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());

المعلّمات

الاسم	النوع	الوصف
`draftId`	`String`	رقم تعريف المسودة المراد استردادها

تذكرة ذهاب وعودة

GmailDraft — المسودة مع رقم التعريف المحدد

طرح

Error — في حال عدم العثور على مسودة بالمعرّف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getDraftMessages()`

لاسترداد جميع مسودات الرسائل.

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

تذكرة ذهاب وعودة

GmailMessage[] - مصفوفة من رسائل Gmail الاختبارية

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getDrafts()`

الحصول على جميع مسودات الرسائل في Gmail.

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

تذكرة ذهاب وعودة

GmailDraft[]: مصفوفة من رسائل مسودات Gmail

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getInboxThreads()`

لاسترداد جميع سلاسل محادثات البريد الوارد بغض النظر عن التصنيفات.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

// 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 ذات الصلة:

https://mail.google.com/

`getInboxThreads(start, max)`

لاسترداد نطاق من سلاسل محادثات البريد الوارد بغض النظر عن التصنيفات.

// 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());
}

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail في البريد الوارد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getInboxUnreadCount()`

للحصول على عدد سلاسل المحادثات غير المقروءة في البريد الوارد.

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

تذكرة ذهاب وعودة

Integer — عدد سلاسل المحادثات في البريد الوارد التي تتضمن رسائل غير مقروءة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getMessageById(id)`

يتلقّى الرسالة بواسطة رقم التعريف.

يمكنك استخدام هذا جنبًا إلى جنب مع 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());

المعلّمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف الرسالة المطلوب استردادها

تذكرة ذهاب وعودة

GmailMessage — الرسالة التي تتضمن المعرّف المحدد

طرح

Error — في حال عدم العثور على أي رسالة تحمل رقم التعريف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

getThreadById(id)

`getMessagesForThread(thread)`

يمكنك استرداد جميع الرسائل في سلسلة المحادثات المُحدَّدة.

// 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());
}

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة الرسائل المراد استردادها

تذكرة ذهاب وعودة

GmailMessage[]: مصفوفة من الرسائل المقابلة لسلسلة المحادثات هذه

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

getMessagesForThreads(threads)

`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());
  }
}

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	سلاسل الرسائل المراد استردادها

تذكرة ذهاب وعودة

GmailMessage[][] - مصفوفة من مصفوفات الرسائل، حيث يتطابق كل عنصر في المصفوفة الخارجية مع سلسلة محادثات وتحتوي المصفوفة الداخلية على الرسائل في سلسلة المحادثات هذه

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

getMessagesForThread(thread)

`getPriorityInboxThreads()`

لاسترداد جميع سلاسل البريد الوارد ذات الأولوية بغض النظر عن التصنيفات.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

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

تذكرة ذهاب وعودة

GmailThread[]: مصفوفة من سلاسل محادثات Gmail في البريد الوارد المهم

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getPriorityInboxThreads(start, max)`

لاسترداد نطاق من سلاسل محادثات البريد الهام بغض النظر عن التصنيفات.

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

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[]: مصفوفة من سلاسل محادثات Gmail في البريد الوارد المهم

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getPriorityInboxUnreadCount()`

يعرض عدد سلاسل المحادثات غير المقروءة في "البريد الهام".

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

تذكرة ذهاب وعودة

Integer — عدد سلاسل المحادثات في"البريد الهام"التي تحتوي على رسائل غير مقروءة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getSpamThreads()`

لاسترداد جميع سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

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

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail في مجلد الرسائل غير المرغوب فيها

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getSpamThreads(start, max)`

لاسترداد نطاق من سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات.

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

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail في مجلد الرسائل غير المرغوب فيها

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getSpamUnreadCount()`

الحصول على عدد سلاسل المحادثات غير المقروءة.

// 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 ذات الصلة:

https://mail.google.com/

`getStarredThreads()`

لاسترداد جميع سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

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

تذكرة ذهاب وعودة

GmailThread[]: مصفوفة من سلاسل محادثات Gmail المميّزة بنجمة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getStarredThreads(start, max)`

لاسترداد نطاق من سلاسل المحادثات المميزة بنجمة بغض النظر عن التصنيفات.

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

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[]: مصفوفة من سلاسل محادثات Gmail المميّزة بنجمة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getStarredUnreadCount()`

لعرض عدد سلاسل المحادثات غير المقروءة التي تم تمييزها بنجمة.

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

تذكرة ذهاب وعودة

Integer - عدد سلاسل المحادثات المميّزة بنجمة التي تحتوي على رسائل غير مقروءة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getThreadById(id)`

الحصول على سلسلة محادثات حسب رقم التعريف.

يمكنك استخدام هذا جنبًا إلى جنب مع getId() في سلاسل محادثات Gmail.

// Thread IDs can also be found in the location bar when you have a thread open in Gmail
// get first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
// Get the same thread by ID
var threadById = GmailApp.getThreadById(firstThread.getId());
// Verify they are the same
Logger.log(firstThread.getFirstMessageSubject() == threadById.getFirstMessageSubject());

المعلّمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف سلسلة المحادثات لاستردادها

تذكرة ذهاب وعودة

GmailThread - سلسلة المحادثات التي لها رقم التعريف المحدد أو قيمة فارغة في حال عدم العثور عليها

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

getMessageById(id)

`getTrashThreads()`

لاسترداد جميع سلاسل محادثات المهملات بغض النظر عن التصنيفات.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

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

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail في المهملات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getTrashThreads(start, max)`

لاسترداد نطاق من سلاسل المحادثات للمهملات بغض النظر عن التصنيفات.

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

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail في المهملات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getUserLabelByName(name)`

استرداد تصنيف نظرًا لاسم التصنيف.

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

المعلّمات

الاسم	النوع	الوصف
`name`	`String`	اسم التصنيف لاسترداده

تذكرة ذهاب وعودة

GmailLabel - تصنيف Gmail بالاسم المحدَّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getUserLabels()`

لاسترداد قائمة التصنيفات التي أنشأها المستخدم.

// 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 ذات الصلة:

https://mail.google.com/

`markMessageRead(message)`

وضع علامة على هذه الرسالة كمقروءة وفرض إعادة تحميلها.

// 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);

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة التي يجب وضع علامة "مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markMessageUnread(message)

`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);

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة لوضع علامة "غير مقروءة"

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markMessageRead(message)

`markMessagesRead(messages)`

وضع علامة على هذه الرسائل للقراءة وفرض إعادة تحميل الرسائل.

// 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());

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	مصفوفة من الرسائل لوضع علامة "مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markMessagesUnread(messages)

`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());

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	مصفوفة من الرسائل لوضع علامة "غير مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markMessagesRead(messages)

`markThreadImportant(thread)`

وضع علامة على سلسلة المحادثات هذه باعتبارها مهمة وتفرض إعادة تحميل سلسلة المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي يجب وضع علامة عليها كمهمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadUnimportant(thread)

`markThreadRead(thread)`

وضع علامة على سلسلة المحادثات هذه كمقروءة وفرض إعادة تحميل سلسلة المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي يجب وضع علامة "مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadUnread(thread)

`markThreadUnimportant(thread)`

وضع علامة على سلسلة المحادثات هذه على أنها غير مهمة وفرض إعادة تحميل سلسلة المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي يجب وضع علامة "غير مهمة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadImportant(thread)

`markThreadUnread(thread)`

وضع علامة على سلسلة المحادثات هذه كغير مقروءة وفرض إعادة تحميل سلسلة المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي تريد وضع علامة "غير مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadRead(thread)

`markThreadsImportant(threads)`

وضع علامة على سلاسل المحادثات هذه كرسائل مهمة وفرض إعادة تحميل سلاسل المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات لوضع علامة عليها كمهمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadsUnimportant(threads)

`markThreadsRead(threads)`

وضع علامة على سلاسل المحادثات هذه كمقروءة وفرض إعادة تحميل سلاسل المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات لوضع علامة "مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadsUnread(threads)

`markThreadsUnimportant(threads)`

وضع علامة "غير مهمّة" على سلاسل المحادثات هذه وفرض إعادة تحميل سلاسل المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات لوضع علامة عليها باعتبارها غير مهمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadsImportant(threads)

`markThreadsUnread(threads)`

وضع علامة "غير مقروءة" على سلاسل المحادثات هذه وفرض إعادة تحميل سلاسل المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات لوضع علامة "غير مقروءة" عليها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

markThreadsRead(threads)

`moveMessageToTrash(message)`

نقل الرسالة إلى المهملات وفرض إعادة تحميل الرسالة

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

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة التي سيتم نقلها إلى المهملات

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail (مفيدة للسلاسل)

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

moveMessagesToTrash(messages)

`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);

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	الرسائل التي سيتم نقلها إلى المهملات

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail (مفيدة للسلاسل)

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

moveMessageToTrash(message)

`moveThreadToArchive(thread)`

تنقل سلسلة المحادثات هذه إلى الأرشيف وتفرض إعادة تحميل سلسلة المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي سيتم وضعها في الأرشيف

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`moveThreadToInbox(thread)`

لنقل سلسلة المحادثات هذه إلى البريد الوارد وفرض إعادة تحميل سلسلة المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي سيتم نقلها إلى البريد الوارد

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadToSpam(thread)`

نقل سلسلة المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها وفرض إعادة تحميل سلسلة المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي سيتم نقلها إلى مجلد الرسائل غير المرغوب فيها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadToTrash(thread)`

ينقل سلسلة المحادثات هذه إلى المهملات وفرض إعادة تحميل سلسلة المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات التي سيتم نقلها إلى المهملات

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadsToArchive(threads)`

يؤدي إلى نقل سلاسل المحادثات هذه إلى الأرشيف وفرض إعادة تحميل سلاسل المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات التي ستتم أرشفتها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadsToInbox(threads)`

يؤدي إلى نقل سلاسل المحادثات هذه إلى البريد الوارد وفرض إعادة تحميل سلاسل المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات التي سيتم نقلها إلى البريد الوارد

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadsToSpam(threads)`

نقل سلاسل المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها وفرض إعادة تحميل سلاسل المحادثات

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات التي سيتم نقلها إلى مجلد الرسائل غير المرغوب فيها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`moveThreadsToTrash(threads)`

يؤدي إلى نقل سلاسل المحادثات هذه إلى المهملات وفرض إعادة تحميل سلاسل المحادثات.

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

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	مصفوفة من سلاسل المحادثات التي سيتم نقلها إلى المهملات

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

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

`refreshMessage(message)`

لإعادة تحميل الرسالة والحالة المرتبطة بها من 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...

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة المطلوب إعادة تحميلها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

refreshMessages(messages)

`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...

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	الرسائل المطلوب إعادة تحميلها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

refreshMessage(message)

`refreshThread(thread)`

لإعادة تحميل سلسلة المحادثات والحالة المرتبطة بها من 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 ...

المعلّمات

الاسم	النوع	الوصف
`thread`	`GmailThread`	سلسلة المحادثات المطلوب إعادة تحميلها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

refreshThreads(threads)

`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 ...

المعلّمات

الاسم	النوع	الوصف
`threads`	`GmailThread[]`	سلاسل المحادثات التي ستتم إعادة تحميلها

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

refreshThread(thread)

`search(query)`

ابحث في Gmail باستخدام طلب البحث المحدد.

ستتعذّر هذه المكالمة عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام 'paged'call وتحديد نطاقات سلاسل المحادثات لاستردادها في كل مكالمة.

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

المعلّمات

الاسم	النوع	الوصف
`query`	`String`	طلب البحث، تمامًا كما تكتبه في Gmail

تذكرة ذهاب وعودة

GmailThread[] — مصفوفة من سلاسل محادثات Gmail تتطابق مع طلب البحث هذا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`search(query, start, max)`

ابحث في Gmail باستخدام طلب البحث المحدد.

// 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);

المعلّمات

الاسم	النوع	الوصف
`query`	`String`	طلب البحث، تمامًا كما تكتبه في Gmail
`start`	`Integer`	فهرس سلسلة المحادثات الأولى
`max`	`Integer`	الحدّ الأقصى لعدد سلاسل المحادثات التي يمكن عرضها

تذكرة ذهاب وعودة

GmailThread[] — مصفوفة من سلاسل محادثات Gmail تتطابق مع طلب البحث هذا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`sendEmail(recipient, subject, body)`

إرسال رسالة إلكترونية حجم الرسالة الإلكترونية (بما في ذلك العناوين) محدود.

// 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());

المعلّمات

الاسم	النوع	الوصف
`recipient`	`String`	قائمة بعناوين البريد الإلكتروني مفصولة بفواصل
`subject`	`String`	موضوع الرسالة الإلكترونية (250 حرفًا كحدٍ أقصى)
`body`	`String`	نص الرسالة الإلكترونية

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

sendEmail(recipient, subject, body, options)

`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'
});

المعلّمات

الاسم	النوع	الوصف
`recipient`	`String`	عناوين المستلِم
`subject`	`String`	سطر الموضوع (250 حرفًا كحد أقصى)
`body`	`String`	نص الرسالة الإلكترونية
`options`	`Object`	عنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

المعلمات المتقدمة

الاسم	النوع	الوصف
`attachments`	`BlobSource[]`	مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
`bcc`	`String`	قائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة مخفية الوجهة
`cc`	`String`	قائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
`from`	`String`	العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها `getAliases()`
`htmlBody`	`String`	في حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل `inlineImages` اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
`inlineImages`	`Object`	عنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (`String`) إلى بيانات الصورة (`BlobSource`)، ويفترض ذلك أنّه يتم استخدام المعلّمة `htmlBody` وتتضمن إشارات إلى هذه الصور بالتنسيق `<img src="cid:imageKey" />`.
`name`	`String`	اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
`noReply`	`Boolean`	`true` إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام بلا رد لمنع العملاء من الرد على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace، وليس لمستخدمي Gmail
`replyTo`	`String`	عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

sendEmail(recipient, subject, body)

`setCurrentMessageAccessToken(accessToken)`

تُحدِّد الرمز المميز للوصول إلى الرسالة الحالية الذي يُفعِّل النص البرمجي للوصول إلى خصائص 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
}

المعلّمات

الاسم	النوع	الوصف
`accessToken`	`String`	رمز الدخول المؤقت الذي تم الحصول عليه من كائن حدث الإجراء لإضافة Gmail.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`starMessage(message)`

لإضافة نجمة إلى هذه الرسالة، وفرض إعادة تحميل الرسالة.

// 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);

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة للتمييز بنجمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

starMessages(messages)

`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);

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	مصفوفة من الرسائل بنجمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

starMessage(message)

`unstarMessage(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);

المعلّمات

الاسم	النوع	الوصف
`message`	`GmailMessage`	الرسالة لإلغاء التمييز بنجمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

unstarMessages(messages)

`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);

المعلّمات

الاسم	النوع	الوصف
`messages`	`GmailMessage[]`	مصفوفة من الرسائل لإلغاء التمييز بنجمة

تذكرة ذهاب وعودة

GmailApp - خدمة Gmail، مفيدة للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

راجع أيضًا

unstarMessage(message)

`getChatThreads()`

متوقف. تم إيقاف هذه الدالة ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يحصل على جميع سلاسل محادثات Google Hangouts الكلاسيكي وسلاسل محادثات Google Chat حتى تُبدِّل Google جميع مستخدمي تطبيق Hangouts الكلاسيكي إلى Chat في وقت لاحق من هذا العام. لمزيد من المعلومات، راجِع مزيد من المعلومات عن التبديل من تطبيق Hangouts الكلاسيكي إلى Google Chat.

يتعذّر تنفيذ هذه المكالمة عند كبر حجم سلاسل المحادثات بحيث لا يمكن للنظام معالجتها. عندما يكون حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، استخدِم 'paged'call، وحدِّد نطاقات سلاسل المحادثات التي تريد استردادها في كل مكالمة.

var threads = GmailApp.getChatThreads();
Logger.log("# of chat threads: " + threads.length);

تذكرة ذهاب وعودة

GmailThread[]: مصفوفة من سلاسل محادثات المحادثة من Gmail.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getChatThreads(start, max)`

متوقف. تم إيقاف هذه الدالة ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يحصل على مجموعة من سلاسل محادثات Google Hangouts الكلاسيكي وسلاسل محادثات Google Chat حتى تبدِّل Google جميع مستخدمي تطبيق Hangouts الكلاسيكي إلى Chat في وقت لاحق من هذا العام. لمزيد من المعلومات، راجِع مزيد من المعلومات عن التبديل من تطبيق Hangouts الكلاسيكي إلى Google Chat.

// Get first 50 chat threads
var threads = GmailApp.getChatThreads(0,50);
// Will log no more than 50.0
Logger.log(threads.length);
Logger.log(threads[0].getFirstMessageSubject());

المعلّمات

الاسم	النوع	الوصف
`start`	`Integer`	فهرس سلسلة المحادثات الأولى لاستردادها.
`max`	`Integer`	الحد الأقصى لعدد سلاسل المحادثات التي يمكن استردادها

تذكرة ذهاب وعودة

GmailThread[] - مصفوفة من سلاسل محادثات Gmail

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

الطُرق

الطرق التي تم إيقافها نهائيًا

المستندات التفصيلية

createDraft(recipient, subject, body)

المعلّمات

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

createDraft(recipient, subject, body, options)

المعلّمات

المعلمات المتقدمة

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

createLabel(name)

المعلّمات

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

deleteLabel(label)

المعلّمات

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

getAliases()

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

getDraft(draftId)

المعلّمات

تذكرة ذهاب وعودة

طرح

التفويض

getDraftMessages()

تذكرة ذهاب وعودة

التفويض

getDrafts()

تذكرة ذهاب وعودة

التفويض

getInboxThreads()

تذكرة ذهاب وعودة

التفويض

getInboxThreads(start, max)

المعلّمات

تذكرة ذهاب وعودة

التفويض

getInboxUnreadCount()

تذكرة ذهاب وعودة

التفويض

getMessageById(id)

المعلّمات

تذكرة ذهاب وعودة

طرح

التفويض

راجع أيضًا

getMessagesForThread(thread)

المعلّمات

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

getMessagesForThreads(threads)

المعلّمات

تذكرة ذهاب وعودة

التفويض

راجع أيضًا

getPriorityInboxThreads()

تذكرة ذهاب وعودة

التفويض

getPriorityInboxThreads(start, max)

المعلّمات

تذكرة ذهاب وعودة

التفويض

getPriorityInboxUnreadCount()

تذكرة ذهاب وعودة

التفويض

getSpamThreads()

تذكرة ذهاب وعودة

التفويض

getSpamThreads(start, max)

`createDraft(recipient, subject, body)`

`createDraft(recipient, subject, body, options)`

`createLabel(name)`

`deleteLabel(label)`

`getAliases()`

`getDraft(draftId)`

`getDraftMessages()`

`getDrafts()`

`getInboxThreads()`

`getInboxThreads(start, max)`

`getInboxUnreadCount()`

`getMessageById(id)`

`getMessagesForThread(thread)`

`getMessagesForThreads(threads)`

`getPriorityInboxThreads()`

`getPriorityInboxThreads(start, max)`

`getPriorityInboxUnreadCount()`

`getSpamThreads()`

`getSpamThreads(start, max)`

`getSpamUnreadCount()`

`getStarredThreads()`

`getStarredThreads(start, max)`

`getStarredUnreadCount()`

`getThreadById(id)`

`getTrashThreads()`

`getTrashThreads(start, max)`

`getUserLabelByName(name)`

`getUserLabels()`

`markMessageRead(message)`

`markMessageUnread(message)`

`markMessagesRead(messages)`

`markMessagesUnread(messages)`

`markThreadImportant(thread)`

`markThreadRead(thread)`

`markThreadUnimportant(thread)`