New features in 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([])

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.

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.

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)

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.

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

• Support for sending web requests and receiving web responses from the EWS Managed API. This functionality is enabled by the IEwsHttpWebRequest and IEwsHttpWebRequestFactory types. This enables EWS Managed API clients to implement EWS functionality that is not implemented in the EWS Managed API. For example, for unified contact store operations, you can use the IEwsHttpWebRequest type to send the requests and get the responses while information is passed to and from the EWS Managed API objects. Because the EWS Managed API handles cookies, Autodiscover, and authentication, using the IEwsHttpWebRequest is a much better option than using an autogenerated proxy API.

• 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.

For a list of API-level changes, see New EWS Managed API content.

• Explore the EWS Managed API

• New EWS Managed API content

• Differences between the EWS Managed API and EWS

• EWS Managed API concepts

• Working with the EWS Managed API

• EWS Managed API namespaces