سلسلة محادثات في حساب مستخدم على Gmail
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addLabel(label) | GmailThread | إضافة هذا التصنيف إلى سلسلة المحادثات |
createDraftReply(body) | GmailDraft | إنشاء مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام للرد على عنوان البريد الإلكتروني. |
createDraftReply(body, options) | GmailDraft | إنشاء مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية. |
createDraftReplyAll(body) | GmailDraft | تنشئ مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد وجميع مستلمي هذه الرسالة. |
createDraftReplyAll(body, options) | GmailDraft | تنشئ مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد وجميع المستلمين، مع وسيطات اختيارية. |
getFirstMessageSubject() | String | يحصل على موضوع الرسالة الأولى في سلسلة المحادثات. |
getId() | String | الحصول على معرّف سلسلة المحادثات هذه |
getLabels() | GmailLabel[] | تعرض التصنيفات التي أنشأها المستخدم في سلسلة المحادثات هذه. |
getLastMessageDate() | Date | عرض تاريخ أحدث رسالة في سلسلة المحادثات هذه. |
getMessageCount() | Integer | يعرض عدد الرسائل في سلسلة المحادثات. |
getMessages() | GmailMessage[] | يحصل على الرسائل في سلسلة المحادثات هذه. |
getPermalink() | String | للحصول على رابط ثابت لسلسلة المحادثات هذه |
hasStarredMessages() | Boolean | تعرض ما إذا كانت سلسلة المحادثات تحتوي على أي رسائل مميّزة بنجمة. |
isImportant() | Boolean | تعرض ما إذا تم وضع علامة على سلسلة المحادثات كمهمة. |
isInChats() | Boolean | يعرض ما إذا كانت سلسلة المحادثات مصنّفة على أنّها محادثة. |
isInInbox() | Boolean | يعرض ما إذا كانت سلسلة المحادثات في البريد الوارد. |
isInPriorityInbox() | Boolean | عرض القيمة "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الإلكتروني ذي الأولوية وتقوم بإرجاع false في الحالات الأخرى. |
isInSpam() | Boolean | يعرض ما إذا تم وضع علامة على سلسلة المحادثات كغير مرغوب فيها. |
isInTrash() | Boolean | يعرض ما إذا كانت سلسلة المحادثات في المهملات. |
isUnread() | Boolean | يعرض ما إذا كانت سلسلة المحادثات تحتوي على أي رسائل غير مقروءة. |
markImportant() | GmailThread | يضع علامة على سلسلة المحادثات هذه كمهمة. |
markRead() | GmailThread | يضع علامة "مقروءة" على سلسلة المحادثات هذه. |
markUnimportant() | GmailThread | يضع علامة على سلسلة المحادثات هذه كغير مهمة. |
markUnread() | GmailThread | يضع علامة "غير مقروءة" على سلسلة المحادثات هذه. |
moveToArchive() | GmailThread | نقل سلسلة المحادثات هذه إلى الأرشيف |
moveToInbox() | GmailThread | ينقل سلسلة المحادثات هذه إلى البريد الوارد. |
moveToSpam() | GmailThread | نقل سلسلة المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها |
moveToTrash() | GmailThread | نقل سلسلة المحادثات هذه إلى المهملات |
refresh() | GmailThread | تؤدي إلى إعادة تحميل سلسلة المحادثات هذه والحالة المرتبطة بها من Gmail (مفيدة في حال كانت التصنيفات وحالة القراءة وما إلى ذلك). |
removeLabel(label) | GmailThread | إزالة هذا التصنيف من سلسلة المحادثات |
reply(body) | GmailThread | يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان ReplyTo. |
reply(body, options) | GmailThread | يمكنك الردّ على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان ReplyTo، مع اختيار الوسيطة. |
replyAll(body) | GmailThread | الرد على المُرسِل (باستخدام عنوان ReplyTo) وجميع مستلمي الرسالة الأخيرة في هذا الحقل . |
replyAll(body, options) | GmailThread | الرد على المُرسِل (باستخدام عنوان replyTo ) وجميع مستلِمي الرسالة الأخيرة
في سلسلة المحادثات هذه مع وسيطات اختيارية. |
الوثائق التفصيلية
addLabel(label)
إضافة هذا التصنيف إلى سلسلة المحادثات
// Add label MyLabel to the first thread in the inbox var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.addLabel(label);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | GmailLabel | التصنيف الذي سيتم تطبيقه على سلسلة المحادثات هذه |
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
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[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
bcc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة" |
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى |
from | String | هو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا
من القيم التي تعرضها الدالة GmailApp.getAliases() |
htmlBody | String | إذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك
وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML
إذا كانت لديك صور مضمّنة لبريدك الإلكتروني |
inlineImages | Object | كائن JavaScript يحتوي على ربط من مفتاح صورة
(String ) إلى بيانات الصورة (BlobSource ) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم) |
subject | String | سطر موضوع جديد للرسالة الإلكترونية (بحد أقصى 250 حرفًا) |
الإرجاع
GmailDraft
: مسودة الرسالة التي تم إنشاؤها حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
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[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
bcc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة" |
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى |
from | String | هو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا
من القيم التي تعرضها الدالة GmailApp.getAliases() |
htmlBody | String | إذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك
وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML
إذا كانت لديك صور مضمّنة لبريدك الإلكتروني |
inlineImages | Object | كائن JavaScript يحتوي على ربط من مفتاح صورة
(String ) إلى بيانات الصورة (BlobSource ) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم) |
subject | String | سطر موضوع جديد لرسالة البريد الإلكتروني. الحد الأقصى للحجم هو 250 حرفًا. |
الإرجاع
GmailDraft
: مسودة الرسالة التي تم إنشاؤها حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
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()
عرض القيمة "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الإلكتروني ذي الأولوية وتقوم بإرجاع false في الحالات الأخرى.
// Log if this thread is in the priority inbox var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0]; Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());
الإرجاع
Boolean
— صحيح إذا كانت سلسلة المحادثات في البريد ذي الأولوية
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
isInSpam()
يعرض ما إذا تم وضع علامة على سلسلة المحادثات كغير مرغوب فيها.
// Log if this thread is in the spam folder var firstThread = GmailApp.getInboxThreads(0,1)[0]; Logger.log('Spam? ' + firstThread.isInSpam());
الإرجاع
Boolean
: ما إذا تم وضع علامة على سلسلة المحادثات هذه كغير مرغوب فيها أم لا.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
isInTrash()
يعرض ما إذا كانت سلسلة المحادثات في المهملات.
// Log if this thread is in the trash var firstThread = GmailApp.getInboxThreads(0,1)[0]; Logger.log('Trashed? ' + firstThread.isInTrash());
الإرجاع
Boolean
— صحيح إذا كانت سلسلة المحادثات في المهملات
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
isUnread()
يعرض ما إذا كانت سلسلة المحادثات تحتوي على أي رسائل غير مقروءة.
// Log if this thread is unread var firstThread = GmailApp.getInboxThreads(0,1)[0]; Logger.log('Unread? ' + firstThread.isUnread());
الإرجاع
Boolean
— صحيح إذا كانت هناك رسائل غير مقروءة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
markImportant()
يضع علامة على سلسلة المحادثات هذه كمهمة.
// Mark first inbox thread as important var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.markImportant();
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
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)
يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان ReplyTo.
تجدر الإشارة إلى أنّ الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين) يجب ألا يتجاوز 20 كيلوبايت.
// Respond to author of last email in thread with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.reply("Got your message");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
body | String | نص الرسالة الإلكترونية |
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
reply(body, options)
يمكنك الردّ على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان ReplyTo، مع اختيار الوسيطة. ويمكن أن تحتوي الرسالة الإلكترونية على نص عادي، بالإضافة إلى نص HTML. لاحظ أن إجمالي يجب ألا يتجاوز حجم الرسالة الإلكترونية (بما في ذلك جميع الرؤوس، ولكن باستثناء المرفقات) 20 كيلوبايت.
// Respond with HTML body text. var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.reply("incapable of HTML", { htmlBody: "some HTML body text", noReply: true });
المعلمات
الاسم | النوع | الوصف |
---|---|---|
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى |
bcc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة" |
htmlBody | String | إذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك
وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML
إذا كانت لديك صور مضمّنة لبريدك الإلكتروني |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
from | String | هو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا
من القيم التي تعرضها الدالة GmailApp.getAliases() |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم) |
noReply | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان عام
عدم الرد على عنوان البريد الإلكتروني لمنع المستلمين من الرد على رسائل البريد الإلكتروني هذا الخيار هو
إمكانية الاستخدام في حسابات Google Workspace فقط، وليس لمستخدمي Gmail |
attachments | BlobSource[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
inlineImages | Object | كائن JavaScript يحتوي على ربط من مفتاح صورة
(String ) إلى بيانات الصورة (BlobSource ) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
replyAll(body)
الرد على المُرسِل (باستخدام عنوان ReplyTo) وجميع مستلمي الرسالة الأخيرة في هذا الحقل .
تجدر الإشارة إلى أنّ الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع العناوين) يجب ألا يتجاوز 20 كيلوبايت.
// Respond to all with acknowledgment to the first thread in the inbox var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.replyAll("Got your message");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
body | String | نص الرسالة الإلكترونية |
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
replyAll(body, options)
الرد على المُرسِل (باستخدام عنوان replyTo
) وجميع مستلِمي الرسالة الأخيرة
في سلسلة المحادثات هذه مع وسيطات اختيارية. يمكن أن تحتوي رسالة البريد الإلكتروني على كل من النص العادي
نص HTML الأساسي. لاحظ أن الحجم الإجمالي للرسالة الإلكترونية (بما في ذلك جميع الرؤوس، ولكن باستثناء
المرفقات) 20 كيلوبايت.
// Respond with HTML body text. var firstThread = GmailApp.getInboxThreads(0,1)[0]; firstThread.replyAll("incapable of HTML", { htmlBody: "some HTML body text", noReply: true });
المعلمات
الاسم | النوع | الوصف |
---|---|---|
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى |
bcc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة" |
htmlBody | String | إذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك
وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML
إذا كانت لديك صور مضمّنة لبريدك الإلكتروني |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
from | String | هو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا
من القيم التي تعرضها الدالة GmailApp.getAliases() |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم) |
noReply | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان عام
عدم الرد على عنوان البريد الإلكتروني لمنع المستلمين من الرد على رسائل البريد الإلكتروني هذا الخيار هو
ممكن لحسابات G Suite فقط، وليس لمستخدمي Gmail |
attachments | BlobSource[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
inlineImages | Object | كائن JavaScript يحتوي على ربط من مفتاح صورة
(String ) إلى بيانات الصورة (BlobSource ) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
الإرجاع
GmailThread
: سلسلة المحادثات هذه مفيدة للسلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/