تتيح لك هذه الخدمة إرسال رسائل إلكترونية وإنشاء مسودات وإدارة التصنيفات ووضع علامات على الرسائل وسلاسل المحادثات وإجراء مجموعة متنوّعة من مهام إدارة حساب 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) وجميع مستلِمي الرسالة الأخيرة في سلسلة المحادثات هذه، باستخدام وسيطات اختيارية. |