مشاركة عبر

أحداث Microsoft ToDo

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث مهمة Microsoft ToDo، والتي يتم نشرها بواسطة Microsoft Graph API. للحصول على مقدمة حول مخططات الأحداث، راجع مخطط CloudEvents.

أنواع الأحداث المتاحة

يتم تشغيل هذه الأحداث عند إنشاء todoTask أو تحديثه أو حذفه عن طريق التشغيل عبر تلك الموارد باستخدام واجهة برمجة تطبيقات Microsoft Graph. لاحظ أنه يمكنك الاشتراك في التغييرات من قائمة مهام معينة فقط.

اسم الحدث ‏‏الوصف
Microsoft.Graph.ToDoCreated يتم تشغيله عند إنشاء todoTask في قائمة مهام Microsoft ToDo.
Microsoft.Graph.ToDoUpdated يتم تشغيله عند تحديث todoTask في قائمة مهام Microsoft ToDo.
Microsoft.Graph.ToDoDeleted يتم تشغيله عند حذف todoTask في قائمة مهام Microsoft ToDo.

مثال حدث

عند تشغيل حدث ما، ترسل خدمة Event Grid بيانات عن هذا الحدث إلى وجهات الاشتراك. يحتوي هذا القسم على مثال لما ستبدو عليه هذه البيانات لكل حدث تنبيه أمان Microsoft.

حدث Microsoft.Graph.ToDoCreated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoCreated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Created",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

حدث Microsoft.Graph.ToDoUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Updated",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

حدث Microsoft.Graph.ToDoDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Deleted",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
     "id": "<ToDoTask-id>",
     "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

خصائص الحدث

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
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 سلسلة محدد الموارد الذي أثير من أجله الحدث.
subscriptionExpirationDateTime سلسلة الوقت في RFC 3339 تنسيق الذي ينتهي عنده الاشتراك في Microsoft Azure Active Directory Graph API.
subscriptionId سلسلة معرف اشتراكMicrosoft Azure Active Directory Graph API.
tenantId سلسلة معرف مستأجر Microsoft Entra.

الخطوات التالية