Microsoft Outlook-gebeurtenissen

Artikel
06/01/2023

Dit artikel bevat de eigenschappen en het schema voor Microsoft Outlook-gebeurtenissen, die worden gepubliceerd door Microsoft Graph API. Zie CloudEvents-schema voor een inleiding tot gebeurtenisschema's.

Beschikbare gebeurtenistypen

Deze gebeurtenissen worden geactiveerd wanneer een Outlook-gebeurtenis of een Outlook-contactpersoon wordt gemaakt, bijgewerkt of verwijderd of door deze resources te gebruiken met behulp van Microsoft Graph API.

Gebeurtenisnaam	Description
Microsoft.Graph.EventCreated	Wordt geactiveerd wanneer een gebeurtenis in Outlook wordt gemaakt.
Microsoft.Graph.EventUpdated	Wordt geactiveerd wanneer een gebeurtenis in Outlook wordt bijgewerkt.
Microsoft.Graph.EventDeleted	Wordt geactiveerd wanneer een gebeurtenis in Outlook wordt verwijderd.
Microsoft.Graph.ContactCreated	Wordt geactiveerd wanneer een contactpersoon in Outlook wordt gemaakt.
Microsoft.Graph.ContactUpdated	Wordt geactiveerd wanneer een contactpersoon in Outlook wordt bijgewerkt.
Microsoft.Graph.ContactDeleted	Wordt geactiveerd wanneer een contactpersoon in Outlook wordt verwijderd.

Voorbeeld van gebeurtenis

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis naar abonnerende bestemmingen. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke Outlook-gebeurtenis.

Microsoft.Graph.EventCreated-gebeurtenis

{
	"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-gebeurtenis

{
	"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-gebeurtenis

{
	"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-gebeurtenis

{
	"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-gebeurtenis

{
	"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-gebeurtenis

{
	"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>"
		}
	}
}

Gebeurteniseigenschappen

Een gebeurtenis heeft de volgende gegevens op het hoogste niveau:

Eigenschap	Type	Description
`source`	tekenreeks	De tenant-gebeurtenisbron. Dit veld kan niet worden geschreven. Microsoft Graph API biedt deze waarde.
`subject`	tekenreeks	Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
`type`	tekenreeks	Een van de gebeurtenistypen voor deze gebeurtenisbron.
`time`	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
`id`	tekenreeks	Unieke id voor de gebeurtenis.
`data`	object	Nettolading van gebeurtenis die de gegevens over de wijziging van de resourcestatus levert.
`specversion`	tekenreeks	De schemaspecificatieversie van CloudEvents.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap	Type	Description
`changeType`	tekenreeks	Het type resourcestatus verandert.
`resource`	tekenreeks	De resource-id waarvoor de gebeurtenis is gegenereerd.
`tenantId`	tekenreeks	De organisatie-id waar de gebruiker of contactpersoon wordt bewaard.
`clientState`	tekenreeks	Een geheim dat door de gebruiker is opgegeven op het moment dat het Graph API het abonnement maakt.
`@odata.type`	tekenreeks	Het Graph API type wijzigen.
`@odata.id`	tekenreeks	De Graph API resource-id waarvoor de gebeurtenis is gegenereerd.
`id`	tekenreeks	De resource-id waarvoor de gebeurtenis is gegenereerd.
`organizationId`	tekenreeks	De Outlook-tenant-id.
`eventTime`	tekenreeks	Het tijdstip waarop de resourcestatus heeft plaatsgevonden.
`sequenceNumber`	tekenreeks	Een volgnummer.
`subscriptionExpirationDateTime`	tekenreeks	De tijd in RFC 3339-indeling waarop het Graph API-abonnement verloopt.
`subscriptionId`	tekenreeks	De Graph API abonnements-id.
`tenantId`	tekenreeks	De Outlook-tenant-id.
`otherResourceData`	tekenreeks	Tijdelijke aanduiding voor een of meer dynamische eigenschappen die in de gebeurtenis kunnen worden opgenomen.

Volgende stappen

Zie Overzicht van partnerevenementen voor een inleiding tot partnerevenementen van Azure Event Grid
Zie Abonneren op Azure Graph API gebeurtenissen voor informatie over het abonneren op Microsoft Graph API om Outlook-gebeurtenissen te ontvangen.
Zie gebeurtenis-handlers voor meer informatie over Azure Event Grid gebeurtenis-handlers.
Zie Gebeurtenisabonnement maken en Event Grid-abonnementsschema voor meer informatie over het maken van een Azure Event Grid-abonnement.
Raadpleeg Gebeurtenisfiltering voor informatie over het configureren van een gebeurtenisabonnement om specifieke gebeurtenissen te selecteren die moeten worden geleverd. Mogelijk wilt u ook verwijzen naar filter gebeurtenissen.