Операции EWS в Exchange
Сведения об операциях EWS, доступных в Exchange.
Получить доступ к данным в хранилище Exchange вы можете с помощью множества операций веб-служб Exchange (EWS). Статьи в этом разделе описывают общую структуру запросов, ответов и сообщений об ошибочных ответах, касающихся операций EWS, а также содержат примеры XML для каждой такой операции. В них кратко рассмотрены структуры сообщений, которыми обмениваются клиент и сервер. Эти сведения позволят отладить структуры сообщений, а также узнать, какие действия доступны в запросе EWS. Дополнительные сведения о том, что представляет собой структура XML, см. в статье XML-элементы EWS в Exchange.
Функциональность EWS связана с версией схемы. Новые версии схемы EWS вводятся в новых выпусках Exchange Server или Exchange Online. Элемент RequestServerVersion содержит атрибут Version, который сопоставляет версию сервера с версией схемы. В данной статье указано, когда была введена каждая операция. Для использования определенных возможностей операций может потребоваться более поздняя версия службы. Версионирование схем позволяет клиентам, разработанным для старой версии веб-служб Exchange, работать с новой их версией.
Целевым объектом этих операций может быть конечная точка EWS, которая обслуживает почтовый ящик. Вы можете перейти к конечной точке EWS, используя URL-адрес, похожий по структуре на http://<clientaccessserver.com>/ews/exchange.asmx, где <clientaccessserver> — это сервер клиентского доступа Exchange, который обслуживает ваш почтовый ящик. Получить URL-адрес сервера клиентского доступа, обслуживающего почтовый ящик, можно с помощью службы автообнаружения. Дополнительные сведения об автообнаружение см. в разделе Автообнаружения для Exchange.
Операции обнаружения электронных данных
Операции обнаружения электронных данных позволяют выполнять поиск в случае удержания по юридическим причинам, а также определять данные почтового ящика, которые невозможно индексировать и возвратить в результатах поиска для обнаружения.
В таблице ниже перечислены операции обнаружения электронных данных.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetDiscoverySearchConfiguration |
Exchange 2013 |
| Операция GetHoldOnMailboxes |
Exchange 2013 |
| Операция GetNonIndexableItemDetails |
Exchange 2013 |
| Операция GetNonIndexableItemStatistics |
Exchange 2013 |
| Операция GetSearchableMailboxes |
Exchange 2013 |
| Операция SearchMailboxes |
Exchange 2013 |
| Операция SetHoldOnMailboxes |
Exchange 2013 |
Операции с данными почтовых ящиков Exchange
Операции с данными почтовых ящиков Exchange позволяют клиентам обрабатывать и упорядочивать папки, вложения и другие элементы, а также выполнять разрешение неоднозначных имен и расширение списков рассылки. Операции с данными почтовых ящиков Exchange включают операции с папками, вложениями, другими элементами, а также служебными программами.
В таблице ниже перечислены операции с данными почтовых ящиков Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция ArchiveItem |
Exchange 2013 |
| CreateItem Operation |
Exchange 2007 |
| CopyItem Operation |
Exchange 2007 |
| Операция DeleteItem |
Exchange 2007 |
| FindItem Operation |
Exchange 2007 |
| GetItem Operation |
Exchange 2007 |
| Операция MarkAllItemsAsRead |
Exchange 2013 |
| MoveItem Operation |
Exchange 2007 |
| SendItem Operation |
Exchange 2007 |
| UpdateItem Operation |
Exchange 2007 |
В таблице ниже перечислены операции с папками данных в почтовых ящиках Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| CreateFolder Operation |
Exchange 2007 |
| Операция CreateFolderPath |
Exchange 2013 |
| Операция CreateManagedFolder |
Exchange 2007. Вместо этой возможности в Exchange 2010 и более поздних версий используются другие. Дополнительные сведения о переходе на использование тегов хранения и политик для управления записями обмена сообщениями см. в разделе Миграция из управляемых папок. |
| Операция CopyFolder |
Exchange 2007 |
| Операция DeleteFolder |
Exchange 2007 |
| Операция EmptyFolder |
Exchange 2010 |
| FindFolder Operation |
Exchange 2007 |
| GetFolder Operation |
Exchange 2007 |
| Операция MoveFolder |
Exchange 2007 |
| Операцию UpdateFolder |
Exchange 2007 |
В таблице ниже перечислены операции с вложениями в почтовых ящиках Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция CreateAttachment |
Exchange 2007 |
| Операция GetAttachment |
Exchange 2007 |
| Операция DeleteAttachment |
Exchange 2007 |
В таблице ниже перечислены операции с напоминаниями в почтовых ящиках Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetReminders |
Exchange 2013 |
| Операция PerformReminderAction |
Exchange 2013 |
В таблице ниже перечислены операции с беседами в почтовых ящиках Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция ApplyConversationAction |
Exchange 2010 с пакетом обновления 1 (SP1) |
| FindConversation Operation |
Exchange 2010 SP1 |
| GetConversationItems operation |
Exchange 2013 |
В таблице ниже перечислены операции с использованием служебных программ в почтовых ящиках Exchange.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция ConvertId |
Exchange 2007 с пакетом обновления 1 (SP1) |
| Операция ExpandDL |
Exchange 2007 |
| Операция GetUserPhoto |
Exchange 2013. Эта операция может выполняться как с помощью REST, так и с помощью протокола SOAP. |
| MarkAsJunk Operation |
Exchange 2013 |
| Операция ResolveNames |
Exchange 2007 |
| Операция GetPasswordExpirationDate |
Exchange 2010 SP1 |
Операции проверки доступности
Операции проверки доступности повышают удобство работы с календарем и обмена сведениями о доступности, так как предоставляют защищенные, актуальные и полные сведения о доступности. Сведения о доступности критически важны при планировании собраний. Поэтому операции проверки доступности обеспечивают его эффективность.
В таблице ниже перечислены операции проверки доступности.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetUserAvailability |
Exchange 2007 |
| Операция GetRoomLists |
Exchange 2010 |
| Операция GetRooms |
Exchange 2010 |
| Операция GetUserOofSettings |
Exchange 2007 |
| Операция SetUserOofSettings |
Exchange 2007 |
Операции массовой передачи данных
С помощью операций массовой передачи данных клиенты могут выполнять потоковую передачу элементов в почтовый ящик и из него.
В таблице ниже перечислены операции массовой передачи данных.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция UploadItems |
Exchange 2010 SP1 |
| Операция ExportItems |
Exchange 2010 SP1 |
Операции управления делегированием
С помощью операций управления делегированием клиенты могут добавлять, получать, обновлять и удалять делегатов в почтовых ящиках.
В таблице ниже перечислены операции управления делегированием.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция AddDelegate |
Exchange 2007 с пакетом обновления 1 (SP1) |
| Операция GetDelegate |
Exchange 2007 SP1 |
| Операция UpdateDelegate |
Exchange 2007 SP1 |
| Операция RemoveDelegate |
Exchange 2007 SP1 |
Операции с правилами для папки "Входящие"
Операции с правилами для папки "Входящие" позволяют клиентам получать правила для папки "Входящие" и обновлять их для сообщений на сервере. Правила для папки "Входящие" — это наборы условий и связанных с ними действий, с помощью которых клиенты могут автоматически упорядочивать и классифицировать сообщения, доставляемые в папки, а также выполнять с ними действия.
В таблице ниже перечислены операции с правилами для папки "Входящие"
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetInboxRules |
Exchange 2010 SP1 |
| Операция UpdateInboxRules |
Exchange 2010 SP1 |
Операции управления почтовыми приложениями
Операции управления почтовыми приложениями позволяют управлять почтовыми приложениями для Outlook. С помощью этих операций можно устанавливать, удалять и отключать почтовые приложения, доступные для Outlook Web App и Outlook 2013, а также получать о них информацию.
В таблице ниже перечислены операции управления почтовыми приложениями.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция DisableApp |
Exchange 2013 |
| Операция GetAppManifests |
Exchange 2013 |
| Операция GetAppMarketplaceUrl |
Exchange 2013 |
| Операция GetClientAccessToken |
Exchange 2013 |
| Операция InstallApp |
Exchange 2013 |
| Операция UninstallApp |
Exchange 2013 |
Операция с подсказками электронной почты
Операция с подсказками электронной почты позволяет клиентам запрашивать у сервера сведения о почтовых ящиках получателей, когда автор составляет сообщение. В таблице ниже указана операция с подсказками электронной почты.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetMailTips |
Exchange 2010 |
Операции отслеживания сообщений
С помощью операций отслеживания сообщений клиенты могут находить сообщения, соответствующие определенным условиям, и получать подробные сведения об отслеживании каждого сообщения в отчетах об отслеживании сообщений.
В таблице ниже перечислены операции отслеживания сообщений.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция FindMessageTrackingReport |
Exchange 2010 |
| Операция GetMessageTrackingReport |
Exchange 2010 |
Операции с уведомлениями
Операции с уведомлениями сообщают клиентскому приложению о событиях, связанных с элементами и папками в определенном почтовом ящике. Модель подписки может базироваться на push- и pull-технологии, а также потоковой передаче данных.
В таблице ниже перечислены операции с уведомлениями.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetEvents |
Exchange 2007 |
| Операция GetStreamingEvents |
Exchange 2010 SP1 |
| Операции подписки |
Exchange 2007 |
| Отписаться операции |
Exchange 2007 |
Операции с пользователями
При использовании операции с пользователями доступен интерфейс, с помощью которого можно находить и получать сведения о связанном контакте. В таблице ниже перечислены операции с пользователями.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция FindPeople |
Exchange 2013 |
| Операция GetPersona |
Exchange 2013 |
Операция с политиками хранения
Операция с политиками хранения предоставляет список всех тегов хранения, связанных с политикой хранения пользователя.
В таблице ниже указана операция с политикой хранения.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetUserRetentionPolicyTags |
Exchange 2013 |
Операция с конфигурацией служб
Операция с конфигурацией служб позволяет клиентам получать сведения о конфигурации для служб единой системы обмена сообщениями, правил защиты, подсказок политики и подсказок электронной почты.
В таблице ниже указана операция с конфигурацией служб.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetServiceConfiguration |
Exchange 2010 |
Операции общего доступа
С помощью операций общего доступа клиенты могут обмениваться данными календарей и контактов.
В таблице ниже перечислены операции общего доступа.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| CreateItem (AcceptSharingInvitation) |
Exchange 2010. Хотя операция CreateItem применима ко всем версиям EWS, объект ответа AcceptSharingInvitation применим только к EWS в Exchange 2010 и более поздних версий. |
| Операция GetSharingFolder |
Exchange 2010 |
| Операция GetSharingMetadata |
Exchange 2010 |
| Операция RefreshSharingFolder |
Exchange 2010 |
Операции синхронизации
Операции синхронизации предоставляют односторонне синхронизированную кэшированную копию папок и элементов пользователя.
В таблице ниже перечислены операции синхронизации.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция SyncFolderHierarchy |
Exchange 2007 |
| Операция SyncFolderItems |
Exchange 2007 |
Операция с часовыми поясами
Операция с часовыми поясами позволяет клиентам получить список определений часовых поясов, поддерживаемых сервером.
В таблице ниже указана операция с часовыми поясами.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция GetServerTimeZones |
Exchange 2010 |
Операции с единой системой обмена сообщениями
При помощи операций с единой системой обмена сообщениями клиенты могут читать сведения о свойствах единой системы обмена сообщениями и воспроизводить сообщения голосовой почты по телефону.
В таблице ниже перечислены операции с единой системой обмена сообщениями.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция DisconnectPhoneCall |
Exchange 2010 |
| Операция GetPhoneCallInformation |
Exchange 2010 |
| Операция PlayOnPhone (EWS) |
Exchange 2010 |
Используйте операцию GetServiceConfiguration , чтобы получить сведения о конфигурации единой системы обмена сообщениями для почтового ящика. Для приложений единой системы обмена сообщениями, предназначенных для Exchange 2007, используйте веб-службу единой системы обмена сообщениями. Дополнительные сведения см. в статье Справочник по веб-службе единой системы обмена сообщениями для Exchange.
Операции с единым хранилищем контактов
Единое хранилище контактов позволяет использовать общий список контактов для всех продуктов Office и выполняет роль точки интеграции для сторонних приложений, чтобы они использовали то же самое хранилище контактов. С помощью него пользователи и приложения могут хранить сведения о контактах, управлять ими, получать к ним доступ, а также открывать глобальный доступ к ним в Lync, Exchange 2013, Outlook, Outlook Web App и других приложениях, в которых реализован доступ к единому хранилищу контактов. Exchange выполняет функцию хранилища содержимого для единого хранилища контактов.
В таблице ниже перечислены операции с единым хранилищем контактов.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция AddNewImContactToGroup |
Exchange 2013 |
| Операция AddImContactToGroup |
Exchange 2013 |
| Операция AddImGroup |
Exchange 2013 |
| Операция AddNewTelUriContactToGroup |
Exchange 2013 |
| Операция AddDistributionGroupToImList |
Exchange 2013 |
| Операция GetImItemList |
Exchange 2013 |
| Операция GetImItems |
Exchange 2013 |
| Операция RemoveContactFromImList |
Exchange 2013 |
| Операция RemoveImContactFromGroup |
Exchange 2013 |
| Операция RemoveDistributionGroupFromImList |
Exchange 2013 |
| Операция RemoveImGroup |
Exchange 2013 |
| Операция SetImGroup |
Exchange 2013 |
Операции с конфигурациями пользователей
Операции с конфигурациями пользователей позволяют клиентам создавать, удалять, получать и обновлять сведения о конфигурации пользователей.
В таблице ниже перечислены операции с конфигурациями пользователей.
| Имя операции | Версия, где параметр был представлен |
|---|---|
| Операция CreateUserConfiguration |
Exchange 2010 |
| Операция DeleteUserConfiguration |
Exchange 2010 |
| Операция GetUserConfiguration |
Exchange 2010 |
| Операция UpdateUserConfiguration |
Exchange 2010 |