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

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

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

Разрешения

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

HTTP-запрос

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

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

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

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

• subject: eq, ne, startsWith
• createdDateTime: eq, ge, le, gt, , lt
• lastModifiedDateTime: eq, ge, le, , gt, lt
• HasAttachments: eq

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

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

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

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

Отклик

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

Примеры

Запрос

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

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

const options = {
	authProvider,
};

const client = Client.init(options);

let notes = await client.api('/me/notes')
	.version('beta')
	.orderby('lastModifiedDateTime desc')
	.top(20)
	.get();

Отклик

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('user-id')/notes(id,subject,bodyPreview,lastModifiedDateTime)",
  "@odata.nextLink": "https://graph.microsoft.com/beta/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"
    }
  ]
}