Eventos do Microsoft Outlook

Artigo
06/01/2023

Este artigo fornece as propriedades e o esquema dos eventos do Microsoft Outlook, que são publicados pela Microsoft Graph API. Para obter uma introdução aos esquemas de eventos, veja Esquema cloudEvents.

Tipos de eventos disponíveis

Estes eventos são acionados quando um evento do Outlook ou um contacto do Outlook é criado, atualizado ou eliminado ou ao operar através desses recursos com o Microsoft Graph API.

Nome do evento	Descrição
Microsoft.Graph.EventCreated	Acionado quando é criado um evento no Outlook.
Microsoft.Graph.EventUpdated	Acionado quando um evento no Outlook é atualizado.
Microsoft.Graph.EventDeleted	Acionado quando um evento no Outlook é eliminado.
Microsoft.Graph.ContactCreated	Acionado quando é criado um contacto no Outlook.
Microsoft.Graph.ContactUpdated	Acionado quando um contacto no Outlook é atualizado.
Microsoft.Graph.ContactDeleted	Acionado quando um contacto no Outlook é eliminado.

Evento de exemplo

Quando um evento é acionado, o serviço Event Grid envia dados sobre esse evento para subscrever destinos. Esta secção contém um exemplo do aspeto desses dados para cada evento do Outlook.

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

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

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

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

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

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

Propriedades do evento

Um evento tem os seguintes dados de nível superior:

Propriedade	Tipo	Description
`source`	cadeia (de carateres)	A origem de eventos do inquilino. Este campo não é gravável. O Microsoft Graph API fornece este valor.
`subject`	string	Caminho definido pelo publicador para o assunto do evento.
`type`	string	Um dos tipos de evento para esta origem de eventos.
`time`	string	A hora em que o evento é gerado com base na hora UTC do fornecedor
`id`	string	Identificador exclusivo do evento.
`data`	objeto	Payload de eventos que fornece os dados sobre a alteração do estado do recurso.
`specversion`	string	CloudEvents versão de especificação de esquema.

O objeto de dados tem as seguintes propriedades:

Propriedade	Tipo	Description
`changeType`	cadeia (de carateres)	O tipo de alteração do estado do recurso.
`resource`	string	O identificador de recurso para o qual o evento foi gerado.
`tenantId`	string	O ID da organização onde o utilizador ou contacto é mantido.
`clientState`	string	Um segredo fornecido pelo utilizador no momento da criação da subscrição Graph API.
`@odata.type`	string	O tipo de alteração Graph API.
`@odata.id`	string	O Graph API identificador de recursos para o qual o evento foi gerado.
`id`	string	O identificador de recurso para o qual o evento foi gerado.
`organizationId`	string	O identificador do inquilino do Outlook.
`eventTime`	string	O momento em que ocorreu o estado do recurso.
`sequenceNumber`	string	Um número de sequência.
`subscriptionExpirationDateTime`	string	A hora no formato RFC 3339 em que a subscrição do Graph API expira.
`subscriptionId`	string	O identificador de subscrição Graph API.
`tenantId`	string	O identificador do inquilino do Outlook.
`otherResourceData`	string	Marcador de posição que representa uma ou mais propriedades dinâmicas que podem ser incluídas no evento.

Passos seguintes

Para obter uma introdução aos Eventos de Parceiros do Azure Event Grid, veja Descrição geral dos Eventos de Parceiros
Para obter informações sobre como subscrever o Microsoft Graph API para receber eventos do Outlook, consulte subscrever eventos do Azure Graph API.
Para obter informações sobre Azure Event Grid processadores de eventos, veja processadores de eventos.
Para obter mais informações sobre como criar uma subscrição Azure Event Grid, veja Criar subscrição de eventos e esquema de subscrição do Event Grid.
Para obter informações sobre como configurar uma subscrição de evento para selecionar eventos específicos a serem entregues, consulte a filtragem de eventos. Também pode querer referir-se a eventos de filtro.