يتيح الوصول إلى سلاسل المحادثات والرسائل والتصنيفات في Gmail.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
create | Gmail | لإنشاء مسودة رسالة إلكترونية. |
create | Gmail | لإنشاء مسودة رسالة إلكترونية باستخدام وسيطات اختيارية |
create | Gmail | أنشئ تصنيف مستخدم جديدًا بالاسم المحدّد. |
delete | Gmail | لحذف التصنيف المحدّد |
get | String[] | الحصول على قائمة بعناوين البريد الإلكتروني التي تم إعدادها كعناوين بديلة لهذا الحساب في Gmail |
get | Gmail | استرداد مسودة رسالة إلكترونية حسب المعرّف |
get | Gmail | استرداد جميع مسودات الرسائل |
get | Gmail | الحصول على جميع مسودات الرسائل في Gmail |
get | Gmail | يسترجع جميع سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات. |
get | Gmail | يسترجع نطاقًا من سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات. |
get | Integer | تحصل على عدد سلاسل المحادثات غير المقروءة في البريد الوارد. |
get | Gmail | الحصول على رسالة حسب المعرّف |
get | Gmail | استرداد جميع الرسائل في سلسلة المحادثات المحدّدة |
get | Gmail | استرداد جميع الرسائل في سلاسل المحادثات المحدّدة |
get | Gmail | استرداد جميع سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات |
get | Gmail | يستردّ نطاقًا من سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات. |
get | Integer | الحصول على عدد سلاسل المحادثات غير المقروءة في "البريد الهام" |
get | Gmail | استرداد جميع سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات |
get | Gmail | استرداد نطاق من سلاسل محادثات الرسائل غير المرغوب فيها بغض النظر عن التصنيفات |
get | Integer | الحصول على عدد سلاسل المحادثات غير المقروءة غير المرغوب فيها |
get | Gmail | استرداد جميع سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات |
get | Gmail | استرداد نطاق من سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات |
get | Integer | الحصول على عدد سلاسل المحادثات غير المقروءة التي تم وضع علامة عليها |
get | Gmail | الحصول على سلسلة محادثات حسب رقم التعريف |
get | Gmail | استرداد جميع سلاسل المحادثات في المهملات بغض النظر عن التصنيفات |
get | Gmail | استرداد نطاق من سلاسل المحادثات في المهملات بغض النظر عن التصنيفات |
get | Gmail | يسترجع تصنيفًا بناءً على اسم التصنيف. |
get | Gmail | يسترجع قائمة بالتصنيفات التي أنشأها المستخدم. |
mark | Gmail | يضع علامة على هذه الرسالة بأنّها مقروءة ويجبر على إعادة تحميل الرسالة. |
mark | Gmail | يضع علامة على هذه الرسالة بأنّها غير مقروءة ويجبر على إعادة تحميلها. |
mark | Gmail | وضع علامة "مقروءة" على هذه الرسائل وإعادة تحميلها |
mark | Gmail | تُصنِّف هذه الرسائل على أنّها غير مقروءة وتجبر على إعادة تحميل الرسائل. |
mark | Gmail | يضع علامة على سلسلة المحادثات هذه باعتبارها مُهمّة ويُجبر سلسلة المحادثات على إعادة التحميل. |
mark | Gmail | يضع علامة "مقروءة" على سلسلة المحادثات هذه ويجبر سلسلة المحادثات على إعادة التحميل. |
mark | Gmail | يضع علامة على سلسلة المحادثات هذه كغير مهمة ويجبر سلسلة المحادثات على إعادة التحميل. |
mark | Gmail | تُعدّ هذه السلسلة من الرسائل غير المقروءة وتجبر على إعادة تحميلها. |
mark | Gmail | تضع علامة "مُهمّة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل. |
mark | Gmail | تضع علامة "مقروءة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل. |
mark | Gmail | تضع هذه العلامة على سلاسل المحادثات هذه كغير مهمة وتجبرها على إعادة التحميل. |
mark | Gmail | تضع هذه العلامة على سلاسل المحادثات هذه على أنّها غير مقروءة وتجبر سلاسل المحادثات على إعادة التحميل. |
move | Gmail | ينقل الرسالة إلى المهملات ويجبر على إعادة تحميل الرسالة. |
move | Gmail | ينقل الرسائل المحدّدة إلى المهملات ويجبر على إعادة تحميل الرسائل. |
move | Gmail | يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى الأرشيف وإعادة تحميلها. |
move | Gmail | يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى البريد الوارد وإعادة تحميلها. |
move | Gmail | يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها. |
move | Gmail | يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المهملات وإعادة تحميلها. |
move | Gmail | يؤدي هذا الإجراء إلى نقل هذه المحادثات إلى الأرشيف وإجبار المحادثات على إعادة التحميل. |
move | Gmail | ينقل هذا الإجراء سلاسل المحادثات هذه إلى البريد الوارد ويجبر سلاسل المحادثات على إعادة التحميل. |
move | Gmail | يؤدي ذلك إلى نقل سلاسل المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها. |
move | Gmail | يؤدي هذا الإجراء إلى نقل هذه المحادثات إلى المهملات وإعادة تحميلها. |
refresh | Gmail | إعادة تحميل الرسالة والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها) |
refresh | Gmail | إعادة تحميل الرسائل والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها) |
refresh | Gmail | إعادة تحميل سلسلة المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها) |
refresh | Gmail | إعادة تحميل سلاسل المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها) |
search(query) | Gmail | ابحث في Gmail باستخدام طلب البحث المحدَّد. |
search(query, start, max) | Gmail | ابحث في Gmail باستخدام طلب البحث المحدَّد. |
send | Gmail | إرسال رسالة إلكترونية |
send | Gmail | تُرسِل رسالة إلكترونية تتضمّن وسيطات اختيارية. |
set | void | تُستخدَم لضبط رمز ميزات
الوصول الحالي إلى الرسالة الذي يسمح للنص البرمجي بالوصول إلى خصائص Gmail الحالية. |
star | Gmail | تضيف نجمة إلى هذه الرسالة وتجبر على إعادة تحميلها. |
star | Gmail | تضيف نجومًا إلى هذه الرسائل وتجبر على إعادة تحميل الرسائل. |
unstar | Gmail | تزيل نجمة من هذه الرسالة وتجبر على إعادة تحميلها. |
unstar | Gmail | تزيل هذه الميزة النجوم من هذه الرسائل وتجبر على إعادة تحميل الرسائل. |
مستندات تفصيلية
create Draft(recipient, subject, body)
لإنشاء مسودة رسالة إلكترونية. حجم الرسالة الإلكترونية (بما في ذلك الرؤوس) محدود بسعة التخزين.
// The code below creates a draft email with the current date and time. const now = new Date(); GmailApp.createDraft( 'mike@example.com', 'current time', `The time is: ${now.toString()}`, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني |
subject | String | موضوع الرسالة الإلكترونية |
body | String | نص الرسالة الإلكترونية |
الإرجاع
Gmail
: مسودة Gmail التي تم إنشاؤها حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
create Draft(recipient, subject, body, options)
لإنشاء مسودة رسالة إلكترونية باستخدام وسيطات اختيارية يمكن أن تحتوي الرسالة الإلكترونية على نص عادي أو نص HTML. حجم الرسالة الإلكترونية (بما في ذلك العناوين، باستثناء المرفقات) محدود بسعة التخزين.
// Create a draft email with a file from Google Drive attached as a PDF. const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); GmailApp.createDraft( 'mike@example.com', 'Attachment example', 'Please see attached file.', { attachments: [file.getAs(MimeType.PDF)], name: 'Automatic Emailer Script', }, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | عناوين المستلِم |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
attachments | Blob | ملف متعدّد لإرساله مع الرسالة الإلكترونية |
bcc | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني المراد إرسال نسخة مخفية منها إلى البريد الإلكتروني |
cc | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب تضمينها في السطر "نسخة إلى" |
from | String | العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون أحد
القيم التي يعرضها get |
html | String | في حال ضبطها، ستستخدم الأجهزة القادرة على عرض HTML هذا الحقل بدلاً
من الوسيطة المطلوبة body. يمكنك إضافة حقل inline اختياري في HTML
body إذا كانت لديك صور مضمّنة لبريدك الإلكتروني. |
inline | Object | عنصر JavaScript يحتوي على تعيين من مفتاح الصورة
(String ) إلى بيانات الصورة (Blob )، ويفترض ذلك استخدام المَعلمة html وأن يحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
reply | String | عنوان بريد إلكتروني لاستخدامه كعنوان الردّ التلقائي (الإعداد التلقائي: عنوان البريد الإلكتروني للمستخدم) |
الإرجاع
Gmail
: مسودة Gmail التي تم إنشاؤها حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
create Label(name)
أنشئ تصنيف مستخدم جديدًا بالاسم المحدّد.
// Creates the label @FOO and logs label: FOO Logger.log(`label: ${GmailApp.createLabel('FOO')}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التصنيف الجديد |
الإرجاع
Gmail
: التصنيف الذي تم إنشاؤه حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
delete Label(label)
لحذف التصنيف المحدّد
// Have to get the label by name first const label = GmailApp.getUserLabelByName('FOO'); GmailApp.deleteLabel(label);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Gmail | التصنيف المطلوب حذفه |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Aliases()
الحصول على قائمة بعناوين البريد الإلكتروني التي تم إعدادها كعناوين بديلة لهذا الحساب في Gmail
يمكنك إرسال رسالة من أيّ من العناوين البديلة هذه باستخدام الوسيطة الاختيارية "من".
// Log the aliases for this Gmail account and send an email as the first one. const me = Session.getActiveUser().getEmail(); const aliases = GmailApp.getAliases(); Logger.log(aliases); if (aliases.length > 0) { GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', { from: aliases[0], }); } else { GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.'); }
الإرجاع
String[]
: صفيف من الأسماء البديلة لهذا الحساب
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Draft(draftId)
استرداد مسودة رسالة إلكترونية حسب المعرّف
استخدِم هذا الإجراء مع getId() في مسودات Gmail.
// Get the first draft message in your drafts folder const draft = GmailApp.getDrafts()[0]; // Get its ID const draftId = draft.getId(); // Now fetch the same draft using that ID. const draftById = GmailApp.getDraft(draftId); // Should always log true as they should be the same message Logger.log( draft.getMessage().getSubject() === draftById.getMessage().getSubject(), );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
draft | String | رقم تعريف المسودة المطلوب استرجاعها |
الإرجاع
Gmail
- المسودة التي تحمل المعرّف المحدّد
عمليات الرمي
Error
- إذا تعذّر العثور على مسودة بالمعرّف المحدّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Draft Messages()
استرداد جميع مسودات الرسائل
// Logs the number of draft messages const drafts = GmailApp.getDraftMessages(); Logger.log(drafts.length);
الإرجاع
Gmail
: صفيف من مسودات رسائل Gmail
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Drafts()
الحصول على جميع مسودات الرسائل في Gmail
const drafts = GmailApp.getDrafts(); for (let i = 0; i < drafts.length; i++) { Logger.log(drafts[i].getId()); }
الإرجاع
Gmail
: صفيف من مسودات رسائل Gmail
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Inbox Threads()
يسترجع جميع سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات.
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
// Log the subject lines of your Inbox const threads = GmailApp.getInboxThreads(); for (let i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في البريد الوارد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Inbox Threads(start, max)
يسترجع نطاقًا من سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات.
// Log the subject lines of up to the first 50 emails in your Inbox const threads = GmailApp.getInboxThreads(0, 50); for (let i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس سلسلة المحادثات الأولى التي تريد استرجاعها |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات التي سيتم استرجاعها |
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في البريد الوارد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Inbox Unread Count()
تحصل على عدد سلاسل المحادثات غير المقروءة في البريد الوارد.
Logger.log(`Messages unread in inbox: ${GmailApp.getInboxUnreadCount()}`);
الإرجاع
Integer
: عدد سلاسل المحادثات في البريد الوارد التي تحتوي على رسائل غير مقروءة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Message By Id(id)
الحصول على رسالة حسب المعرّف
استخدِم هذا الإجراء مع getId() في رسائل Gmail.
// Get the first message in the first thread of your inbox const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0]; // Get its ID const messageId = message.getId(); // Now fetch the same message using that ID. const messageById = GmailApp.getMessageById(messageId); // Should always log true as they should be the same message Logger.log(message.getSubject() === messageById.getSubject());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | رقم تعريف الرسالة المطلوب استرجاعها |
الإرجاع
Gmail
- الرسالة التي تحمل المعرّف المحدّد
عمليات الرمي
Error
- إذا تعذّر العثور على رسالة بالمعرّف المحدّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Messages For Thread(thread)
استرداد جميع الرسائل في سلسلة المحادثات المحدّدة
// Log all the subject lines in the first thread of your inbox const thread = GmailApp.getInboxThreads(0, 1)[0]; const messages = GmailApp.getMessagesForThread(thread); for (let i = 0; i < messages.length; i++) { Logger.log(`subject: ${messages[i].getSubject()}`); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة الرسائل المطلوب استردادها |
الإرجاع
Gmail
: صفيف الرسائل المقابلة لسلسلة المحادثات هذه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Messages For Threads(threads)
استرداد جميع الرسائل في سلاسل المحادثات المحدّدة
// Log the subject lines of all messages in the first two threads of your inbox const thread = GmailApp.getInboxThreads(0, 2); const messages = GmailApp.getMessagesForThreads(thread); for (let i = 0; i < messages.length; i++) { for (let j = 0; j < messages[i].length; j++) { Logger.log(`subject: ${messages[i][j].getSubject()}`); } }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | سلاسل محادثات الرسائل المطلوب استردادها |
الإرجاع
Gmail
: صفيف من صفائف الرسائل، حيث يرتبط كل عنصر في الصفيف الخارجي بسلسلة محادثات ويحتوي الصفيف الداخلي على الرسائل في تلك السلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Priority Inbox Threads()
استرداد جميع سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
Logger.log( `# of messages in your Priority Inbox: ${ GmailApp.getPriorityInboxThreads().length}`, );
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في "البريد الهام"
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Priority Inbox Threads(start, max)
يستردّ نطاقًا من سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات.
// Will log some number 2 or less Logger.log( `# of messages in your Priority Inbox: ${ GmailApp.getPriorityInboxThreads(0, 2).length}`, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس سلسلة المحادثات الأولى التي تريد استرجاعها |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات التي سيتم استرجاعها |
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في "البريد الهام"
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Priority Inbox Unread Count()
الحصول على عدد سلاسل المحادثات غير المقروءة في "البريد الهام"
Logger.log( `Number of unread emails in your Priority Inbox : ${ GmailApp.getPriorityInboxUnreadCount()}`, );
الإرجاع
Integer
: عدد سلاسل المحادثات في "البريد الوارد المُهم" التي تحتوي على رسائل غير مقروءة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Spam Threads()
استرداد جميع سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
Logger.log(`# of total spam threads: ${GmailApp.getSpamThreads().length}`);
الإرجاع
Gmail
: صفيف من سلاسل محادثات Gmail في مجلد الرسائل غير المرغوب فيها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Spam Threads(start, max)
استرداد نطاق من سلاسل محادثات الرسائل غير المرغوب فيها بغض النظر عن التصنيفات
// Will log a number at most 5 Logger.log(`# of total spam threads: ${GmailApp.getSpamThreads(0, 5).length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس سلسلة المحادثات الأولى التي تريد استرجاعها |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات التي سيتم استرجاعها |
الإرجاع
Gmail
: صفيف من سلاسل محادثات Gmail في مجلد الرسائل غير المرغوب فيها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Spam Unread Count()
الحصول على عدد سلاسل المحادثات غير المقروءة غير المرغوب فيها
// Unless you actually read stuff in your spam folder, this should be the same // as the number of messages in your spam folder. Logger.log(`# unread threads that are spam: ${GmailApp.getSpamUnreadCount()}`);
الإرجاع
Integer
: عدد سلاسل المحادثات غير المرغوب فيها التي تحتوي على رسائل غير مقروءة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Starred Threads()
استرداد جميع سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
// Logs the number of starred threads Logger.log(`# Starred threads: ${GmailApp.getStarredThreads().length}`);
الإرجاع
Gmail
: صفيف من سلاسل محادثات Gmail المميّزة بنجمة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Starred Threads(start, max)
استرداد نطاق من سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات
// Logs the number of starred threads to a maximum of 5 Logger.log(`# Starred threads: ${GmailApp.getStarredThreads(0, 5).length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس سلسلة المحادثات الأولى التي تريد استرجاعها |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات التي سيتم استرجاعها |
الإرجاع
Gmail
: صفيف من سلاسل محادثات Gmail المميّزة بنجمة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Starred Unread Count()
الحصول على عدد سلاسل المحادثات غير المقروءة التي تم وضع علامة عليها
Logger.log(`# unread and starred: ${GmailApp.getStarredUnreadCount()}`);
الإرجاع
Integer
: عدد سلاسل المحادثات المميّزة بنجمة التي تحتوي على رسائل غير مقروءة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Thread By Id(id)
الحصول على سلسلة محادثات حسب رقم التعريف
استخدِم هذا الإجراء مع getId() في سلاسل محادثات Gmail.
// Gets the first inbox thread. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; // Gets the same thread by ID. const threadById = GmailApp.getThreadById(firstThread.getId()); // Verifies that they are the same. console.log( firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject(), );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | رقم تعريف سلسلة المحادثات المطلوب استرجاعها |
الإرجاع
Gmail
: سلسلة المحادثات التي تحمل رقم التعريف المحدّد أو null
في حال عدم العثور عليها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
get Trash Threads()
استرداد جميع سلاسل المحادثات في المهملات بغض النظر عن التصنيفات
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
Logger.log(`# of total trash threads: ${GmailApp.getTrashThreads().length}`);
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في المهملات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Trash Threads(start, max)
استرداد نطاق من سلاسل المحادثات في المهملات بغض النظر عن التصنيفات
// Will log a number at most 5 Logger.log( `# of total trash threads: ${GmailApp.getTrashThreads(0, 5).length}`, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس سلسلة المحادثات الأولى التي تريد استرجاعها |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات التي سيتم استرجاعها |
الإرجاع
Gmail
- صفيف من سلاسل محادثات Gmail في المهملات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get User Label By Name(name)
يسترجع تصنيفًا بناءً على اسم التصنيف.
const labelObject = GmailApp.getUserLabelByName('myLabel');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التصنيف المطلوب استرجاعه |
الإرجاع
Gmail
: تصنيف Gmail الذي يحمل الاسم المحدَّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get User Labels()
يسترجع قائمة بالتصنيفات التي أنشأها المستخدم.
// Logs all of the names of your labels const labels = GmailApp.getUserLabels(); for (let i = 0; i < labels.length; i++) { Logger.log(`label: ${labels[i].getName()}`); }
الإرجاع
Gmail
: صفيف للتصنيفات التي أنشأها المستخدم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
mark Message Read(message)
يضع علامة على هذه الرسالة بأنّها مقروءة ويجبر على إعادة تحميل الرسالة.
// Mark the first message in the first thread of your inbox as read const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0]; GmailApp.markMessageRead(message);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب وضع علامة "مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Message Unread(message)
يضع علامة على هذه الرسالة بأنّها غير مقروءة ويجبر على إعادة تحميلها.
// Mark the first message in the first thread of your inbox as unread const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0]; GmailApp.markMessageUnread(message);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب وضع علامة "غير مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Messages Read(messages)
وضع علامة "مقروءة" على هذه الرسائل وإعادة تحميلها
// Mark first three messages in the first inbox thread as read. // Assumes that the first inbox thread has 3 messages in it. const threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages(); const messages = [threadMessages[0], threadMessages[1], threadMessages[2]]; GmailApp.markMessagesRead(messages);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | صفيف من الرسائل المطلوب وضع علامة "مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Messages Unread(messages)
تُصنِّف هذه الرسائل على أنّها غير مقروءة وتجبر على إعادة تحميل الرسائل.
// Mark first three messages in the first inbox thread as unread. // Assumes that the first inbox thread has 3 messages in it const threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages(); const messages = [threadMessages[0], threadMessages[1], threadMessages[2]]; GmailApp.markMessagesUnread(messages);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | صفيف من الرسائل المطلوب وضع علامة "غير مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Thread Important(thread)
يضع علامة على سلسلة المحادثات هذه باعتبارها مُهمّة ويُجبر سلسلة المحادثات على إعادة التحميل.
// Marks first inbox thread as important const thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadImportant(thread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب وضع علامة "مُهمّة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Thread Read(thread)
يضع علامة "مقروءة" على سلسلة المحادثات هذه ويجبر سلسلة المحادثات على إعادة التحميل.
// Marks first inbox thread as read const thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadRead(thread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب وضع علامة "مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Thread Unimportant(thread)
يضع علامة على سلسلة المحادثات هذه كغير مهمة ويجبر سلسلة المحادثات على إعادة التحميل.
// Marks first inbox thread as unimportant const thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadUnimportant(thread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب وضع علامة "غير مهمة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Thread Unread(thread)
تُعدّ هذه السلسلة من الرسائل غير المقروءة وتجبر على إعادة تحميلها.
// Marks first inbox thread as unread const thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadUnread(thread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب وضع علامة "غير مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Threads Important(threads)
تضع علامة "مُهمّة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل.
// Marks first two threads in inbox as important const threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsImportant(threads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف من سلاسل المحادثات المطلوب وضع علامة "مُهمّة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Threads Read(threads)
تضع علامة "مقروءة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل.
// Marks first two threads in inbox as read const threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsRead(threads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف من سلاسل المحادثات المطلوب وضع علامة "مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Threads Unimportant(threads)
تضع هذه العلامة على سلاسل المحادثات هذه كغير مهمة وتجبرها على إعادة التحميل.
// Marks first two threads in inbox as unimportant const threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsUnimportant(threads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف من سلاسل المحادثات المطلوب وضع علامة "غير مهمة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
mark Threads Unread(threads)
تضع هذه العلامة على سلاسل المحادثات هذه على أنّها غير مقروءة وتجبر سلاسل المحادثات على إعادة التحميل.
// Marks first two threads in inbox as unread const threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsUnread(threads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف من سلاسل المحادثات المطلوب وضع علامة "غير مقروءة" عليها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Message To Trash(message)
ينقل الرسالة إلى المهملات ويجبر على إعادة تحميل الرسالة.
// Move the first message in your inbox to trash const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const firstMessage = firstThread.getMessages()[0]; GmailApp.moveMessageToTrash(firstMessage);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب وضعها في المهملات |
الإرجاع
Gmail
- خدمة Gmail (مفيدة لإنشاء سلاسل)
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Messages To Trash(messages)
ينقل الرسائل المحدّدة إلى المهملات ويجبر على إعادة تحميل الرسائل.
// Move first two messages in your inbox to trash const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const messages = firstThread.getMessages(); const toDelete = [messages[0], messages[1]]; GmailApp.moveMessagesToTrash(toDelete);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | الرسائل المطلوب وضعها في المهملات |
الإرجاع
Gmail
- خدمة Gmail (مفيدة لإنشاء سلاسل)
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Thread To Archive(thread)
يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى الأرشيف وإعادة تحميلها.
// Archive the first thread in your inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.moveThreadToArchive(firstThread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب أرشفتها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Thread To Inbox(thread)
يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى البريد الوارد وإعادة تحميلها.
// Find a thread not already in your inbox const thread = GmailApp.search('-in:inbox')[0]; // Get the first one GmailApp.moveThreadToInbox(thread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب نقلها إلى البريد الوارد |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Thread To Spam(thread)
يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها.
// Tag first thread in inbox as spam const firstThread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.moveThreadToSpam(firstThread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب نقلها إلى مجلد "المحتوى غير المرغوب فيه" |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Thread To Trash(thread)
يؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المهملات وإعادة تحميلها.
// Move first thread in inbox to trash const firstThread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.moveThreadToTrash(firstThread);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب وضعها في "المهملات" |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Threads To Archive(threads)
يؤدي هذا الإجراء إلى نقل هذه المحادثات إلى الأرشيف وإجبار المحادثات على إعادة التحميل.
// Move first two threads in your inbox to the archive const firstTwoThreads = GmailApp.getInboxThreads(0, 2); GmailApp.moveThreadsToArchive(firstTwoThreads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف سلاسل المحادثات المطلوب أرشفتها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Threads To Inbox(threads)
ينقل هذا الإجراء سلاسل المحادثات هذه إلى البريد الوارد ويجبر سلاسل المحادثات على إعادة التحميل.
// Find two threads not already in your inbox const firstTwoThreads = GmailApp.search('-in:inbox', 0, 2); GmailApp.moveThreadsToInbox(firstTwoThreads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | مصفوفة من سلاسل المحادثات المطلوب نقلها إلى البريد الوارد |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Threads To Spam(threads)
يؤدي ذلك إلى نقل سلاسل المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها.
// Move first two threads in your inbox to spam const firstTwoThreads = GmailApp.getInboxThreads(0, 2); GmailApp.moveThreadsToSpam(firstTwoThreads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف من سلاسل المحادثات المطلوب نقلها إلى مجلد الرسائل غير المرغوب فيها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
move Threads To Trash(threads)
يؤدي هذا الإجراء إلى نقل هذه المحادثات إلى المهملات وإعادة تحميلها.
// Move first two threads in your inbox to trash const firstTwoThreads = GmailApp.getInboxThreads(0, 2); GmailApp.moveThreadsToTrash(firstTwoThreads);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | صفيف سلاسل محادثات لإرسالها إلى المهملات |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
refresh Message(message)
إعادة تحميل الرسالة والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const firstMessage = firstThread.getMessages()[0]; // ...Do something that may take a while here.... GmailApp.refreshMessage(firstMessage); // ...Do more stuff with firstMessage...
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب إعادة تحميلها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
refresh Messages(messages)
إعادة تحميل الرسائل والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const coupleOfMessages = firstThread.getMessages().slice(0, 2); // ...Do something that may take a while here.... GmailApp.refreshMessages(coupleOfMessages); // ...Do more stuff with coupleOfMessages...
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | الرسائل المطلوب إعادة تحميلها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
refresh Thread(thread)
إعادة تحميل سلسلة المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
const firstThread = GmailApp.getInboxThreads(0, 1)[0]; // ...Do something that may take a while here.... GmailApp.refreshThread(firstThread); // ... Do more stuff with the thread ...
المعلمات
الاسم | النوع | الوصف |
---|---|---|
thread | Gmail | سلسلة المحادثات المطلوب إعادة تحميلها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
refresh Threads(threads)
إعادة تحميل سلاسل المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
const threads = GmailApp.getInboxThreads(0, 3); // ...Do something that may take a while here.... GmailApp.refreshThreads(threads); // ... Do more stuff with threads ...
المعلمات
الاسم | النوع | الوصف |
---|---|---|
threads | Gmail | سلاسل المحادثات التي سيتم إعادة تحميلها |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
search(query)
ابحث في Gmail باستخدام طلب البحث المحدَّد.
سيتعذّر إكمال هذا الطلب عندما يكون حجم جميع سلاسل المحادثات كبيرًا جدًا لدرجة أنّه لا يمكن للنظام التعامل معه. إذا كان حجم سلسلة المحادثات غير معروف، ومن المحتمل أن يكون كبيرًا جدًا، يُرجى استخدام طلب "الصفحات"، وتحديد نطاقات سلاسل المحادثات التي سيتم استرجاعها في كل طلب.
// Find starred messages with subject IMPORTANT const threads = GmailApp.search('is:starred subject:"IMPORTANT"');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
query | String | طلب البحث، كما تكتب طلب البحث في Gmail |
الإرجاع
Gmail
: صفيف لسلاسل محادثات Gmail تتطابق مع طلب البحث هذا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
search(query, start, max)
ابحث في Gmail باستخدام طلب البحث المحدَّد.
// Find starred messages with subject IMPORTANT and return second batch of 10. // Assumes there are at least 11 of them, otherwise this will return an empty // array. const threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
query | String | طلب البحث، كما تكتب طلب البحث في Gmail |
start | Integer | فهرس سلسلة التعليمات التي تبدأ |
max | Integer | الحد الأقصى لعدد سلاسل المحادثات المطلوب عرضها |
الإرجاع
Gmail
: صفيف لسلاسل محادثات Gmail تتطابق مع طلب البحث هذا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
send Email(recipient, subject, body)
إرسال رسالة إلكترونية حجم الرسالة الإلكترونية (بما في ذلك الرؤوس) محدود بسعة التخزين.
// The code below will send an email with the current date and time. const now = new Date(); GmailApp.sendEmail( 'mike@example.com', 'current time', `The time is: ${now.toString()}`, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني |
subject | String | موضوع الرسالة الإلكترونية (250 حرفًا بحد أقصى) |
body | String | نص الرسالة الإلكترونية |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
send Email(recipient, subject, body, options)
تُرسِل رسالة إلكترونية تتضمّن وسيطات اختيارية. يمكن أن تحتوي الرسالة الإلكترونية على نص عادي أو محتوى HTML. حجم الرسالة الإلكترونية (بما في ذلك العناوين، باستثناء المرفقات) محدود بسعة التخزين.
// Send an email with a file from Google Drive attached as a PDF. const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); GmailApp.sendEmail( 'mike@example.com', 'Attachment example', 'Please see the attached file.', { attachments: [file.getAs(MimeType.PDF)], name: 'Automatic Emailer Script', }, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | عناوين المستلِم |
subject | String | سطر الموضوع (250 حرفًا بحد أقصى) |
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
attachments | Blob | ملف متعدّد لإرساله مع الرسالة الإلكترونية |
bcc | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني المراد إرسال نسخة مخفية منها إلى البريد الإلكتروني |
cc | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب تضمينها في السطر "نسخة إلى" |
from | String | العنوان الذي يجب إرسال الرسالة الإلكترونية منه، والذي يجب أن يكون أحد
القيم التي يعرضها get |
html | String | في حال ضبطها، ستستخدم الأجهزة القادرة على عرض HTML هذا الحقل بدلاً
من الوسيطة المطلوبة body. يمكنك إضافة حقل inline اختياري في HTML
body إذا كانت لديك صور مضمّنة لبريدك الإلكتروني. |
inline | Object | عنصر JavaScript يحتوي على تعيين من مفتاح الصورة
(String ) إلى بيانات الصورة (Blob )، ويفترض ذلك استخدام المَعلمة html وأن يحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" /> |
name | String | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم) |
no | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني عام
يمنع الردّ لمنع المستلمين من الردّ على الرسائل الإلكترونية، لا يمكن استخدام
هذا الخيار إلا لحسابات Google Workspace، وليس لمستخدمي Gmail. |
reply | String | عنوان بريد إلكتروني لاستخدامه كعنوان الردّ التلقائي (الإعداد التلقائي: عنوان البريد الإلكتروني للمستخدم) |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
set Current Message Access Token(accessToken)
تُستخدَم لضبط رمز ميزات
الوصول الحالي إلى الرسالة الذي يسمح للنص البرمجي بالوصول إلى خصائص Gmail
الحالية.
لا تتطلّب هذه الطريقة سوى مشاريع إضافة Google Workspace التي تستخدم نطاقات الرسائل الحالية في Gmail.
function handleAddonActionEvent(e) { GmailApp.setCurrentMessageAccessToken(e.messageMetadata.accessToken); const mailMessage = GmailApp.getMessageById(e.messageMetadata.messageId); // Do something with mailMessage }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
access | String | رمز مفتاح المرور المؤقت الذي تم الحصول عليه من عنصر حدث الإجراء في إحدى إضافات Gmail |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
star Message(message)
تضيف نجمة إلى هذه الرسالة وتجبر على إعادة تحميلها.
// Stars the first message in the first thread in your inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; GmailApp.starMessage(message);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب تمييزها بنجمة |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
star Messages(messages)
تضيف نجومًا إلى هذه الرسائل وتجبر على إعادة تحميل الرسائل.
// Stars the first three messages in the first thread in your inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const coupleOfMessages = firstThread.getMessages().slice(0, 3); GmailApp.starMessages(coupleOfMessages);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | صفيف من الرسائل المطلوب تمييزها بنجمة |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
unstar Message(message)
تزيل نجمة من هذه الرسالة وتجبر على إعادة تحميلها.
// Unstars the first message in the first thread in your inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; GmailApp.unstarMessage(message);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Gmail | الرسالة المطلوب إلغاء تمييزها بنجمة |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
انظر أيضًا
unstar Messages(messages)
تزيل هذه الميزة النجوم من هذه الرسائل وتجبر على إعادة تحميل الرسائل.
// Unstars the first three messages in the first thread in your inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const coupleOfMessages = firstThread.getMessages().slice(0, 3); GmailApp.unstarMessages(coupleOfMessages);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
messages | Gmail | صفيف من الرسائل المطلوب إلغاء تمييزها بنجمة |
الإرجاع
Gmail
: خدمة Gmail، وهي مفيدة لإنشاء سلاسل
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/