Class GmailMessage

GmailMessage

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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
createDraftReply(body)	GmailDraft	إنشاء مسودة رسالة للرد على مرسل هذه الرسالة باستخدام عنوان الرد.
createDraftReply(body, options)	GmailDraft	يتم إنشاء مسودة رسالة للرد على مُرسِل هذه الرسالة باستخدام عنوان الرد، مع وسيطات اختيارية.
createDraftReplyAll(body)	GmailDraft	تنشئ مسودة رسالة للرد على المُرسِل باستخدام عنوان الرد وجميع مستلمي هذه الرسالة.
createDraftReplyAll(body, options)	GmailDraft	يتم إنشاء مسودة رسالة للرد على مرسل هذه الرسالة باستخدام عنوان الرد وجميع المستلمين، مع وسيطات اختيارية.
forward(recipient)	GmailMessage	إعادة توجيه هذه الرسالة إلى المستلمين الجدد
forward(recipient, options)	GmailMessage	إعادة توجيه هذه الرسالة إلى المستلمين الجدد باستخدام الوسيطات الاختيارية.
getAttachments()	GmailAttachment[]	الحصول على جميع المرفقات المتعلّقة بهذه الرسالة.
getAttachments(options)	GmailAttachment[]	الحصول على جميع المرفقات المتعلّقة بهذه الرسالة.
getBcc()	String	الحصول على نسخة من هذه الرسائل للمستلِمين المفصولين بفواصل.
getBody()	String	الحصول على محتوى HTML لنص هذه الرسالة
getCc()	String	يتم إرسال نسخة من هذه الرسالة إلى المُستلِمين المفصولين بفواصل.
getDate()	Date	الحصول على تاريخ هذه الرسالة ووقتها
getFrom()	String	الحصول على مرسل هذه الرسالة
getHeader(name)	String	تحصل على قيمة عنوان RFC 2822 وفقًا لاسم العنوان.
getId()	String	الحصول على رقم تعريف هذه الرسالة
getPlainBody()	String	تحصل على محتوى نص هذه الرسالة بدون تنسيق HTML.
getRawContent()	String	الحصول على المحتوى الأولي لهذه الرسالة.
getReplyTo()	String	يحصل على عنوان الرد على هذه الرسالة (عادةً ما يكون المُرسِل).
getSubject()	String	يعرض موضوع هذه الرسالة.
getThread()	GmailThread	يحصل على سلسلة المحادثات التي تحتوي على هذه الرسالة.
getTo()	String	الحصول على مستلمي هذه الرسالة مفصولة بفواصل.
isDraft()	Boolean	يحدِّد ما إذا كانت هذه الرسالة مسودة.
isInChats()	Boolean	الحصول على ما إذا كانت هذه الرسالة محادثة.
isInInbox()	Boolean	الحصول على ما إذا كانت هذه الرسالة ضمن البريد الوارد
isInPriorityInbox()	Boolean	عرض true إذا كانت هذه الرسالة في البريد الوارد الهام، ويتم عرض false بخلاف ذلك.
isInTrash()	Boolean	الحصول على ما إذا كانت هذه الرسالة في المهملات
isStarred()	Boolean	الحصول على ما إذا كانت هذه الرسالة مميّزة بنجمة
isUnread()	Boolean	الحصول على ما إذا كانت هذه الرسالة غير مقروءة.
markRead()	GmailMessage	وضع علامة "مقروءة" على الرسالة
markUnread()	GmailMessage	وضع علامة "غير مقروءة" على الرسالة
moveToTrash()	GmailMessage	نقل الرسالة إلى المهملات
refresh()	GmailMessage	إعادة تحميل هذه الرسالة والحالة المرتبطة بها من Gmail (مفيدة في حالة تغيير التصنيفات وحالة القراءة وما إلى ذلك)
reply(body)	GmailMessage	الرد على مُرسِل هذه الرسالة باستخدام عنوان الرد.
reply(body, options)	GmailMessage	يمكنك الرد على مُرسِل هذه الرسالة باستخدام عنوان الرد، مع الوسيطات الاختيارية.
replyAll(body)	GmailMessage	يتم الرد على المُرسِل باستخدام عنوان الرد والرد على جميع مستلمي هذه الرسالة.
replyAll(body, options)	GmailMessage	الرد على مُرسِل هذه الرسالة باستخدام عنوان الرد وجميع المستلمين مع وسيطات اختيارية.
star()	GmailMessage	تمييز الرسالة بنجمة.
unstar()	GmailMessage	إلغاء تمييز الرسالة بنجمة

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

createDraftReply(body)

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

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.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.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.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 response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var 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 response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.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)

---

forward(recipient)

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

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("[e-mail],[e-mail]");

المَعلمات

الاسم	النوع	الوصف
recipient	String	قائمة بعناوين البريد الإلكتروني مفصولة بفواصل.

رحلة العودة

GmailMessage: هذه الرسالة مفيدة في وضع السلاسل.

التفويض

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

• https://mail.google.com/

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

• forward(recipient, options)

---

forward(recipient, options)

إعادة توجيه هذه الرسالة إلى المستلمين الجدد باستخدام الوسيطات الاختيارية.

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("[e-mail],[e-mail]", {
  cc: "[e-mail]",
  bcc: "[e-mail],[e-mail]"
});

المَعلمات

الاسم	النوع	الوصف
recipient	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	اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
noReply	Boolean	true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام لا يتم الرد عليه لمنع العملاء من الرد على الرسائل الإلكترونية، وهذا الخيار متاح فقط لحسابات Google Workspace، وليس لمستخدمي Gmail.
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان رد تلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
subject	String	سطر موضوع جديد للرسالة الإلكترونية، بحد أقصى 250 حرفًا.

رحلة العودة

GmailMessage: هذه الرسالة مفيدة في وضع السلاسل.

التفويض

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

• https://mail.google.com/

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

• forward(recipient)

---

getAttachments()

الحصول على جميع المرفقات المتعلّقة بهذه الرسالة.

رحلة العودة

GmailAttachment[]: مصفوفة من مرفقات Blob لهذه الرسالة.

التفويض

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

• https://mail.google.com/

---

getAttachments(options)

الحصول على جميع المرفقات المتعلّقة بهذه الرسالة.

المَعلمات

الاسم	النوع	الوصف
options	Object	عنصر JavaScript يُحدِّد المعلّمات المتقدّمة، كما هو موضّح أدناه.

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

الاسم	النوع	الوصف
includeInlineImages	Boolean	true إذا كان يجب أن تحتوي الصفيف المعروض من مرفقات Blob على صور مضمَّنة (الإعداد التلقائي هو true).
includeAttachments	Boolean	true إذا كانت الصفيف المعروض من مرفقات Blob يجب أن يتضمن مرفقات عادية (غير مضمّنة) (الإعداد التلقائي هو true).

رحلة العودة

GmailAttachment[]: مصفوفة من مرفقات Blob لهذه الرسالة.

التفويض

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

• https://mail.google.com/

---

getBcc()

الحصول على نسخة من هذه الرسائل للمستلِمين المفصولين بفواصل.

هذا فارغ لجميع الرسائل المستلمة، حسب التعريف.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

رحلة العودة

String: تم إنشاء نسخة مخفية الوجهة من المُستلِمين المفصولين بفواصل.

التفويض

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

• https://mail.google.com/

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

• getTo()

---

getBody()

الحصول على محتوى HTML لنص هذه الرسالة

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

رحلة العودة

String - محتوى نص هذه الرسالة.

التفويض

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

• https://mail.google.com/

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

• getSubject()

---

getCc()

يتم إرسال نسخة من هذه الرسالة إلى المُستلِمين المفصولين بفواصل.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

رحلة العودة

String — يتم إرسال نسخة من هذه الرسالة إلى المُستلِمين المفصولين بفواصل.

التفويض

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

• https://mail.google.com/

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

• getTo()

---

getDate()

الحصول على تاريخ هذه الرسالة ووقتها

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

رحلة العودة

Date - تاريخ هذه الرسالة ووقتها

التفويض

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

• https://mail.google.com/

---

getFrom()

الحصول على مرسل هذه الرسالة

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

رحلة العودة

String: عنوان البريد الإلكتروني لمُرسِل الرسالة

التفويض

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

• https://mail.google.com/

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

• getReplyTo()

---

getHeader(name)

تحصل على قيمة عنوان RFC 2822 وفقًا لاسم العنوان.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

المَعلمات

الاسم	النوع	الوصف
name	String	اسم عنوان RFC بدون فصل النقطتين عن القيمة.

رحلة العودة

String: قيمة العنوان أو سلسلة فارغة في حال عدم توفّر العنوان في الرسالة.

التفويض

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

• https://mail.google.com/

---

getId()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

رحلة العودة

String: رقم تعريف الرسالة

---

getPlainBody()

تحصل على محتوى نص هذه الرسالة بدون تنسيق HTML. وهي خطوة أكثر تعقيدًا من getBody() وتستغرق وقتًا أطول.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

رحلة العودة

String — محتوى النص الأساسي لهذه الرسالة

التفويض

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

• https://mail.google.com/

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

• getSubject()

---

getRawContent()

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

رحلة العودة

String: المحتوى الأولي لهذه الرسالة

التفويض

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

• https://mail.google.com/

---

getReplyTo()

يحصل على عنوان الرد على هذه الرسالة (عادةً ما يكون المُرسِل).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

رحلة العودة

String - عنوان البريد الإلكتروني للردود.

التفويض

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

• https://mail.google.com/

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

• getCc()

---

getSubject()

يعرض موضوع هذه الرسالة.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

رحلة العودة

String: موضوع هذه الرسالة

التفويض

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

• https://mail.google.com/

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

• getAttachments()

---

getThread()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

رحلة العودة

GmailThread: سلسلة محادثات Gmail التي تحتوي على هذه الرسالة

التفويض

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

• https://mail.google.com/

---

getTo()

الحصول على مستلمي هذه الرسالة مفصولة بفواصل.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

رحلة العودة

String : المستلمون المفصولون بفواصل هذه الرسالة.

التفويض

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

• https://mail.google.com/

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

• getCc()

---

isDraft()

يحدِّد ما إذا كانت هذه الرسالة مسودة.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

رحلة العودة

Boolean: ما إذا كانت هذه الرسالة مسوّدة.

التفويض

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

• https://mail.google.com/

---

isInChats()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

رحلة العودة

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

---

isInInbox()

الحصول على ما إذا كانت هذه الرسالة ضمن البريد الوارد

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

رحلة العودة

Boolean — ما إذا كانت هذه الرسالة في البريد الوارد.

التفويض

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

• https://mail.google.com/

---

isInPriorityInbox()

عرض true إذا كانت هذه الرسالة في البريد الوارد الهام، ويتم عرض false بخلاف ذلك.

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

رحلة العودة

Boolean: ما إذا كانت هذه الرسالة ضمن البريد الوارد ذي الأولوية.

التفويض

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

• https://mail.google.com/

---

isInTrash()

الحصول على ما إذا كانت هذه الرسالة في المهملات

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

رحلة العودة

Boolean: ما إذا كانت هذه الرسالة في المهملات

---

isStarred()

الحصول على ما إذا كانت هذه الرسالة مميّزة بنجمة

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

رحلة العودة

Boolean: ما إذا كانت هذه الرسالة مميّزة بنجمة.

---

isUnread()

الحصول على ما إذا كانت هذه الرسالة غير مقروءة.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

رحلة العودة

Boolean: الحالة غير المقروءة لهذه الرسالة.

التفويض

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

• https://mail.google.com/

---

markRead()

وضع علامة "مقروءة" على الرسالة

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

رحلة العودة

GmailMessage: رسالة Gmail هذه مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

• isUnread()

---

markUnread()

وضع علامة "غير مقروءة" على الرسالة

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

رحلة العودة

GmailMessage: رسالة Gmail هذه مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

• isUnread()

---

moveToTrash()

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

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

رحلة العودة

GmailMessage: رسالة Gmail هذه مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

• isInTrash()

---

refresh()

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

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

رحلة العودة

GmailMessage — هذه الرسالة للسلسلة.

التفويض

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

• https://mail.google.com/

---

reply(body)

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

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

المَعلمات

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

رحلة العودة

GmailMessage: هذه الرسالة مفيدة في وضع السلاسل.

التفويض

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

• https://mail.google.com/

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

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

---

reply(body, options)

يمكنك الرد على مُرسِل هذه الرسالة باستخدام عنوان الرد، مع الوسيطات الاختيارية.

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

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

المَعلمات

الاسم	النوع	الوصف
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	اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
noReply	Boolean	true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام لا يتم الرد عليه لمنع العملاء من الرد على الرسائل الإلكترونية، وهذا الخيار متاح فقط لحسابات Google Workspace، وليس لمستخدمي Gmail.
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان رد تلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
subject	String	سطر موضوع جديد للرسالة الإلكترونية، بحد أقصى 250 حرفًا.

رحلة العودة

GmailMessage: هذه الرسالة مفيدة في وضع السلاسل.

التفويض

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

• https://mail.google.com/

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

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

---

replyAll(body)

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

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

المَعلمات

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

رحلة العودة

GmailMessage: هذه الرسالة مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

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

---

replyAll(body, options)

الرد على مُرسِل هذه الرسالة باستخدام عنوان الرد وجميع المستلمين مع وسيطات اختيارية.

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

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

المَعلمات

الاسم	النوع	الوصف
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	اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
noReply	Boolean	true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام لا يتم الرد عليه لمنع العملاء من الرد على الرسائل الإلكترونية، وهذا الخيار متاح فقط لحسابات Google Workspace، وليس لمستخدمي Gmail.
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان رد تلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
subject	String	سطر موضوع جديد للرسالة الإلكترونية، بحد أقصى 250 حرفًا.

رحلة العودة

GmailMessage: هذه الرسالة مفيدة في وضع السلاسل.

التفويض

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

• https://mail.google.com/

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

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

---

star()

تمييز الرسالة بنجمة.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

رحلة العودة

GmailMessage: رسالة Gmail هذه مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

• unstar()

---

unstar()

إلغاء تمييز الرسالة بنجمة

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

رحلة العودة

GmailMessage: رسالة Gmail هذه مفيدة للسلسلة.

التفويض

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

• https://mail.google.com/

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

• star()