سلسلة محادثات في حساب مستخدم على 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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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: "another@example.com" });
المَعلمات
الاسم | 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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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: "another@example.com" });
المَعلمات
الاسم | 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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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()
تستقبل الرسائل في سلسلة المحادثات هذه.
// 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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
markRead()
وضع علامة "مقروءة" على سلسلة المحادثات هذه
// Mark first inbox thread as read var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.markRead();
استرجاع الكرة
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
يمكن أيضًا مراجعة
markUnimportant()
يضع علامة على سلسلة المحادثات هذه كغير مهمة.
// Mark first inbox thread as unimportant var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.markUnimportant();
استرجاع الكرة
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
يمكن أيضًا مراجعة
markUnread()
وضع علامة "غير مقروءة" على سلسلة المحادثات هذه
// Mark first inbox thread as unread var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.markUnread();
استرجاع الكرة
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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)
يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد إلى" مع إدراج وسيطات اختيارية. يمكن أن تحتوي رسالة البريد الإلكتروني على نص عادي ونص 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/
يمكن أيضًا مراجعة
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/
يمكن أيضًا مراجعة
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/