Тип ресурса mailboxFolder

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет папку в почтовом ящике пользователя, например папку "Входящие", черновики или другие папки, созданные пользователем. Папки могут содержать различные элементы почтового ящика, такие как сообщения, события, контакты, другие элементы Outlook и дочерние папки.

Этот ресурс поддерживает разностный запрос для отслеживания добавочных добавлений, удалений и обновлений путем предоставления разностной функции. Он также поддерживает расширенные свойства с одним и несколькими значениями для хранения пользовательских данных, которые еще не предоставляются в метаданных Microsoft API Graph и доступа к ним.

Методы

Метод	Тип возвращаемых данных	Описание
Список	Коллекция mailboxFolder	Получите все объекты mailboxFolder в указанном почтовом ящике, включая все папки поиска.
Создание	mailboxFolder	Создайте новый mailboxFolder или дочерний mailboxFolder в почтовом ящике пользователя.
Получение	mailboxFolder	Чтение свойств и связей объекта mailboxFolder .
Обновление	mailboxFolder	Обновите свойства mailboxFolder , такие как displayName в почтовом ящике.
удаление;	Нет	Удалите mailboxFolder или дочерний mailboxFolder в почтовом ящике.
Получение дельты	Коллекция mailboxFolder	Получите набор объектов mailboxFolder , которые были добавлены, удалены или удалены из почтового ящика пользователя.
Вывод списка дочерних папок почтового ящика	Коллекция mailboxFolder	Получите коллекцию mailboxFolder в указанном mailboxFolder в почтовом ящике.
Перечисление элементов в папке	Коллекция mailboxItem	Получите коллекцию mailboxItem в указанном mailboxFolder в почтовом ящике.
Расширенные свойства
Создание однозначного свойства	mailboxFolder	Создайте одно или несколько расширенных свойств с одним значением в новой или существующей папке почтового ящика.
Получение однозначного свойства	mailboxFolder	Получение папок почтовых ящиков, содержащих расширенное свойство с одним значением, с помощью $expand или $filter.
Создание свойства с несколькими значениями	mailboxFolder	Создайте одно или несколько расширенных свойств с несколькими значениями в новой или существующей папке почтового ящика.
Получение свойства с несколькими значениями	mailboxFolder	Получите папку почтового ящика, содержащую расширенное свойство с несколькими значениями, с помощью $expand.

Свойства

Свойство	Тип	Описание
childFolderCount	Int32	Количество непосредственных дочерних папок в текущей папке.
displayName	String	Отображаемое имя папки.
id	String	Уникальный идентификатор папки.
parentFolderId	String	Уникальный идентификатор родительской папки этой папки.
parentMailboxUrl	String	Канал маршрутизации для фактического базового почтового ящика, в котором физически находится папка. Доступ к папке можно получить с помощью GET {parentMailboxUrl}/folders/{id}, который обрабатывает весь URL-адрес как непрозрачную строку. Этот метод особенно важен, если для почтового ящика на месте пользователя включена архивация с автоматическим расширением. В таких сценариях содержимое архива пользователя может охватывать несколько почтовых ящиков.
totalItemCount	Int32	Количество элементов в папке.
type	String	Описывает тип класса папки.

Связи

Связь	Тип	Описание
childFolders	Коллекция mailboxFolder	Коллекция дочерних папок в этой папке.
items	Коллекция mailboxItem	Коллекция элементов в этой папке.
multiValueExtendedProperties	Коллекция multiValueLegacyExtendedProperty	Коллекция многозначных расширенных свойств, определенных для mailboxFolder.
singleValueExtendedProperties	Коллекция singleValueLegacyExtendedProperty	Коллекция однозначных расширенных свойств, определенных для mailboxFolder.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.mailboxFolder",
  "displayName": "String",
  "childFolderCount": "Int32",
  "id": "String (identifier)",
  "parentFolderId": "String",
  "parentMailboxUrl": "String",
  "totalItemCount": "Int32",
  "type": "String"
}