Список заметок

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

Получение списка объектов заметок в папке "Заметки " пользователя.

Разрешения

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

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

HTTP-запрос

GET /me/notes
GET /users/{id | userPrincipalName}/notes

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

Этот метод поддерживает параметры запросов $select, $filter, $orderby, $top, $skipи $count OData, что помогает настраивать ответ. Общие сведения см. в статье Параметры запроса OData.

Поддерживаются $filterследующие свойства:

• Тема:eq , ne,startsWith
• createdDateTime: eq, ne, ge, legt,lt
• lastModifiedDateTime: eq, ne, ge, legtlt
• hasAttachments: eq

Поддерживаются следующие свойства $orderby: createdDateTime, lastModifiedDateTime и subject.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/me/notes?$select=id,subject,bodyPreview,lastModifiedDateTime&$orderby=lastModifiedDateTime desc&$top=20

Отклик

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('user-id')/notes(id,subject,bodyPreview,lastModifiedDateTime)",
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/notes?$select=id,subject,bodyPreview,lastModifiedDateTime&$orderby=lastModifiedDateTime+desc&$top=20&$skiptoken=abc123",
  "value": [
    {
      "id": "AAMkAGI2THVSAAA=",
      "subject": "Team Standup - Jan 20",
      "bodyPreview": "Completed tasks: Feature A, Feature B. In progress: Feature C",
      "lastModifiedDateTime": "2024-01-20T09:15:00Z"
    },
    {
      "id": "AAMkAGI2THVSAAB=",
      "subject": "Shopping List",
      "bodyPreview": "Milk, Eggs, Bread, Coffee",
      "lastModifiedDateTime": "2024-01-19T18:30:00Z"
    }
  ]
}