سلسلة محادثات في حساب 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 | الرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo. |
reply(body, options) | GmailThread | يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo، مع الوسيطات الاختيارية. |
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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");
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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" });
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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 | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's) |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's) |
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");
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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" });
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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 | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's) |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's) |
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 الكلاسيكية، وليس مع البريد الوارد.
// 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); }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
label | GmailLabel | التصنيف المطلوب إزالته من سلسلة المحادثات هذه |
تذكرة ذهاب وعودة
GmailThread
: سلسلة المحادثات هذه مفيدة للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
راجع أيضًا
reply(body)
الرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo.
تجدر الإشارة إلى أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين) قد لا يتجاوز 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)
يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo، مع الوسيطات الاختيارية. وتتضمّن الرسالة الإلكترونية نصًا عاديًا، بالإضافة إلى نص 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 | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's) |
from | String | العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases() |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's) |
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");
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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 });
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
body | String | نص الرسالة الإلكترونية |
options | Object | عنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
cc | String | قائمة بعناوين البريد الإلكتروني المفصولة بفاصلة إلى نسخة |
bcc | String | قائمة بعناوين البريد الإلكتروني المفصولة بفواصل في سطر "نسخة مخفية الوجهة" |
htmlBody | String | في حال ضبط هذه السياسة، ستستخدم الأجهزة التي بإمكانها عرض HTML بدلاً من وسيطة النص المطلوبة، ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة للبريد الإلكتروني. |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's) |
from | String | العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون إحدى القيم التي يعرضها GmailApp.getAliases() |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's) |
noReply | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام
لا يتلقّى ردًا لمنع العملاء من الردّ على الرسائل الإلكترونية، هذا الخيار
متاح فقط لحسابات G Suite، وليس لمستخدمي Gmail |
attachments | BlobSource[] | مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية |
inlineImages | Object | عنصر JavaScript يحتوي على عملية ربط من مفتاح الصورة
(String ) إلى بيانات الصورة (BlobSource )، ويفترض ذلك أنّه يتم استخدام المعلّمة htmlBody وتتضمن إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> . |
تذكرة ذهاب وعودة
GmailThread
: سلسلة المحادثات هذه مفيدة للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/