حدث Microsoft Outlook
توفر هذه المقالة خصائص ومخطط أحداث Microsoft Outlook التي تنشرها واجهة برمجة تطبيقات Microsoft Graph. للحصول على مقدمة حول مخططات الأحداث، راجع مخطط CloudEvents.
أنواع الأحداث المتاحة
| اسم الحدث | الوصف |
|---|---|
| Microsoft.Graph.EventCreated | يتم التشغيل عند إنشاء حدث في Outlook. |
| Microsoft.Graph.EventUpdated | تم التشغيل عند تحديث حدث في Outlook. |
| Microsoft.Graph.EventDeleted | يتم التشغيل عند حذف حدث في Outlook. |
| Microsoft.Graph.ContactCreated | يتم التشغيل عند إنشاء اتصال في Outlook. |
| Microsoft.Graph.ContactUpdated | يتم التشغيل عند تحديث جهة اتصال في Outlook. |
| Microsoft.Graph.ContactDeleted | يتم التشغيل عند حذف جهة اتصال في Outlook. |
| Microsoft.Graph.MessageCreated | يتم تشغيله عند إنشاء رسالة في Outlook. |
| Microsoft.Graph.MessageUpdated | يتم تشغيله عند تحديث رسالة في Outlook. |
| Microsoft.Graph.MessageDeleted | يتم تشغيله عند حذف رسالة في Outlook. |
مثال حدث
عند تشغيل حدث ما، ترسل خدمة Event Grid بيانات عن هذا الحدث إلى وجهات الاشتراك. يحتوي هذا القسم على مثال على الشكل الذي ستبدو عليه هذه البيانات لكل حدث من أحداث Outlook.
حدث Microsoft.Graph.EventCreated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.EventCreated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Events/<event-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "created",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<event id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"@odata.type": "#Microsoft.OutlookServices.Event",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.EventUpdated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.EventUpdated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Events/<event-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "updated",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<event id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"@odata.type": "#Microsoft.OutlookServices.Event",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.EventDeleted
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.EventDeleted",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Events/<event-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "deleted",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<event id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Events('<event id>')",
"@odata.type": "#Microsoft.OutlookServices.Event",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.ContactCreated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ContactCreated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Contacts/<contact-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "created",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<contact id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"@odata.type": "#Microsoft.OutlookServices.Contact",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.ContactUpdated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ContactUpdated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Contacts/<contact-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "updated",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<contact id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"@odata.type": "#Microsoft.OutlookServices.Contact",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.ContactDeleted
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ContactDeleted",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Contacts/<contact-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "deleted",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<contact id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Contacts('<contact id>')",
"@odata.type": "#Microsoft.OutlookServices.Contact",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.MessageCreated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.MessageCreated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Users/<user-id>/Messages/<message-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "created",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "Users/<user-id>/Messages/<message-id>",
"clientState": "<client state>",
"tenantId":"<tenant-id>",
"resourceData": {
"Id": "<message id>",
"@odata.etag": "<tag id>",
"@odata.id": "Users/<user-id>/Messages/<message-id>",
"@odata.type": "#Microsoft.OutlookServices.Message",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.MessageUpdated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.MessageUpdated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Messages/<message-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "updated",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<message id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
"@odata.type": "#Microsoft.OutlookServices.Message",
"OtherResourceData": "<some other resource data>"
}
}
}
حدث Microsoft.Graph.MessageDeleted
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.MessageDeleted",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "Message/<message-id>",
"time": "2024-05-22T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"@odata.type": "#Microsoft.OutlookServices.Notification",
"Id": null,
"SubscriptionExpirationDateTime": "2024-06-22T23:56:30.1307708Z",
"ChangeType": "deleted",
"subscriptionId": "MTE1MTVlYTktMjVkZS00MjY3LWI1YzYtMjg0NzliZmRhYWQ2",
"resource": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
"clientState": "<client state>",
"resourceData": {
"Id": "<message id>",
"@odata.etag": "<tag id>",
"@odata.id": "https://outlook.office365.com/api/beta/Users('userId@tenantId')/Messages('<message id>')",
"@odata.type": "#Microsoft.OutlookServices.Message",
"OtherResourceData": "<some other resource data>"
}
}
}
خصائص الحدث
ويحتوي الحدث على بيانات المستوى الأعلى التالية:
| الخاصية | نوع | الوصف |
|---|---|---|
source |
سلسلة | مصدر حدث المستأجر. هذا الحقل غير قابل للكتابة. توفر واجهة برمجة تطبيقات Microsoft Graph هذه القيمة. |
subject |
سلسلة | مسار يحدده الناشر لموضوع الحدث. |
type |
سلسلة | أحد أنواع الأحداث لمصدر هذا الحدث. |
time |
سلسلة | وقت إنشاء الحدث بناءً على وقت التوقيت العالمي المنسق للمزود |
id |
سلسلة | المعرف الفريد للحدث. |
data |
كائن | حمولة الحدث التي توفر البيانات حول تغيير حالة المورد. |
specversion |
سلسلة | إصدار مواصفات مخطط CloudEvents. |
كائن البيانات له الخصائص التالية:
| الخاصية | نوع | الوصف |
|---|---|---|
changeType |
سلسلة | نوع حالة الموارد تتغير. |
resource |
سلسلة | محدد الموارد الذي أثير من أجله الحدث. |
tenantId |
سلسلة | بطاقة هوية المنظمة التي يحتفظ بها المستخدم أو جهة الاتصال. |
clientState |
سلسلة | بيانات سرية قدمها المستخدم في وقت إنشاء اشتراك Microsoft Azure Active Directory Graph API. |
@odata.type |
سلسلة | نوع تغيير واجهة برمجة التطبيقات Microsoft Azure Active Directory Graph. |
@odata.id |
سلسلة | محدد موارد Microsoft Azure Active Directory Graph API الذي أثير الحدث من أجله. |
id |
سلسلة | محدد الموارد الذي أثير من أجله الحدث. |
organizationId |
سلسلة | معرف المستأجر Outlook. |
eventTime |
سلسلة | الوقت الذي حدثت فيه حالة المورد. |
sequenceNumber |
سلسلة | رقم التسلسل. |
subscriptionExpirationDateTime |
سلسلة | الوقت في تنسيق طلب التغيير (RFC) 3339 الذي تنتهي فيه صلاحية اشتراك واجهة برمجة تطبيقات Graph. |
subscriptionId |
سلسلة | معرف اشتراكMicrosoft Azure Active Directory Graph API. |
tenantId |
سلسلة | معرف المستأجر Outlook. |
otherResourceData |
سلسلة | عنصر نائب يمثل خاصية ديناميكية واحدة أو أكثر قد يتم تضمينها في الحدث. |
الخطوات التالية
- للحصول على مقدمة عن أحداث شركاء Azure Event Grid's Partner راجع نظرة عامة على Partner Events
- للحصول على معلومات حول كيفية الاشتراك في Microsoft Graph API لتلقي أحداث Outlook، راجع اشترك في أحداثMicrosoft Azure Active Directory Graph .
- للحصول على مَعلومات حول معالجات أحداث Azure Event Grid، راجع معالجات الأحداث.
- لمزيد من المعلومات حول إنشاء اشتراك Azure Event Grid، راجع قم بإنشاء اشتراك الحدث و مخطط اشتراك Event Grid .
- للحصول على معلومات حول كيفية تكوين اشتراك الحدث لتحديد الأحداث المحددة التي سيتم تسليمها، راجع تصفية الحدث. قد تحتاج أيضا إلى الرجوع إلى أحداث التصفية.