События Microsoft Outlook

Статья
06/01/2023

Эта статья описывает свойства и схему для событий Microsoft Outlook, опубликованных API Graph. Общие сведения о схемах событий см. в разделе Схема CloudEvents.

Доступные типы событий

Эти события активируются при создании, обновлении или удалении контакта или события Outlook, а также при работе с этими ресурсами с помощью API Graph.

Имя события	Описание
Microsoft.Graph.EventCreated	Активируется при создании события в Outlook.
Microsoft.Graph.EventUpdated	Активируется при обновлении события в Outlook.
Microsoft.Graph.EventDeleted	Активируется при удалении события в Outlook.
Microsoft.Graph.ContactCreated	Активируется при создании контакта в Outlook.
Microsoft.Graph.ContactUpdated	Активируется при обновлении контакта в Outlook.
Microsoft.Graph.ContactDeleted	Активируется при удалении контакта в Outlook.

Пример события

При активации события служба Сетки событий отправляет данные о нем в подписанные точки назначения. В этом разделе приведен пример того, как будут выглядеть данные для каждого события 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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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": "2022-05-24T22:24:31.3062901Z",
	"datacontenttype": "application/json",
	"specversion": "1.0",
	"data": {
		"@odata.type": "#Microsoft.OutlookServices.Notification",
		"Id": null,
		"SubscriptionExpirationDateTime": "2019-02-14T23: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>"
		}
	}
}

Свойства события

Событие содержит следующие высокоуровневые данные:

Свойство	Тип	Описание
`source`	строка	Источник событий арендатора. Это поле защищено от записи. Это значение предоставляет API Graph.
`subject`	строка	Определенный издателем путь к субъекту событий.
`type`	строка	Один из типов событий для этого источника событий.
`time`	строка	Время создания события определяется на основе времени поставщика в формате UTC.
`id`	строка	Уникальный идентификатор события.
`data`	object	Полезные данные события, предоставляющие данные об изменении состояния ресурса.
`specversion`	строка	Версия спецификации схемы CloudEvents.

Объект данных имеет следующие свойства:

Свойство	Тип	Описание
`changeType`	строка	Тип изменения состояния ресурса.
`resource`	строка	Идентификатор ресурса, для которого было создано событие.
`tenantId`	строка	Идентификатор организации, в которой хранится пользователь или контакт.
`clientState`	строка	Секрет, предоставленный пользователем во время создания API Graph подписки.
`@odata.type`	строка	Тип изменения API Graph.
`@odata.id`	строка	Идентификатор ресурса, для которого было создано событие.
`id`	строка	Идентификатор ресурса, для которого было создано событие.
`organizationId`	строка	Идентификатор арендатора Outlook.
`eventTime`	строка	Время возникновения состояния ресурса.
`sequenceNumber`	строка	Порядковый номер.
`subscriptionExpirationDateTime`	строка	Время в формате RFC 3339, в течение которого истекает срок действия подписки API Graph.
`subscriptionId`	строка	Идентификатор подписки API Graph.
`tenantId`	строка	Идентификатор арендатора Outlook.
`otherResourceData`	строка	Заполнитель, представляющий одно или несколько динамических свойств, которые могут быть включены в событие.

Дальнейшие действия

Общие сведения о событиях партнеров Сетки событий Azure см. в Обзоре событий партнеров
Сведения о том, как подписаться на API Graph для получения событий Outlook, см. в статье Подписка на события API Graph Azure.
Сведения о обработчиках событий Сетки событий Azure см. в разделе обработчики событий.
Дополнительные сведения о создании подписки на Сетку событий Azure см. в статьях создание подписки на события и схема подписки на Сетку событий.
Сведения о настройке подписки на события для выбора определенных событий для доставки см. в фильтрации событий. Вы также можете обратиться к разделу фильтрация событий.