Class GmailThread

GmailThread

سلسلة محادثات في حساب مستخدم على Gmail

الطُرق

الطريقةنوع الإرجاعوصف قصير
addLabel(label)GmailThreadإضافة هذا التصنيف إلى سلسلة المحادثات
createDraftReply(body)GmailDraftإنشاء مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام للرد على عنوان البريد الإلكتروني.
createDraftReply(body, options)GmailDraftإنشاء مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية.
createDraftReplyAll(body)GmailDraftتنشئ مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد وجميع مستلمي هذه الرسالة.
createDraftReplyAll(body, options)GmailDraftتنشئ مسودة رسالة للرد على مرسل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد وجميع المستلمين، مع وسيطات اختيارية.
getFirstMessageSubject()Stringيحصل على موضوع الرسالة الأولى في سلسلة المحادثات.
getId()Stringالحصول على معرّف سلسلة المحادثات هذه
getLabels()GmailLabel[]تعرض التصنيفات التي أنشأها المستخدم في سلسلة المحادثات هذه.
getLastMessageDate()Dateعرض تاريخ أحدث رسالة في سلسلة المحادثات هذه.
getMessageCount()Integerيعرض عدد الرسائل في سلسلة المحادثات.
getMessages()GmailMessage[]يحصل على الرسائل في سلسلة المحادثات هذه.
getPermalink()Stringللحصول على رابط ثابت لسلسلة المحادثات هذه
hasStarredMessages()Booleanتعرض ما إذا كانت سلسلة المحادثات تحتوي على أي رسائل مميّزة بنجمة.
isImportant()Booleanتعرض ما إذا تم وضع علامة على سلسلة المحادثات كمهمة.
isInChats()Booleanيعرض ما إذا كانت سلسلة المحادثات مصنّفة على أنّها محادثة.
isInInbox()Booleanيعرض ما إذا كانت سلسلة المحادثات في البريد الوارد.
isInPriorityInbox()Booleanعرض القيمة "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الإلكتروني ذي الأولوية وتقوم بإرجاع 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);

المعلمات

الاسمالنوعالوصف
labelGmailLabelالتصنيف الذي سيتم تطبيقه على سلسلة المحادثات هذه

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
bccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة"
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى
fromStringهو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا من القيم التي تعرضها الدالة GmailApp.getAliases()
htmlBodyStringإذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني
inlineImagesObjectكائن JavaScript يحتوي على ربط من مفتاح صورة (String) إلى بيانات الصورة (BlobSource) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
subjectStringسطر موضوع جديد للرسالة الإلكترونية (بحد أقصى 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");

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
bccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة"
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى
fromStringهو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا من القيم التي تعرضها الدالة GmailApp.getAliases()
htmlBodyStringإذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني
inlineImagesObjectكائن JavaScript يحتوي على ربط من مفتاح صورة (String) إلى بيانات الصورة (BlobSource) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
subjectStringسطر موضوع جديد لرسالة البريد الإلكتروني. الحد الأقصى للحجم هو 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/

انظر أيضًا


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

تجدر الإشارة إلى أنّ هذا الإجراء لا يعمل إلا مع واجهة 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);
}

المعلمات

الاسمالنوعالوصف
labelGmailLabelالتصنيف الذي تريد إزالته من سلسلة المحادثات هذه

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى
bccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة"
htmlBodyStringإذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
fromStringهو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا من القيم التي تعرضها الدالة GmailApp.getAliases()
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان عام عدم الرد على عنوان البريد الإلكتروني لمنع المستلمين من الرد على رسائل البريد الإلكتروني هذا الخيار هو إمكانية الاستخدام في حسابات Google Workspace فقط، وليس لمستخدمي Gmail
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
inlineImagesObjectكائن 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");

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية

الإرجاع

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

المعلمات

الاسمالنوعالوصف
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى
bccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة"
htmlBodyStringإذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
fromStringهو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا من القيم التي تعرضها الدالة GmailApp.getAliases()
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان عام عدم الرد على عنوان البريد الإلكتروني لمنع المستلمين من الرد على رسائل البريد الإلكتروني هذا الخيار هو ممكن لحسابات G Suite فقط، وليس لمستخدمي Gmail
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
inlineImagesObjectكائن JavaScript يحتوي على ربط من مفتاح صورة (String) إلى بيانات الصورة (BlobSource) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />

الإرجاع

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

التفويض

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

  • https://mail.google.com/

انظر أيضًا