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	عرض القيمة "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الإلكتروني ذي الأولوية وتقوم بإرجاع 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
var label = GmailApp.getUserLabelByName("MyLabel");
var 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.
var 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)

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

يمكن أن تحتوي الرسالة الإلكترونية على نص عادي ونص 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: "[e-mail]"
});

المعلمات

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

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

الاسم	النوع	الوصف
attachments	BlobSource[]	CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
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 ذات الصلة:

• 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.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var 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.
var 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[]	CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
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 ذات الصلة:

• 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
var 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.
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/

انظر أيضًا

• getFirstMessageSubject()

---

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

---

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/

انظر أيضًا

• getMessageCount()

---

getPermalink()

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

تجدر الإشارة إلى أنّ هذا الإجراء لا يعمل إلا مع واجهة 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()

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

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

انظر أيضًا

• markUnimportant()

---

markRead()

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

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

الإرجاع

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

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markUnread()

---

markUnimportant()

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

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

الإرجاع

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

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markImportant()

---

markUnread()

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

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

الإرجاع

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

التفويض

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

• https://mail.google.com/

انظر أيضًا

• markRead()

---

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

المعلمات

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

الإرجاع

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

التفويض

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

• https://mail.google.com/

انظر أيضًا

• addLabel(label)

---

reply(body)

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

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

// Respond to author of last email in thread with acknowledgment
var 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.
var 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[]	CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
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
var 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.
var 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[]	CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
inlineImages	Object	كائن JavaScript يحتوي على ربط من مفتاح صورة (String) إلى بيانات الصورة (BlobSource) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />

الإرجاع

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

التفويض

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

• https://mail.google.com/

انظر أيضًا

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