Gmail Service

Gmail

تتيح لك هذه الخدمة إرسال الرسائل الإلكترونية وإنشاء المسودات وإدارة التصنيفات ووضع علامة على الرسائل وسلاسل المحادثات وتنفيذ مجموعة متنوعة من مهام إدارة حساب Gmail الأخرى. اطّلِع أيضًا على خدمة البريد، وهي خدمة أبسط تسمح بإرسال الرسائل الإلكترونية فقط.

صفوف

الاسموصف قصير
GmailAppيتيح الوصول إلى سلاسل المحادثات والرسائل والتصنيفات في Gmail.
GmailAttachmentمرفق من Gmail
GmailDraftمسودة رسالة أنشأها المستخدم في حساب Gmail الخاص به
GmailLabelتصنيف أنشأه المستخدم في حساب Gmail الخاص به
GmailMessageرسالة في حساب Gmail الخاص بالمستخدم
GmailThreadسلسلة محادثات في حساب Gmail الخاص بالمستخدم

GmailApp

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createDraft(recipient, subject, body)GmailDraftلإنشاء مسودة رسالة إلكترونية.
createDraft(recipient, subject, body, options)GmailDraftلإنشاء مسودة رسالة إلكترونية باستخدام وسيطات اختيارية
createLabel(name)GmailLabelأنشئ تصنيف مستخدم جديدًا بالاسم المحدّد.
deleteLabel(label)GmailAppلحذف التصنيف المحدّد
getAliases()String[]الحصول على قائمة بعناوين البريد الإلكتروني التي تم إعدادها كعناوين بديلة لهذا الحساب في Gmail
getDraft(draftId)GmailDraftاسترداد مسودة رسالة إلكترونية حسب المعرّف
getDraftMessages()GmailMessage[]استرداد جميع مسودات الرسائل
getDrafts()GmailDraft[]الحصول على جميع مسودات الرسائل في Gmail
getInboxThreads()GmailThread[]يسترجع جميع سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات.
getInboxThreads(start, max)GmailThread[]يسترجع نطاقًا من سلاسل المحادثات في البريد الوارد بغض النظر عن التصنيفات.
getInboxUnreadCount()Integerتحصل على عدد سلاسل المحادثات غير المقروءة في البريد الوارد.
getMessageById(id)GmailMessageالحصول على رسالة حسب المعرّف
getMessagesForThread(thread)GmailMessage[]استرداد جميع الرسائل في سلسلة المحادثات المحدّدة
getMessagesForThreads(threads)GmailMessage[][]استرداد جميع الرسائل في سلاسل المحادثات المحدّدة
getPriorityInboxThreads()GmailThread[]استرداد جميع سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات
getPriorityInboxThreads(start, max)GmailThread[]يستردّ نطاقًا من سلاسل المحادثات في "البريد الهام" بغض النظر عن التصنيفات.
getPriorityInboxUnreadCount()Integerالحصول على عدد سلاسل المحادثات غير المقروءة في "البريد الهام"
getSpamThreads()GmailThread[]استرداد جميع سلاسل المحادثات غير المرغوب فيها بغض النظر عن التصنيفات
getSpamThreads(start, max)GmailThread[]استرداد نطاق من سلاسل محادثات الرسائل غير المرغوب فيها بغض النظر عن التصنيفات
getSpamUnreadCount()Integerالحصول على عدد سلاسل المحادثات غير المقروءة غير المرغوب فيها
getStarredThreads()GmailThread[]استرداد جميع سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات
getStarredThreads(start, max)GmailThread[]استرداد نطاق من سلاسل المحادثات المميّزة بنجمة بغض النظر عن التصنيفات
getStarredUnreadCount()Integerالحصول على عدد سلاسل المحادثات غير المقروءة التي تم وضع علامة عليها
getThreadById(id)GmailThreadالحصول على سلسلة محادثات حسب رقم التعريف
getTrashThreads()GmailThread[]استرداد جميع سلاسل المحادثات في المهملات بغض النظر عن التصنيفات
getTrashThreads(start, max)GmailThread[]استرداد نطاق من سلاسل المحادثات في المهملات بغض النظر عن التصنيفات
getUserLabelByName(name)GmailLabelيسترجع تصنيفًا بناءً على اسم التصنيف.
getUserLabels()GmailLabel[]يسترجع قائمة بالتصنيفات التي أنشأها المستخدم.
markMessageRead(message)GmailAppيضع علامة على هذه الرسالة بأنّها مقروءة ويجبر على إعادة تحميل الرسالة.
markMessageUnread(message)GmailAppيضع علامة على هذه الرسالة بأنّها غير مقروءة ويجبر على إعادة تحميلها.
markMessagesRead(messages)GmailAppوضع علامة "مقروءة" على هذه الرسائل وإعادة تحميلها
markMessagesUnread(messages)GmailAppتُصنِّف هذه الرسائل على أنّها غير مقروءة وتجبر على إعادة تحميل الرسائل.
markThreadImportant(thread)GmailAppيضع علامة على سلسلة المحادثات هذه باعتبارها مُهمّة ويُجبر سلسلة المحادثات على إعادة التحميل.
markThreadRead(thread)GmailAppيضع علامة "مقروءة" على سلسلة المحادثات هذه ويجبر سلسلة المحادثات على إعادة التحميل.
markThreadUnimportant(thread)GmailAppيضع علامة على سلسلة المحادثات هذه كغير مهمة ويجبر سلسلة المحادثات على إعادة التحميل.
markThreadUnread(thread)GmailAppتُعدّ هذه السلسلة من الرسائل غير المقروءة وتجبر على إعادة تحميلها.
markThreadsImportant(threads)GmailAppتضع علامة "مُهمّة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل.
markThreadsRead(threads)GmailAppتضع علامة "مقروءة" على سلاسل المحادثات هذه وتجبرها على إعادة التحميل.
markThreadsUnimportant(threads)GmailAppتضع هذه العلامة على سلاسل المحادثات هذه كغير مهمة وتجبرها على إعادة التحميل.
markThreadsUnread(threads)GmailAppتضع هذه العلامة على سلاسل المحادثات هذه على أنّها غير مقروءة وتجبر سلاسل المحادثات على إعادة التحميل.
moveMessageToTrash(message)GmailAppينقل الرسالة إلى المهملات ويجبر على إعادة تحميل الرسالة.
moveMessagesToTrash(messages)GmailAppينقل الرسائل المحدّدة إلى المهملات ويجبر على إعادة تحميل الرسائل.
moveThreadToArchive(thread)GmailAppيؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى الأرشيف وإعادة تحميلها.
moveThreadToInbox(thread)GmailAppيؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى البريد الوارد وإعادة تحميلها.
moveThreadToSpam(thread)GmailAppيؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها.
moveThreadToTrash(thread)GmailAppيؤدي هذا الإجراء إلى نقل سلسلة المحادثات هذه إلى المهملات وإعادة تحميلها.
moveThreadsToArchive(threads)GmailAppيؤدي هذا الإجراء إلى نقل هذه المحادثات إلى الأرشيف وإجبار المحادثات على إعادة التحميل.
moveThreadsToInbox(threads)GmailAppينقل هذا الإجراء سلاسل المحادثات هذه إلى البريد الوارد ويجبر سلاسل المحادثات على إعادة التحميل.
moveThreadsToSpam(threads)GmailAppيؤدي ذلك إلى نقل سلاسل المحادثات هذه إلى المحتوى غير المرغوب فيه وإعادة تحميلها.
moveThreadsToTrash(threads)GmailAppيؤدي هذا الإجراء إلى نقل هذه المحادثات إلى المهملات وإعادة تحميلها.
refreshMessage(message)GmailAppإعادة تحميل الرسالة والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
refreshMessages(messages)GmailAppإعادة تحميل الرسائل والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
refreshThread(thread)GmailAppإعادة تحميل سلسلة المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
refreshThreads(threads)GmailAppإعادة تحميل سلاسل المحادثات والحالة المرتبطة بها من Gmail (مفيد في حال تغيّر التصنيفات وحالة القراءة وغيرها)
search(query)GmailThread[]ابحث في Gmail باستخدام طلب البحث المحدَّد.
search(query, start, max)GmailThread[]ابحث في Gmail باستخدام طلب البحث المحدَّد.
sendEmail(recipient, subject, body)GmailAppإرسال رسالة إلكترونية
sendEmail(recipient, subject, body, options)GmailAppتُرسِل رسالة إلكترونية تتضمّن وسيطات اختيارية.
setCurrentMessageAccessToken(accessToken)voidتُستخدَم لضبط رمز ميزات الوصول الحالي إلى الرسالة الذي يسمح للنص البرمجي بالوصول إلى خصائص GmailMessage الحالية.
starMessage(message)GmailAppتضيف نجمة إلى هذه الرسالة وتجبر على إعادة تحميلها.
starMessages(messages)GmailAppتضيف نجومًا إلى هذه الرسائل وتجبر على إعادة تحميل الرسائل.
unstarMessage(message)GmailAppتزيل نجمة من هذه الرسالة وتجبر على إعادة تحميلها.
unstarMessages(messages)GmailAppتزيل هذه الميزة النجوم من هذه الرسائل وتجبر على إعادة تحميل الرسائل.

GmailAttachment

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
copyBlob()Blobعرض نسخة من هذا العنصر
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBytes()Byte[]تحصل على البيانات المخزّنة في هذا المربّع.
getContentType()Stringتحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
getDataAsString()Stringتحصل على بيانات هذا العنصر المصغّر كسلسلة بترميز UTF-8.
getDataAsString(charset)Stringتحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد.
getHash()Stringتحصل على تجزئة محتوى SHA1 لهذا المرفق.
getName()Stringتحصل على اسم هذا المربّع.
getSize()Integerتحصل على حجم هذا المرفق.
isGoogleType()Booleanتُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
setBytes(data)Blobتُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.
setContentType(contentType)Blobلضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
setContentTypeFromExtension()Blobلضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف
setDataFromString(string)Blobتُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.
setDataFromString(string, charset)Blobتُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.
setName(name)Blobتُستخدَم لضبط اسم هذا المربّع.

GmailDraft

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
deleteDraft()voidيؤدي إلى حذف مسودة الرسالة هذه.
getId()Stringللحصول على معرّف مسودة الرسالة هذه.
getMessage()GmailMessageتعرِض هذه السمة رسالة Gmail تمثّل هذه المسودة.
getMessageId()Stringلعرض معرّف GmailMessage الذي يمثّل هذه المسودة.
send()GmailMessageتُرسِل هذه المسودة لرسالة إلكترونية.
update(recipient, subject, body)GmailDraftاستبدال محتوى مسودة الرسالة هذه
update(recipient, subject, body, options)GmailDraftتستبدل هذه الدالة محتوى مسودة الرسالة هذه باستخدام الوسيطات الاختيارية.

GmailLabel

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addToThread(thread)GmailLabelتُضيف هذه العلامة إلى سلسلة المحادثات المحدّدة وتجبر سلسلة المحادثات على إعادة التحميل (GmailThread.refresh()).
addToThreads(threads)GmailLabelتُضيف هذه العلامة إلى سلاسل المحادثات المحدّدة وتجبر سلاسل المحادثات على إعادة التحميل.
deleteLabel()voidيؤدي إلى حذف هذا التصنيف.
getName()Stringتحصل على اسم هذا التصنيف.
getThreads()GmailThread[]الحصول على سلاسل المحادثات التي تم وضع علامة عليها بهذا التصنيف
getThreads(start, max)GmailThread[]تحصل على نطاق من سلاسل المحادثات التي تم وضع علامة عليها بهذا التصنيف.
getUnreadCount()Integerالحصول على عدد سلاسل المحادثات غير المقروءة التي تم وضع علامة عليها بهذا التصنيف
removeFromThread(thread)GmailLabelتزيل هذه الرسالة هذا التصنيف من سلسلة المحادثات المحدّدة وتجبرها على إعادة التحميل.
removeFromThreads(threads)GmailLabelتؤدي هذه العملية إلى إزالة هذا التصنيف من سلاسل المحادثات المحدّدة وإعادة تحميلها.

GmailMessage

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
createDraftReply(body)GmailDraftينشئ هذا الخيار مسودة رسالة للردّ على مُرسِل هذه الرسالة باستخدام عنوان الردّ.
createDraftReply(body, options)GmailDraftتُنشئ هذه الدالة مسودة رسالة للردّ على مُرسِل هذه الرسالة باستخدام عنوان الردّ، مع تحديد وسيطات اختيارية.
createDraftReplyAll(body)GmailDraftلإنشاء مسودة رسالة للردّ على المُرسِل باستخدام عنوان الردّ وجميع مستلمي هذه الرسالة.
createDraftReplyAll(body, options)GmailDraftتُنشئ هذه الدالة مسودة رسالة للردّ على مُرسِل هذه الرسالة باستخدام عنوان الردّ و جميع المستلمين، مع وسيطات اختيارية.
forward(recipient)GmailMessageإعادة توجيه هذه الرسالة إلى مستلِمين جدد
forward(recipient, options)GmailMessageإعادة توجيه هذه الرسالة إلى مستلِمين جدد، مع وسيطات اختيارية
getAttachments()GmailAttachment[]الحصول على جميع المرفقات لهذه الرسالة
getAttachments(options)GmailAttachment[]الحصول على جميع المرفقات لهذه الرسالة
getBcc()Stringالحصول على نسخة مخفية الوجهة من هذه الرسالة للمستلمين المُدرَجين مفصولين بفواصل
getBody()Stringالحصول على محتوى HTML لنص هذه الرسالة
getCc()Stringالحصول على نسخة من هذه الرسالة إلى المستلمين المُدرَجين مفصولين بفواصل
getDate()Dateتحصل على تاريخ ووقت هذه الرسالة.
getFrom()Stringللحصول على مُرسِل هذه الرسالة.
getHeader(name)Stringتحصل على قيمة رأس RFC 2822 استنادًا إلى اسم الرأس.
getId()Stringللحصول على معرّف هذه الرسالة.
getPlainBody()Stringتحصل على محتوى نص هذه الرسالة بدون تنسيق HTML.
getRawContent()Stringالحصول على المحتوى الأوّلي لهذه الرسالة
getReplyTo()Stringللحصول على عنوان الردّ على هذه الرسالة (عادةً المُرسِل).
getSubject()Stringالحصول على موضوع هذه الرسالة
getThread()GmailThreadتحصل على سلسلة المحادثات التي تحتوي على هذه الرسالة.
getTo()Stringتحصل على مستلمي هذه الرسالة مفصولين بفواصل.
isDraft()Booleanتحصل على ما إذا كانت هذه الرسالة مسودة.
isInChats()Booleanتحصل على ما إذا كانت هذه الرسالة محادثة.
isInInbox()Booleanتحصل على ما إذا كانت هذه الرسالة في البريد الوارد.
isInPriorityInbox()Booleanتعرِض القيمة true إذا كانت هذه الرسالة في صندوق البريد الوارد ذو الأولوية، وتعرِض القيمة false في غير ذلك.
isInTrash()Booleanالحصول على ما إذا كانت هذه الرسالة في المهملات
isStarred()Booleanالحصول على ما إذا كانت هذه الرسالة مميّزة بنجمة
isUnread()Booleanالحصول على ما إذا كانت هذه الرسالة غير مقروءة
markRead()GmailMessageيضع علامة على الرسالة بأنّها مقروءة.
markUnread()GmailMessageيضع علامة على الرسالة بأنّها غير مقروءة.
moveToTrash()GmailMessageينقل الرسالة إلى المهملات.
refresh()GmailMessageتؤدي هذه العملية إلى إعادة تحميل هذه الرسالة والحالة المرتبطة بها من Gmail (يكون ذلك مفيدًا في حال تغيّر التصنيفات وحالة القراءة وغيرها).
reply(body)GmailMessageيتم الردّ على مُرسِل هذه الرسالة باستخدام عنوان الردّ.
reply(body, options)GmailMessageتُرسِل هذه الرسالة ردًا على مُرسِل هذه الرسالة باستخدام عنوان الردّ، مع إدراج وسيطات اختيارية.
replyAll(body)GmailMessageالردّ على المُرسِل باستخدام عنوان الردّ وجميع مستلمي هذه الرسالة
replyAll(body, options)GmailMessageتُرسِل الردود إلى مُرسِل هذه الرسالة باستخدام عنوان الردّ وجميع المستلِمين، مع وسيطات اختيارية.
star()GmailMessageتمييز الرسالة بنجمة
unstar()GmailMessageإلغاء تمييز الرسالة بنجمة

GmailThread

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addLabel(label)GmailThreadتُضيف هذه العلامة إلى سلسلة المحادثات.
createDraftReply(body)GmailDraftلإنشاء مسودة رسالة للردّ على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام عنوان الردّ.
createDraftReply(body, options)GmailDraftلإنشاء مسودة رسالة للردّ على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان reply-to، مع وسيطات اختيارية
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تعرِض هذه الدالة القيمة true إذا كانت سلسلة المحادثات هذه في البريد الوارد ذو الأولوية، وتعرِض القيمة 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) وجميع مستلِمي الرسالة الأخيرة في سلسلة المحادثات هذه، مع إدراج وسيطات اختيارية