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

GmailDraft

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
deleteDraft()voidيؤدي إلى حذف مسودة الرسالة هذه.
getId()Stringيتم الحصول على رقم تعريف مسودة الرسالة هذه.
getMessage()GmailMessageلعرض رسالة GmailMessage تمثل هذه المسودة.
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تنشئ هذه الدالة مسودة رسالة رد على مُرسِل الرسالة الأخيرة في هذه السلسلة من الرسائل باستخدام عنوان الرد، مع وسيطات اختيارية.
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يمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد على".
reply(body, options)GmailThreadيمكنك الرد على مُرسِل الرسالة الأخيرة في سلسلة المحادثات هذه باستخدام عنوان "الرد إلى" مع إدراج وسيطات اختيارية.
replyAll(body)GmailThreadالرد على المرسل (باستخدام عنوان الرد إلى) وجميع مستلمي الرسالة الأخيرة في سلسلة المحادثات هذه.
replyAll(body, options)GmailThreadيمكنك الردّ على المُرسِل (باستخدام عنوان replyTo) وجميع مستلِمي الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام وسيطات اختيارية.