مرجع بريد (معاينة)

ملحوظة

الميزات في هذا المقال مدعومة بالحزام القياسي، الذي يستخدم خيارات الفوترة الموضحة في الترخيص للوكلاء المدعومين بالحزام القياسي. تعلم كيفية الوصول إلى الميزات القياسية في وكلاء Access القياسيين وتدفقات الوكلاء.

Important

هذه ميزة إصدار أولي.

• Microsoft إصدارات ميزات المعاينة قبل إصدار رسمي بحيث يمكن للعملاء الوصول المبكر وتقديم الملاحظات.
• تحتوي ميزات المعاينة على وظائف مقيدة ولا يقصد بها استخدام الإنتاج.
• قد تُجري مايكروسوفت تغييرات على أسماء ومعلمات أدوات المعاينة MCP. تجنب التبعيات المشفرة. يحتفظ Microsoft بدعم السيناريو.
• تخضع ميزات المعاينة لشروط الاستخدام الإضافية Microsoft.

نظرة عامة

مُعرف خادم	عنوان URL على مستوى المستأجر	‏‫اسم العرض‬	الوصف
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	البريد	أدوات لعمليات البريد الإلكتروني في Microsoft Graph، بما في ذلك إنشاء وإرسال ورد وإدارة رسائل البريد الإلكتروني.

الأدوات المتوفرة

mcp_MailTools_graph_mail_createMessage

إنشاء مسودة بريد إلكتروني. يدعم HTML عن طريق تعيين body.body.contentType = "HTML".

المعلمات المطلوبة:

• موضوع: موضوع الرسالة
• toRecipients: صفيف من المستلمين مع عناوين البريد الإلكتروني
• الجسم: نص الرسالة مع نوع المحتوى (Text/HTML) والمحتوى

المعلمات الاختيارية:

• تعيين تفضيلات HTML: يضبط على 'صحيح' لمحتوى HTML
• رؤوس: عناوين إضافية اختيارية

mcp_MailTools_graph_mail_deleteMessage (حذف رسالة)

حذف رسالة من علبة بريد المستخدم الذي سجل الدخول.

المعلمات المطلوبة:

• معرف: معرف الرسالة

المعلمات الاختيارية:

• If-Match: اختياري ETag للتحكم في التزامن

mcp_MailTools_graph_mail_getMessage

يحصل على رسالة حسب المعرف من علبة بريد المستخدم الذي قام بتسجيل الدخول. استخدم preferHtml لطلب جسم HTML.

المعلمات المطلوبة:

• معرف: معرف الرسالة

المعلمات الاختيارية:

• اختيار: عبارة اختيار OData
• الامتداد: عبارة التوسيع في OData
• تفضيل Html: تعيين تنسيق نص HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_قائمة_المرسلة

ادرج الرسائل في العناصر المرسلة.

المعلمات الاختيارية:

• تصفية: عامل تصفية OData
• بحث: استعلام البحث
• orderby: تعبير الفرز
• أعلى: عدد العناصر المراد إرجاعها
• اختار: الحقول المراد إرجاعها

mcp_MailTools_graph_mail_reply (أداة الرد على البريد الإلكتروني في الجرافيك)

قم بإرسال رد على رسالة موجودة. يدعم HTML عبر preferHtml أو headers.

المعلمات المطلوبة:

• معرف: معرف الرسالة للرد عليه

المعلمات الاختيارية:

• التعليق: نص الرد
• رسالة: تجاوزات الرسائل الاختيارية
• تفضيلHtml: تمكين تنسيق HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_replyAll

قم بإرسال رد على كل رسالة موجودة. يدعم HTML عبر preferHtml أو headers.

المعلمات المطلوبة:

• معرف: معرف الرسالة للرد على الكل

المعلمات الاختيارية:

• التعليق: نص الرد
• رسالة: تجاوزات الرسائل الاختيارية
• تفضيلHtml: تمكين تنسيق HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_searchMessages

ابحث في رسائل البريد الإلكتروني في Outlook باستخدام واجهة برمجة تطبيقات بحث Microsoft Graph مع استعلامات بنمط لغة استعلام الكلمات المفتاحية (KQL).

المعلمات المطلوبة:

• الطلبات: مصفوفة من طلبات البحث مع معاملات: استعلام، من، حجم

يدعم البحث في محتوى الرسالة والموضوع والنص الأساسي والمرفقات

mcp_MailTools_graph_mail_sendDraft

قم بإرسال مسودة رسالة موجودة حسب المُعرف.

المعلمات المطلوبة:

• معرف: معرف الرسالة المسودة لإرساله

إم. سي. بي_أدوات البريد_الرسم البياني للبريد_إرسال بريد

قم بإرسال بريد إلكتروني كالمستخدم الذي قام بتسجيل الدخول.

المعلمات المطلوبة:

• رسالة: كائن الرسالة مع الموضوع وtoRecipients والجسم
• موضوع: موضوع البريد الإلكتروني
• toRecipients: المستلمون الأساسيون
• المحتوى: نص البريد الإلكتروني مع contentType (Text/HTML) والمحتوى

المعلمات الاختيارية:

• ccRecipients: مستلمو النسخة الكربونية
• المصادقون: مستلمو النسخة المخفية
• حفظ العناصر المرسلة: احفظ إلى العناصر المرسلة (الافتراضي: صحيح)
• تفضيلHtml: فرض عرض HTML
• رؤوس: عناوين HTTP إضافية اختيارية

10. mcp_MailTools_graph_mail_updateMessage

يحدّث الخصائص القابلة للتعديل للرسالة، مثل الموضوع والمحتوى والفئات.

المعلمات المطلوبة:

• معرف: معرف الرسالة

المعلمات الاختيارية:

• موضوع: موضوع جديد
• جسم: نص الرسالة الجديد
• فئات: فئات الرسائل
• اهميه: منخفض أو عادي أو مرتفع
• المطابقة إذا:ETag للتحكم في التزامن

الميزات الأساسية

تكوين البريد الإلكتروني

• إنشاء مسودات وإرسال رسائل البريد الإلكتروني
• دعم HTML والنص العادي
• إلى ومستلمو النسخة الكربونية والنسخة المخفية
• خيارات تنسيق متقدمة

إدارة البريد الإلكتروني

• الحصول على الرسائل وتحديثها وحذفها.
• إمكانية الرد والرد على الكل.
• إدارة المسودة.
• إعدادات الفئة والأهمية.

البحث والتصفية

• البحث عن الرسائل على غرار KQL.
• دعم استعلام OData.
• البحث عبر الموضوع والنص والمرفقات.
• ترقيم الصفحات والتصفية.

Sentitems

• سرد الرسائل المرسلة.
• حفظ اختياري للعناصر المرسلة.
• تصفية العناصر المرسلة والبحث فيها.

الملاحظات

• تستخدم جميع العمليات Microsoft Graph Mail API.
• يتطلب محتوى HTML وجود contentType = "HTML" في المتن.
• preferHtml يطلب العنوان تنسيق نص HTML.
• يستخدم البحث Microsoft Graph Search API مع استعلامات KQL.
• يمكن إنشاء مسودة الرسائل وتحديثها وإرسالها بشكل منفصل.
• ETag دعم التحكم في التزامن على التحديثات.