Microsoft Outlook 이벤트

아티클
02/12/2024

이 문서에서는 Microsoft Graph API에서 게시되는 Microsoft Outlook 이벤트에 대한 속성과 스키마를 제공합니다. 이벤트 스키마에 대한 소개는 CloudEvents 스키마를 참조하세요.

사용할 수 있는 이벤트 유형

이러한 이벤트는 Outlook 이벤트 또는 Outlook 연락처가 생성, 업데이트 또는 삭제되거나 Microsoft Graph API를 사용하여 해당 리소스를 통해 작동할 때 트리거됩니다.

이벤트 이름	설명
Microsoft.Graph.EventCreated	Outlook에서 이벤트가 생성될 때 트리거됩니다.
Microsoft.Graph.EventUpdated	Outlook에서 이벤트가 업데이트될 때 트리거됩니다.
Microsoft.Graph.EventDeleted	Outlook에서 이벤트가 삭제될 때 트리거됩니다.
Microsoft.Graph.ContactCreated	Outlook에서 연락처가 생성될 때 트리거됩니다.
Microsoft.Graph.ContactUpdated	Outlook에서 연락처가 업데이트될 때 트리거됩니다.
Microsoft.Graph.ContactDeleted	Outlook에서 연락처가 삭제될 때 트리거됩니다.

예제 이벤트

이벤트가 트리거될 때 Event Grid 서비스는 해당 이벤트에 대한 데이터를 구독 대상으로 보냅니다. 이 섹션에는 각 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>"
		}
	}
}

이벤트 속성

이벤트에는 다음과 같은 최상위 데이터가 있습니다.

속성	Type	Description
`source`	string	테넌트 이벤트 원본입니다. 이 필드는 쓸 수 없습니다. Microsoft Graph API는 이 값을 제공합니다.
`subject`	string	게시자가 정의한 이벤트 주체의 경로입니다.
`type`	string	이 이벤트 원본에 대한 이벤트 유형 중 하나입니다.
`time`	string	공급자의 UTC 시간을 기준으로 이벤트가 생성된 시간
`id`	string	이벤트에 대한 고유 식별자입니다.
`data`	개체	리소스 상태 변경에 대한 데이터를 제공하는 이벤트 페이로드입니다.
`specversion`	string	CloudEvents 스키마 사양 버전입니다.

데이터 개체의 속성은 다음과 같습니다.

속성	Type	Description
`changeType`	string	리소스 상태 변경의 유형입니다.
`resource`	string	이벤트가 발생한 리소스 식별자입니다.
`tenantId`	string	사용자 또는 연락처가 보관되는 조직 ID입니다.
`clientState`	string	Graph API 구독을 만들 때 사용자가 제공한 비밀입니다.
`@odata.type`	string	Graph API 변경 형식입니다.
`@odata.id`	string	이벤트가 발생한 Graph API 리소스 식별자입니다.
`id`	string	이벤트가 발생한 리소스 식별자입니다.
`organizationId`	string	Outlook 테넌트 식별자입니다.
`eventTime`	string	리소스 상태가 발생한 시간입니다.
`sequenceNumber`	string	시퀀스 번호.
`subscriptionExpirationDateTime`	string	Graph API 구독이 만료되는 RFC 3339 형식의 시간입니다.
`subscriptionId`	string	Graph API 구독 식별자입니다.
`tenantId`	string	Outlook 테넌트 식별자입니다.
`otherResourceData`	string	이벤트에 포함될 수 있는 하나 이상의 동적 속성을 나타내는 자리 표시자입니다.

다음 단계

Azure Event Grid의 파트너 이벤트에 대한 소개는 파트너 이벤트 개요를 참조하세요.
Microsoft Graph API 구독하여 Outlook 이벤트를 수신하는 방법에 대한 자세한 내용은 Azure Graph API 이벤트 구독을 참조하세요.
Azure Event Grid 이벤트 처리기에 대한 자세한 내용은 이벤트 처리기를 참조하세요.
Azure Event Grid 구독 만들기에 대한 자세한 내용은 이벤트 구독 만들기 및 Event Grid 구독 스키마를 참조하세요.
전달할 특정 이벤트를 선택하도록 이벤트 구독을 구성하는 방법에 대한 자세한 내용은 이벤트 필터링을 참조하세요. 이벤트 필터링을 참조할 수도 있습니다.