New features in the EWS Managed API 2.0

eDiscovery and the EWS Managed API

The electronic discovery (eDiscovery) feature is a federated query web service that enables external applications, such as SharePoint 2013, to perform queries of Exchange data. Discovery consists of several phases, including identifying and preserving key data, culling down and reviewing the data, and producing data in court. eDiscovery queries facilitate the discovery process by providing a single discovery workflow across Exchange and SharePoint. The following ExchangeService object members are entry points into the eDiscovery feature:

• SearchMailboxes(IEnumerable<MailboxQuery>, SearchResultType, String, SortDirection, Int32, SearchPageDirection, String)

• SetHoldOnMailboxes(String, HoldAction, String, [])

• GetSearchableMailboxes(String, Boolean)

• GetHoldOnMailboxes(String)

The EWS Managed API also provides two methods that enable you to get information about items that cannot be searched via eDiscovery:

• GetNonIndexableItemStatistics([])

• GetNonIndexableItemDetails([])

Archiving and the EWS Managed API

In addition to the basic EWS functionality that can be used for archiving data maintained in the Exchange store, the new ArchiveItem operation enables item-level archiving into an archive mailbox. You can use the ArchiveItems(IEnumerable<ItemId>, FolderId) method to archive one or more items, including tasks, email messages, contacts, or other Exchange store items, into an archive mailbox.

Retention policies and the EWS Managed API

In Exchange 2013, user retention policy tags can be retrieved from the server. This enables clients to implement user-based retention tags on folders and folder items. The GetUserRetentionPolicyTags() method provides the policy information. You can access policy tags from the RetentionDate property on email message, contact, meeting, and task items, and from the PolicyTag and PolicyTag property on folders and items.

Mail apps for Outlook

The EWS Managed API now provides methods that you can use to manage mail apps for Outlook. You can use the following methods to install, uninstall, disable, and get information about mail apps that are available for Outlook Web App and Outlook 2013:

• DisableApp(String, DisableReasonType)

• GetAppManifests()

• GetAppMarketplaceUrl()

• GetClientAccessToken(IEnumerable<KeyValuePair<String, ClientAccessTokenType>>)

• InstallApp(Stream)

• UninstallApp(String)

OAuth validation

The EWS Managed API now includes the new partner DLL, Microsoft.Exchange.WebServices.Auth.dll. You can use this DLL to validate user identity tokens sent from an Exchange server.

Other new features in the EWS Managed API

The EWS Managed API includes the following functionality to support new scenarios:

• New client statistics reporting for clients that target Exchange Online. Additionally, the new RequestId header is returned in every response so that you can now access the unique request ID from the HttpResponseHeaders on the ExchangeService object. This enables you to easily associate a request with a log entry on the server.

• A new MarkAsJunk(IEnumerable<ItemId>, Boolean, Boolean) method, which enables you to mark items as junk and block senders.

• A new GetConversationItems(ConversationId, PropertySet, String, IEnumerable<FolderId>, Nullable<ConversationSortOrder>) method, which enables you to request all the items in a conversation, along with the conversation node structure.

• Support for server-to-server scenarios by means of the OAuthCredentials object.

• Pretty-printing for trace logging.

• New user settings added to the UserSettingName type.

• A new ManagementRoles property, which restricts access based on group membership.

Additional resources

• Explore the EWS Managed API 2.0

• Differences between the EWS Managed API 2.0 and EWS

• EWS Managed API 2.0 concepts

• Working with the EWS Managed API 2.0

• EWS Managed API reference

• Exchange 2013: 101 code samples