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	يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد على".
reply(body, options)	GmailThread	يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد إلى" مع إدراج وسيطات اختيارية.
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);

المَعلمات

الاسم	Type	الوصف
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");

المَعلمات

الاسم	Type	الوصف
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]"
});

المَعلمات

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

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

الاسم	Type	الوصف
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 ذات الصلة:

• 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");

المَعلمات

الاسم	Type	الوصف
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]"
});

المَعلمات

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

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

الاسم	Type	الوصف
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 ذات الصلة:

• 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 الكلاسيكية، وليس Inbox.

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

يمكن أيضًا مراجعة

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

• https://mail.google.com/

يمكن أيضًا مراجعة

• addLabel(label)

---

reply(body)

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

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

• https://mail.google.com/

يمكن أيضًا مراجعة

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

---

reply(body, options)

يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد إلى" مع إدراج وسيطات اختيارية. يمكن أن تحتوي رسالة البريد الإلكتروني على نص عادي ونص 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
});

المَعلمات

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

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

الاسم	Type	الوصف
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 ذات الصلة:

• https://mail.google.com/

يمكن أيضًا مراجعة

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

---

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

المَعلمات

الاسم	Type	الوصف
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
});

المَعلمات

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

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

الاسم	Type	الوصف
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 ذات الصلة:

• https://mail.google.com/

يمكن أيضًا مراجعة

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