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