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	الردّ على مرسل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان 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 API ذات الصلة:

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

• https://mail.google.com/

انظر أيضًا

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

---

createDraftReply(body, options)

تنشئ هذه الطريقة مسودة رسالة للرد على مرسل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية.

يمكن أن تحتوي الرسالة الإلكترونية على نص عادي ونص 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 هذا الحقل بدلاً من وسيطة النص الأساسي المطلوبة. يمكنك إضافة حقل inlineImages اختياري في النص الأساسي لـ HTML إذا كانت لديك صور مضمّنة في رسالتك الإلكترونية.
inlineImages	Object	كائن JavaScript يحتوي على ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، وهذا يفترض أنّه يتم استخدام المَعلمة htmlBody وأنّها تحتوي على مراجع إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
name	String	اسم مرسل الرسالة الإلكترونية (القيمة التلقائية: اسم المستخدم)
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان الردّ التلقائي (القيمة التلقائية: عنوان البريد الإلكتروني للمستخدم)
subject	String	سطر موضوع جديد للرسالة الإلكترونية (250 حرفًا كحدّ أقصى)

الإرجاع

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

التفويض

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

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

• 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 هذا الحقل بدلاً من وسيطة النص الأساسي المطلوبة. يمكنك إضافة حقل inlineImages اختياري في النص الأساسي لـ HTML إذا كانت لديك صور مضمّنة في رسالتك الإلكترونية.
inlineImages	Object	كائن JavaScript يحتوي على ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، وهذا يفترض أنّه يتم استخدام المَعلمة htmlBody وأنّها تحتوي على مراجع إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
name	String	اسم مرسل الرسالة الإلكترونية (القيمة التلقائية: اسم المستخدم)
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان الردّ التلقائي (القيمة التلقائية: عنوان البريد الإلكتروني للمستخدم)
subject	String	سطر موضوع جديد للرسالة الإلكترونية الحد الأقصى للحجم هو 250 حرفًا.

الإرجاع

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

التفويض

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

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

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

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

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

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

• https://mail.google.com/

انظر أيضًا

• getMessageCount()

---

getPermalink()

تعرض هذه الطريقة رابطًا ثابتًا لسلسلة المحادثات هذه.

يُرجى العلم أنّ هذه الطريقة تعمل فقط مع واجهة Gmail الكلاسيكية، وليس مع Inbox.

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

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

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

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

• https://mail.google.com/

---

isInPriorityInbox()

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

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

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

• 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: true إذا كانت سلسلة المحادثات في المهملات

التفويض

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

• https://mail.google.com/

---

isUnread()

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

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

الإرجاع

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

التفويض

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

• https://mail.google.com/

---

markImportant()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markUnimportant()

---

markRead()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markUnread()

---

markUnimportant()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markImportant()

---

markUnread()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markRead()

---

moveToArchive()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

---

moveToInbox()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

---

moveToSpam()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

• https://mail.google.com/

---

moveToTrash()

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

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

الإرجاع

‫GmailThread: سلسلة المحادثات هذه، وهي مفيدة لربط المحادثات

التفويض

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

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

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

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

• 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 هذا الحقل بدلاً من وسيطة النص الأساسي المطلوبة. يمكنك إضافة حقل inlineImages اختياري في النص الأساسي لـ HTML إذا كانت لديك صور مضمّنة في رسالتك الإلكترونية.
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 API ذات الصلة:

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

• 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 هذا الحقل بدلاً من وسيطة النص الأساسي المطلوبة. يمكنك إضافة حقل inlineImages اختياري في النص الأساسي لـ HTML إذا كانت لديك صور مضمّنة في رسالتك الإلكترونية.
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 API ذات الصلة:

• https://mail.google.com/

انظر أيضًا

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