Table of contents
TOC
Свернуть оглавление
Развернуть оглавление
Последнее обновление: 20.06.2018

Примечания к выпуску API Office 365 REST за апрель 2015 г.

Эта документация охватывает функции предварительной версии. Для получения информации о работе с функциями предварительной версии см. статью Функции предварительной версии для разработчиков на платформе Office 365.

Область применения: Office 365

В этой статье приведены сведения о новых возможностях для разработчиков, которые доступны в выпуске API Office 365 за апрель 2015 г., а также рассмотрены известные проблемы. Для получения дополнительной информации о разработке для Office 365 см. Обзор платформы API Office 365.

Новые функции GA в API Office 365

Общедоступны следующие новые функции API Office 365.

  • Поддержка общего доступа к ресурсам независимо от источника (CORS), включая следующие ресурсы.
    • Поддержка CORS в Exchange
    • Поддержка CORS в SharePoint
    • Поддержка CORS в Microsoft Azure Active Directory (Azure AD)
  • Поддержка AppOnly в Exchange
  • Поддержка AppOnly в SharePoint
  • Поддержка областей проверки подлинности в SharePoint (таксономия, поиск, UPA)
  • Обновления API-интерфейсов Outlook, включая следующие интерфейсы.

Новые функции предварительной версии в API Office 365

Доступны следующие новые функции предварительной версии API Office 365.

  • API Заметки (предварительная версия)
  • API OneDrive (предварительная версия)
  • Unified API Office 365 (предварительная версия)
  • Office graph (предварительная версия)
  • API Video REST (предварительная версия)
  • Для API Outlook:
    • REST API уведомлений Outlook (предварительная версия) для получения уведомлений о почте, контактах и событиях
    • API REST фотографии пользователя Outlook (предварительная версия) для получения фотографий с высокой четкостью для авторизованных пользователей
    • Расширенные свойства по почте

Для получения дополнительной информации о новых функциях предварительной версии см. статью Функции предварительной версии для разработчиков на платформе Office 365.

Известные проблемы unified API Office 365 (предварительная версия)

Далее представлены известные проблемы unified API Office 365 (предварительная версия).

Доступность аналитики унифицированных групп и социальной активности

В предварительной версии доступ к событиям и беседам унифицированной группы по всему миру может занять некоторое время в unified API.

Ограничения сущности пользователя

Отсутствие мгновенного доступа после создания

Пользователей можно создавать немедленно с помощью POST в сущности пользователя. Для доступа к службам Office 365 пользователю сначала необходимо назначить лицензию Office 365. Даже при этом, вследствие распространяемой природы службы, файлы, сообщения и сущности событий могут быть доступны этому пользователю через 15 минут с помощью unified API. В течение этого времени приложения будут получать сообщение об ошибке 404 HTTP.

Настройка расширенных свойств профиля пользователя

Настройка расширенных свойств профиля пользователя, например "Обо мне" и "Навыки", в настоящее время не поддерживается.

Ограничения сущности группы

Нет мгновенного доступа к содержимому после создания

Унифицированные группы можно создавать немедленно с помощью POST в сущности группы. Однако для унифицированной группы, созданной с помощью unified API, доступ к связанному содержимому, не будет легко доступен. В приложениях можно будет добавлять содержимое в группы (файлы, беседы и события) после установленного времени, как указано далее.

  • Для бесед и событий: до 40 минут после создания группы
  • Для файлов: до 24 часов после создания группы

До этого времени при попытке обновить унифицированную группу содержимым отобразится сообщение об ошибке 500 HTTP. Для приложений проверки обоснованности концепции, которые используют unified API Office 365, рекомендуется использовать Outlook или веб-приложение Outlook для создания унифицированной группы, если требуется немедленный доступ к содержимому.

Политика

С помощью unified API Office 365 можно создать единую группу и присвоить ей название в обход групповой политики, настроенной через Outlook Web App. Для приложений проверки обоснованности концепции, которые используют unified API Office 365, рекомендуется использовать Outlook или Outlook Web App для создания унифицированных групп.

Области разрешений

Unified API Office 365 предоставляет две области разрешений для унифицированных групп:

  • Group.Read.All
  • Group.ReadWrite.All

Эти области предоставляют доступ к функциям управления группами (перечисление групп, членов группы) и содержимому в группе (беседы и события). Однако для доступа к файлам в унифицированной группе необходимо также запросить область разрешения Sites.Read.All или Site.ReadWrite.All. Для получения дополнительной информации об областях разрешений см. Начало работы с Unified API Office 365 (предварительная версия).

Контакты

Личные контакты в настоящее время не поддерживаются. Поддерживаются только организационные контакты.

Операции OData

Не поддерживаются фильтрация и поиск для нескольких рабочих нагрузок. Поиск по полному тексту (с помощью команды $search) доступен только для пользователей, групп, организационных контактов, сообщений и событий.

Соглашение об уровне обслуживания

Величина задержки при ответе на запрос пользователя для 95 процентиля может быть довольно большой.

Несоответствия схемы

Канонические идентификаторы для участников и получателей недоступны.

Загрузка файлов в определенную папку

Для загрузки файла в определенную папку приложению потребуется выполнить три действия.

  1. Создание нового файла в корневой папке.

  2. Загрузка содержимого файла.

  3. Перемещение файла в целевую папку.

Действия 2 и 3 являются взаимозаменяемыми. Кроме того, для создания папки в другой папке необходимо создать новую папку в корневой папке, а затем переместить ее в необходимую целевую папку. Эти проблемы будут устранены, чтобы для выполнения этих операций требовался один вызов.

Потоковая передача файла и содержимого

Максимальный размер отправляемых и скачиваемых файлов (файлов в унифицированных группах, почтовых вложениях и на дисках) составляет 1 МБ.

Совместимость регистрации приложений

В течение предварительного просмотра необходимо зарегистрировать новые приложения для вызова unified API Office 365. В качестве веб-приложений поддерживаются однопользовательские и многопользовательские приложения. Приложения собственного клиента можно использовать только в рамках клиента, на котором зарегистрировано приложение.

Известные проблемы API Outlook

Не удается установить напоминания для событий

В настоящее время при создании или обновлении событий не удастся установить напоминание из клиентской библиотеки или напрямую с помощью REST. Поле напоминания о событии не обновляется, однако сообщение об ошибке не отображается.

Дополнительные ресурсы

© 2018 Microsoft