Поделиться через

Получение userConfiguration

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

Важно!

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

Чтение свойств и связей объекта userConfiguration .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) MailboxConfigItem.Read MailboxConfigItem.ReadWrite
Делегированные (личная учетная запись Майкрософт) MailboxConfigItem.Read MailboxConfigItem.ReadWrite
Приложение MailboxConfigItem.Read MailboxConfigItem.ReadWrite

HTTP-запрос

GET /me/mailFolders/{mailFolderId}/userConfigurations/{userConfigurationId}
GET /users/{usersId}/mailFolders/{mailFolderId}/userConfigurations/{userConfigurationId}

Необязательные параметры запросов

Этот метод не поддерживает параметры запроса OData для настройки ответа.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект userConfiguration в тексте отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/me/mailFolders/inbox/userConfigurations/MyApp

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('f42c50f8-1300-48a0-93d4-6481acda7efb')/mailFolders('inbox')/userConfigurations/$entity",
  "id": "MyApp",
  "binaryData": "SGVsbG8=",
  "xmlData": "V29ybGQ=",
  "structuredData": [
    {
      "keyEntry": {
        "type": "byte",
        "values": [
          "100"
        ]
      },
      "valueEntry": {
        "type": "boolean",
        "values": [
          "true"
        ]
      }
    },
    {
      "keyEntry": {
        "type": "integer32",
        "values": [
          "-32"
        ]
      },
      "valueEntry": {
        "type": "integer64",
        "values": [
          "64"
        ]
      }
    },
    {
      "keyEntry": {
        "type": "unsignedInteger32",
        "values": [
          "32"
        ]
      },
      "valueEntry": {
        "type": "unsignedInteger64",
        "values": [
          "64"
        ]
      }
    },
    {
      "keyEntry": {
        "type": "string",
        "values": [
          "DateTime"
        ]
      },
      "valueEntry": {
        "type": "dateTime",
        "values": [
          "2025-10-23T01:23:45.0000000+00:00"
        ]
      }
    },
    {
      "keyEntry": {
        "type": "byteArray",
        "values": [
          "AQECAwUI"
        ]
      },
      "valueEntry": {
        "type": "stringArray",
        "values": [
          "Hello",
          "World"
        ]
      }
    }
  ]
}
  • Last updated on