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عرض نسخة من هذا الكائن الثنائي الكبير (blob)
getAs(contentType)Blobعرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد.
getBytes()Byte[]الحصول على البيانات المخزنة في هذا الكائن الثنائي الكبير (blob).
getContentType()Stringتحصل على نوع المحتوى بالبايت في هذا الكائن الثنائي الكبير (blob).
getDataAsString()Stringيحصل على بيانات هذا الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.
getDataAsString(charset)Stringيحصل على بيانات هذا الكائن الثنائي الكبير (blob) كسلسلة بالترميز المحدد.
getHash()Stringتحصل على تجزئة محتوى SHA1 لهذا المرفق.
getName()Stringالحصول على اسم هذا الكائن الثنائي الكبير (blob).
getSize()Integerيحدّد حجم هذا المرفق.
isGoogleType()Booleanيعرض ما إذا كان هذا الكائن الثنائي الكبير (blob) هو ملف Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
setBytes(data)Blobلضبط البيانات المخزّنة في هذا الكائن الثنائي الكبير (blob).
setContentType(contentType)Blobيحدّد هذا الإعداد نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير (blob).
setContentTypeFromExtension()Blobيحدِّد هذا الإعداد نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير (blob) استنادًا إلى امتداد الملف.
setDataFromString(string)Blobتُحدِّد بيانات هذا الكائن الثنائي الكبير (blob) من سلسلة بترميز UTF-8.
setDataFromString(string, charset)Blobتتيح هذه السياسة ضبط بيانات الكائن الثنائي الكبير (blob) من سلسلة باستخدام الترميز المحدّد.
setName(name)Blobتحدّد اسم هذا الكائن الثنائي الكبير (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يحصل على المستلمين المفصولين بفواصل bcc'd في هذه الرسالة.
getBody()Stringيحصل على محتوى HTML لنص هذه الرسالة.
getCc()Stringيحصل على المستلمين المفصولين بفاصلة cc'd على هذه الرسالة.
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إنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان الرد، مع وسيطات اختيارية.
createDraftReplyAll(body)GmailDraftتنشئ مسودة رسالة للرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع مستلمي هذه الرسالة.
createDraftReplyAll(body, options)GmailDraftإنشاء مسودة رسالة للرد على مرسِل الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام عنوان الرد إلى جميع المستلمين، مع الوسيطات الاختيارية.
getFirstMessageSubject()Stringيحصل على موضوع الرسالة الأولى في سلسلة المحادثات.
getId()Stringيحصل على رقم تعريف سلسلة المحادثات هذه.
getLabels()GmailLabel[]عرض التصنيفات التي أنشأها المستخدم في سلسلة المحادثات هذه.
getLastMessageDate()Dateيحصل على تاريخ أحدث رسالة سلسلة المحادثات هذه.
getMessageCount()Integerلعرض عدد الرسائل في سلسلة المحادثات.
getMessages()GmailMessage[]يحصل على الرسائل في سلسلة المحادثات هذه.
getPermalink()Stringيحصل على رابط ثابت لسلسلة المحادثات هذه.
hasStarredMessages()Booleanعرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل مميّزة بنجمة.
isImportant()Booleanعرض ما إذا تم وضع علامة على سلسلة المحادثات كمهمة.
isInChats()Booleanعرض ما إذا كانت سلسلة المحادثات مصنّفة كمحادثة.
isInInbox()Booleanعرض ما إذا كانت سلسلة المحادثات في البريد الوارد.
isInPriorityInbox()Booleanعرض "صحيح" إذا كانت سلسلة المحادثات هذه في البريد الوارد ذي الأولوية، بينما تعرض "خطأ" بخلاف ذلك.
isInSpam()Booleanعرض ما إذا تم وضع علامة على سلسلة المحادثات كرسائل غير مرغوب فيها.
isInTrash()Booleanعرض ما إذا كانت سلسلة المحادثات في المهملات.
isUnread()Booleanعرض ما إذا كانت سلسلة المحادثات تتضمن أي رسائل غير مقروءة.
markImportant()GmailThreadوضع علامة على سلسلة المحادثات هذه باعتبارها مهمة.
markRead()GmailThreadوضع علامة "مقروءة" على سلسلة المحادثات هذه
markUnimportant()GmailThreadوضع علامة على سلسلة المحادثات هذه باعتبارها غير مهمة.
markUnread()GmailThreadوضع علامة "غير مقروءة" على سلسلة المحادثات هذه
moveToArchive()GmailThreadتنقل سلسلة المحادثات هذه إلى الأرشيف.
moveToInbox()GmailThreadتنقل سلسلة المحادثات هذه إلى البريد الوارد.
moveToSpam()GmailThreadنقل سلسلة المحادثات هذه إلى مجلد الرسائل غير المرغوب فيها
moveToTrash()GmailThreadينقل سلسلة المحادثات هذه إلى المهملات
refresh()GmailThreadلإعادة تحميل سلسلة المحادثات هذه والحالة المرتبطة بها من Gmail (يُعد ذلك مفيدًا في حال تغيير التصنيفات وحالة القراءة وما إلى ذلك).
removeLabel(label)GmailThreadلإزالة هذا التصنيف من سلسلة المحادثات
reply(body)GmailThreadالرد على مُرسِل آخر رسالة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo.
reply(body, options)GmailThreadيمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام العنوان ResponseTo، مع الوسيطات الاختيارية.
replyAll(body)GmailThreadالردّ على المُرسِل (باستخدام العنوان "الردّ") وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه
replyAll(body, options)GmailThreadيمكنك الرد على المُرسِل (باستخدام العنوان replyTo) وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام وسيطات اختيارية.