Class GmailThread

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

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

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
addLabel(label)	GmailThread	تُضيف هذه العلامة إلى سلسلة المحادثات.
createDraftReply(body)	GmailDraft	لإنشاء مسودة رسالة للردّ على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان الردّ.
createDraftReply(body, options)	GmailDraft	لإنشاء مسودة رسالة للردّ على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان reply-to، مع وسيطات اختيارية
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	تعرِض هذه الدالة القيمة true إذا كانت سلسلة المحادثات هذه في البريد الوارد ذو الأولوية، وتعرِض القيمة false في غير ذلك.
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	يمكنك الردّ على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان replyTo.
reply(body, options)	GmailThread	يمكنك الردّ على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان replyTo مع تحديد دلايلات اختيارية.
replyAll(body)	GmailThread	يمكنك الردّ على المُرسِل (باستخدام عنوان replyTo) وجميع مستلِمي الرسالة الأخيرة في هذه سلسلة المحادثات.
replyAll(body, options)	GmailThread	الردّ على المُرسِل (باستخدام عنوان replyTo) وجميع مستلِمي الرسالة الأخيرة في سلسلة المحادثات هذه، مع إدراج وسيطات اختيارية

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

addLabel(label)

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

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

المعلمات

الاسم	النوع	الوصف
label	GmailLabel	التصنيف المطلوب تطبيقه على هذه السلسلة من الرسائل

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• removeLabel(label)

---

createDraftReply(body)

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

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

المعلمات

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

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

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

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

المعلمات

الاسم	النوع	الوصف
body	String	نص الرسالة الإلكترونية
options	Object	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

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

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

المعلمات

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

المعلمات

الاسم	النوع	الوصف
body	String	نص الرسالة الإلكترونية
options	Object	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

getFirstMessageSubject()

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

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• getLastMessageDate()

---

getId()

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

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• getFirstMessageSubject()

---

getMessageCount()

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

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• getMessages()

---

getMessages()

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

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

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• getMessageCount()

---

getPermalink()

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

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

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

الإرجاع

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

---

hasStarredMessages()

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

// Log if this thread has starred messages
const 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
const 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
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

isInPriorityInbox()

تعرِض هذه الدالة القيمة true إذا كانت سلسلة المحادثات هذه في البريد الوارد ذو الأولوية، وتعرِض القيمة false في غير ذلك.

// Log if this thread is in the priority inbox
const 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
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

isUnread()

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

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

الإرجاع

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

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

markImportant()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• markUnimportant()

---

markRead()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• markUnread()

---

markUnimportant()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• markImportant()

---

markUnread()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• markRead()

---

moveToArchive()

نقل هذه السلسلة من الرسائل إلى الأرشيف

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

moveToInbox()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

moveToSpam()

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

moveToTrash()

نقل هذه السلسلة من الرسائل إلى المهملات

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

---

refresh()

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

const 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)

تؤدي هذه الخطوة إلى إزالة هذا التصنيف من سلسلة المحادثات.

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

المعلمات

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• addLabel(label)

---

reply(body)

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

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

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

المعلمات

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

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

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

المعلمات

الاسم	النوع	الوصف
body	String	نص الرسالة الإلكترونية
options	Object	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

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

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

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

المعلمات

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body, options)
• reply(body)
• replyAll(body, options)

---

replyAll(body, options)

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

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

المعلمات

الاسم	النوع	الوصف
body	String	نص الرسالة الإلكترونية
options	Object	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

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

الإرجاع

GmailThread - سلسلة المحادثات هذه، وهي مفيدة لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• reply(body)
• replyAll(body)
• replyAll(body, options)