Получение раздела

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

Важно!

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

Получить свойства и связи объекта section.

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

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

Разрешения

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

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) Notes.Create Заметки.Чтение, Заметки.Прочесть.Все, Заметки.ПрочестьНаписать, Заметки.ПрочестьНаписать.Все
Делегированные (личная учетная запись Майкрософт) Notes.Create Примечания.чтение, заметки.чтение и запись
Приложение Notes.Read.All Notes.ReadWrite.All

HTTP-запрос

GET /me/onenote/sections/{id}
GET /users/{id | userPrincipalName}/onenote/sections/{id}
GET /groups/{id}/onenote/sections/{id}
GET /sites/{id}/onenote/sections/{id}

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

Этот метод поддерживает select параметры запроса и expandOData, помогающие настроить ответ.

Запрос по умолчанию разворачивается parentNotebook и выбирает свои idсвойства , displayName, и self . Допустимыми expand значениями для разделов являются parentNotebook и parentSectionGroup.

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

Имя Тип Описание
Authorization string Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Accept строка application/json

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

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

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и объект onenoteSection в тексте ответа.

Пример

Запрос

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

GET https://graph.microsoft.com/beta/me/onenote/sections/{id}

Отклик

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

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

{
  "isDefault": true,
  "pagesUrl": "pagesUrl-value",
  "displayName": "name-value",
  "createdBy": {
    "user": {
      "id": "id-value",
      "displayName": "displayName-value"
    }
  },
  "lastModifiedBy": {
    "user": {
      "id": "id-value",
      "displayName": "displayName-value"
    }
  }
}