Тип ресурса 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"
}