List sectionGroups

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

Важно!

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

Получение списка групп разделов из указанной группы разделов.

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

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

Разрешения

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

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

HTTP-запрос

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

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

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

По умолчанию используется порядок сортировки name asc.

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

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

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

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

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

Отклик

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

Пример

Запрос

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

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

Отклик

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

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

{
  "value": [
    {
      "sectionsUrl": "sectionsUrl-value",
      "sectionGroupsUrl": "sectionGroupsUrl-value",
      "displayName": "name-value",      
      "createdBy": {
        "user": {
          "id": "id-value",
          "displayName": "displayName-value"
        }
      },
      "lastModifiedBy": {
        "user": {
          "id": "id-value",
          "displayName": "displayName-value"
        }
      }
    }
  ]
}
  • Last updated on