Class GmailThread

GmailThread

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
addLabel(label)GmailThreadلإضافة هذا التصنيف إلى سلسلة المحادثات
createDraftReply(body)GmailDraftتنشئ مسودة رسالة للرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان الرد.
createDraftReply(body, options)GmailDraftإنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية.
createDraftReplyAll(body)GmailDraftتنشئ مسودة رسالة للرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع مستلمي هذه الرسالة.
createDraftReplyAll(body, options)GmailDraftإنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع المستلمين، مع الوسيطات الاختيارية.
getFirstMessageSubject()Stringيحصل على موضوع الرسالة الأولى في سلسلة المحادثات.
getId()Stringيحصل على رقم تعريف سلسلة المحادثات هذه.
getLabels()GmailLabel[]عرض التصنيفات التي أنشأها المستخدم في سلسلة المحادثات هذه.
getLastMessageDate()Dateيحصل على تاريخ أحدث رسالة سلسلة المحادثات هذه.
getMessageCount()Integerلعرض عدد الرسائل في سلسلة المحادثات.
getMessages()GmailMessage[]يحصل على الرسائل في سلسلة المحادثات هذه.
getPermalink()Stringيحصل على رابط ثابت لسلسلة المحادثات هذه.
hasStarredMessages()Booleanعرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل مميّزة بنجمة.
isImportant()Booleanعرض ما إذا تم وضع علامة على سلسلة المحادثات كمهمة.
isInChats()Booleanعرض ما إذا كانت سلسلة المحادثات مصنّفة كمحادثة.
isInInbox()Booleanعرض ما إذا كانت سلسلة المحادثات في البريد الوارد.
isInPriorityInbox()Booleanعرض "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الوارد ذي الأولوية، بينما تعرض "خطأ" بخلاف ذلك.
isInSpam()Booleanعرض ما إذا تم وضع علامة على سلسلة المحادثات كرسائل غير مرغوب فيها.
isInTrash()Booleanعرض ما إذا كانت سلسلة المحادثات في المهملات.
isUnread()Booleanعرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل غير مقروءة.
markImportant()GmailThreadوضع علامة على سلسلة المحادثات هذه باعتبارها مهمة.
markRead()GmailThreadوضع علامة "مقروءة" على سلسلة المحادثات هذه
markUnimportant()GmailThreadوضع علامة على سلسلة المحادثات هذه باعتبارها غير مهمة.
markUnread()GmailThreadوضع علامة "غير مقروءة" على سلسلة المحادثات هذه
moveToArchive()GmailThreadتنقل سلسلة المحادثات هذه إلى الأرشيف.
moveToInbox()GmailThreadتنقل سلسلة المحادثات هذه إلى البريد الوارد.
moveToSpam()GmailThreadنقل سلسلة المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها
moveToTrash()GmailThreadينقل سلسلة المحادثات هذه إلى المهملات
refresh()GmailThreadلإعادة تحميل سلسلة المحادثات هذه والحالة المرتبطة بها من Gmail (يُعد ذلك مفيدًا في حال تغيير التصنيفات وحالة القراءة وما إلى ذلك).
removeLabel(label)GmailThreadلإزالة هذا التصنيف من سلسلة المحادثات
reply(body)GmailThreadالرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo.
reply(body, options)GmailThreadيمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo، مع الوسيطات الاختيارية.
replyAll(body)GmailThreadالردّ على المُرسِل (باستخدام العنوان "الردّ") وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه
replyAll(body, options)GmailThreadيمكنك الرد على المُرسِل (باستخدام العنوان replyTo) وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام وسيطات اختيارية.

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

addLabel(label)

لإضافة هذا التصنيف إلى سلسلة المحادثات

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

المعلّمات

الاسمالنوعالوصف
labelGmailLabelالتصنيف الذي سيتم تطبيقه على سلسلة المحادثات هذه

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


createDraftReply(body)

تنشئ مسودة رسالة للرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان الرد. حجم الرسالة الإلكترونية (بما في ذلك العناوين) محدود.

// Create a draft reply to the message author with an acknowledgement.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("Got your message");

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

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

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

التفويض

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

  • https://mail.google.com/

راجع أيضًا


createDraftReply(body, options)

إنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية.

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

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectعنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
bccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة مخفية الوجهة
ccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
fromStringالعنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases()
htmlBodyStringفي حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
inlineImagesObjectعنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، ويفترض ذلك أنّه يتم استخدام المعلّمة htmlBody وتتضمن إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />.
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)
subjectStringسطر موضوع جديد للرسالة الإلكترونية (250 حرفًا كحد أقصى)

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

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

التفويض

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

  • https://mail.google.com/

راجع أيضًا


createDraftReplyAll(body)

تنشئ مسودة رسالة للرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع مستلمي هذه الرسالة. يكون حجم الرسالة الإلكترونية (بما في ذلك العناوين) محدودًا.

// Create a draft reply to all recipients (except those bcc'd) of the last email in this
// thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

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

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

التفويض

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

  • https://mail.google.com/

راجع أيضًا


createDraftReplyAll(body, options)

إنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع المستلمين، مع الوسيطات الاختيارية.

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

// Create a draft reply, using an HTML text body, to all recipients (except those bcc'd) of
// the last email of in this thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectعنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
bccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة مخفية الوجهة
ccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
fromStringالعنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases()
htmlBodyStringفي حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
inlineImagesObjectعنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، ويفترض ذلك أنّه يتم استخدام المعلّمة htmlBody وتتضمن إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />.
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)
subjectStringسطر موضوع جديد للرسالة الإلكترونية. الحد الأقصى للحجم هو 250 حرفًا.

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

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

التفويض

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

  • https://mail.google.com/

راجع أيضًا


getFirstMessageSubject()

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

// Log the subject of the first message in the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getFirstMessageSubject());

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

String — موضوع الرسالة الأولى في سلسلة المحادثات

التفويض

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

  • https://mail.google.com/

راجع أيضًا


getId()

يحصل على رقم تعريف سلسلة المحادثات هذه. يختلف رقم تعريف سلسلة المحادثات حسب الرسائل التي تحتوي عليها. وبالنسبة إلى رقم التعريف الثابت لرسالة معيّنة في سلسلة المحادثات، يمكنك استدعاء الرقم getMessages()[0].getId() بدلاً من ذلك.

// Log the subject of the first message in the first thread in the inbox.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var id = firstThread.getId();
// Get same thread by its ID.
var thread = GmailApp.getThreadById(id);
Logger.log(thread.getFirstMessageSubject() == firstThread.getFirstMessageSubject()); // True

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

String - رقم تعريف سلسلة المحادثات هذه


getLabels()

عرض التصنيفات التي أنشأها المستخدم في سلسلة المحادثات هذه.

// Log the names of the labels attached to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var labels = firstThread.getLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

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

GmailLabel[] — مصفوفة من سلسلة المحادثات هذه

التفويض

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

  • https://mail.google.com/

getLastMessageDate()

يحصل على تاريخ أحدث رسالة سلسلة المحادثات هذه.

// Log the date of the most recent message on the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getLastMessageDate());

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

Date - تاريخ آخر رسالة في سلسلة المحادثات

التفويض

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

  • https://mail.google.com/

راجع أيضًا


getMessageCount()

لعرض عدد الرسائل في سلسلة المحادثات.

// Log the number of messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getMessageCount());

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

Integer — عدد الرسائل في سلسلة المحادثات

التفويض

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

  • https://mail.google.com/

راجع أيضًا


getMessages()

يحصل على الرسائل في سلسلة المحادثات هذه.

// Log the subjects of the messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
for (var i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

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

GmailMessage[] - مصفوفة من رسائل Gmail في سلسلة المحادثات هذه

التفويض

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

  • https://mail.google.com/

راجع أيضًا


يحصل على رابط ثابت لسلسلة المحادثات هذه.

لاحظ أن هذا الإجراء لا يعمل إلا مع واجهة Gmail الكلاسيكية، وليس مع البريد الوارد.

// Logs the permalink for the first thread in the inbox
var thread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(thread.getPermalink());

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

String — الرابط الثابت لسلسلة المحادثات هذه


hasStarredMessages()

عرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل مميّزة بنجمة.

// Log if this thread has starred messages
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('has starred : ' + firstThread.hasStarredMessages());

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

Boolean - صحيح إذا كانت سلسلة المحادثات تحتوي على أي رسائل مميّزة بنجمة

التفويض

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

  • https://mail.google.com/

isImportant()

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

// Log if this thread is marked as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

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

Boolean — تحديد ما إذا كانت سلسلة المحادثات مهمة.

التفويض

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

  • https://mail.google.com/

isInChats()

عرض ما إذا كانت سلسلة المحادثات مصنّفة كمحادثة.

// Log if this thread is a chat
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in chats? : ' + firstThread.isInChats());

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

Boolean - صحيح إذا تم تصنيف سلسلة المحادثات كمحادثة

التفويض

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

  • https://mail.google.com/

isInInbox()

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

// Log if this thread is in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

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

Boolean - صحيح إذا كانت سلسلة المحادثات في البريد الوارد

التفويض

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

  • https://mail.google.com/

isInPriorityInbox()

عرض "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الوارد ذي الأولوية، بينما تعرض "خطأ" بخلاف ذلك.

// Log if this thread is in the priority inbox
var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0];
Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());

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

Boolean - صحيح إذا كانت سلسلة المحادثات في البريد الوارد ذي الأولوية

التفويض

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

  • https://mail.google.com/

isInSpam()

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

// Log if this thread is in the spam folder
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Spam? ' + firstThread.isInSpam());

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

Boolean: تحديد ما إذا كانت سلسلة المحادثات هذه تم وضع علامة عليها كغير مرغوب فيها.

التفويض

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

  • https://mail.google.com/

isInTrash()

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

// Log if this thread is in the trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

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

Boolean - صحيح إذا كانت سلسلة المحادثات في المهملات

التفويض

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

  • https://mail.google.com/

isUnread()

عرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل غير مقروءة.

// Log if this thread is unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

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

Boolean - صحيح إذا كانت هناك رسائل غير مقروءة

التفويض

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

  • https://mail.google.com/

markImportant()

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

// Mark first inbox thread as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markImportant();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


markRead()

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

// Mark first inbox thread as read
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markRead();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


markUnimportant()

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

// Mark first inbox thread as unimportant
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnimportant();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


markUnread()

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

// Mark first inbox thread as unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnread();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


moveToArchive()

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

// Archive first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.moveToArchive();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

moveToInbox()

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

// Move first non-inbox thread to inbox
var firstThread = GmailApp.search("-in:inbox")[0];
firstThread.moveToInbox();

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

moveToSpam()

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

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

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

moveToTrash()

ينقل سلسلة المحادثات هذه إلى المهملات

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

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

refresh()

لإعادة تحميل سلسلة المحادثات هذه والحالة المرتبطة بها من Gmail (يُعد ذلك مفيدًا في حال تغيير التصنيفات وحالة القراءة وما إلى ذلك).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
firstThread.refresh(); // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

removeLabel(label)

لإزالة هذا التصنيف من سلسلة المحادثات

var myLabel = GmailApp.getUserLabelByName('<your label>');
var threads = myLabel.getThreads();
for (var x in threads) {
  var thread = threads[x];
  thread.removeLabel(myLabel);
}

المعلّمات

الاسمالنوعالوصف
labelGmailLabelالتصنيف المطلوب إزالته من سلسلة المحادثات هذه

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


reply(body)

الرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo.

تجدر الإشارة إلى أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين) قد لا يتجاوز 20 كيلوبايت.

// Respond to author of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("Got your message");

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


reply(body, options)

يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo، مع الوسيطات الاختيارية. وتتضمّن الرسالة الإلكترونية نصًا عاديًا، بالإضافة إلى نص HTML. تجدر الإشارة إلى أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين، باستثناء المرفقات) قد لا يتجاوز 20 كيلوبايت.

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectعنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
ccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
bccStringقائمة بعناوين البريد الإلكتروني المفصولة بفواصل في سطر "نسخة مخفية الوجهة"
htmlBodyStringفي حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
fromStringالعنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases()
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام بلا رد لمنع العملاء من الرد على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace، وليس لمستخدمي Gmail
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
inlineImagesObjectعنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، ويفترض ذلك أنّه يتم استخدام المعلّمة htmlBody وتتضمن إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />.

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


replyAll(body)

الردّ على المُرسِل (باستخدام العنوان "الردّ") وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه

تجدر الإشارة إلى أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين) قد لا يتجاوز 20 كيلوبايت.

// Respond to all with acknowledgment to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("Got your message");

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا


replyAll(body, options)

يمكنك الرد على المُرسِل (باستخدام العنوان replyTo) وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام وسيطات اختيارية. وتتضمّن الرسالة الإلكترونية نصًا عاديًا، بالإضافة إلى نص HTML. تجدر الإشارة إلى أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين، باستثناء المرفقات) لا يتجاوز 20 كيلوبايت.

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

المعلّمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectعنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
ccStringقائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة
bccStringقائمة بعناوين البريد الإلكتروني المفصولة بفواصل في سطر "نسخة مخفية الوجهة"
htmlBodyStringفي حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني.
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's)
fromStringالعنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases()
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's)
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام لا يتلقّى ردًا لمنع العملاء من الردّ على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات G Suite، وليس لمستخدمي Gmail
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية
inlineImagesObjectعنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، ويفترض ذلك أنّه يتم استخدام المعلّمة htmlBody وتتضمن إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />.

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

GmailThread: سلسلة المحادثات هذه مفيدة للسلسلة

التفويض

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

  • https://mail.google.com/

راجع أيضًا