Události aplikace Microsoft Outlook

Článek
06/01/2023

Tento článek obsahuje vlastnosti a schéma pro události aplikace Microsoft Outlook, které jsou publikovány microsoft Graph API. Úvod do schémat událostí najdete v tématu Schéma CloudEvents.

Dostupné typy událostí

Tyto události se aktivují při vytvoření, aktualizaci nebo odstranění outlookové události nebo kontaktu v Outlooku nebo při provozu přes tyto prostředky pomocí Microsoft Graph API.

Název události	Popis
Microsoft.Graph.EventCreated	Aktivuje se při vytvoření události v Outlooku.
Microsoft.Graph.EventUpdated	Aktivuje se při aktualizaci události v Outlooku.
Microsoft.Graph.EventDeleted	Aktivuje se při odstranění události v Outlooku.
Microsoft.Graph.ContactCreated	Aktivuje se při vytvoření kontaktu v Outlooku.
Microsoft.Graph.ContactUpdated	Aktivuje se při aktualizaci kontaktu v Outlooku.
Microsoft.Graph.ContactDeleted	Aktivuje se při odstranění kontaktu v Outlooku.

Příklad události

Při aktivaci události služba Event Grid odešle data o této události do odebíraných cílů. Tato část obsahuje příklad toho, jak by tato data vypadala pro jednotlivé události Outlooku.

Událost 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>"
		}
	}
}

Událost 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>"
		}
	}
}

Událost 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>"
		}
	}
}

Událost 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>"
		}
	}
}

Událost 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>"
		}
	}
}

Událost 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>"
		}
	}
}

Vlastnosti události

Událost obsahuje následující data nejvyšší úrovně:

Vlastnost	Typ	Description
`source`	řetězec	Zdroj událostí tenanta. Toto pole není zapisovatelné. Tuto hodnotu poskytuje Microsoft Graph API.
`subject`	řetězec	Cesta k předmětu události, kterou definuje vydavatel.
`type`	řetězec	Jeden z typů událostí pro tento zdroj událostí.
`time`	řetězec	Čas vygenerování události na základě času UTC poskytovatele
`id`	řetězec	Jedinečný identifikátor události.
`data`	object	Datová část události, která poskytuje data o změně stavu prostředku.
`specversion`	řetězec	Verze specifikace schématu CloudEvents.

Datový objekt má následující vlastnosti:

Vlastnost	Typ	Description
`changeType`	řetězec	Typ změny stavu prostředku.
`resource`	řetězec	Identifikátor prostředku, pro který byla událost vyvolána.
`tenantId`	řetězec	ID organizace, ve které je uživatel nebo kontakt uložen.
`clientState`	řetězec	Tajný kód poskytnutý uživatelem při vytváření předplatného Graph API.
`@odata.type`	řetězec	Typ Graph API změnit.
`@odata.id`	řetězec	Identifikátor Graph API prostředku, pro který byla událost vyvolána.
`id`	řetězec	Identifikátor prostředku, pro který byla událost vyvolána.
`organizationId`	řetězec	Identifikátor tenanta aplikace Outlook.
`eventTime`	řetězec	Čas, kdy došlo ke stavu prostředku.
`sequenceNumber`	řetězec	Pořadové číslo.
`subscriptionExpirationDateTime`	řetězec	Čas ve formátu RFC 3339, kdy vyprší platnost předplatného Graph API.
`subscriptionId`	řetězec	Identifikátor Graph API předplatného.
`tenantId`	řetězec	Identifikátor tenanta aplikace Outlook.
`otherResourceData`	řetězec	Zástupný symbol představující jednu nebo více dynamických vlastností, které mohou být zahrnuty do události.

Další kroky

Úvod k partnerským událostem Azure Event Grid najdete v tématu Přehled partnerských událostí.
Informace o tom, jak se přihlásit k odběru Microsoft Graph API přijímat události Outlooku, najdete v tématu přihlášení k odběru událostí Azure Graph API.
Informace o Azure Event Grid obslužných rutinách událostí najdete v tématu Obslužné rutiny událostí.
Další informace o vytvoření odběru Azure Event Grid najdete v tématu Vytvoření odběru událostí a schématu odběru služby Event Grid.
Informace o tom, jak nakonfigurovat odběr událostí pro výběr konkrétních událostí k doručení, najdete v tématu Filtrování událostí. Můžete také odkazovat na události filtrování.