Примечание об обновлении

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

Обновление свойств объекта заметки . Поддерживает управление оптимистичным параллелизмом с If-Match помощью заголовка со значением changeKey для заметки.

Разрешения

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

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

HTTP-запрос

PATCH /me/notes/{note-id}
PATCH /users/{id | userPrincipalName}/notes/{note-id}

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type application/json. Обязательно.
If-Match Значение changeKey для заметки используется для управления оптимистическим параллелизмом. Необязательный параметр. Рекомендуется использовать этот заголовок, чтобы избежать конфликтов.

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

В тексте запроса укажите только значения обновляемых свойств. Существующие свойства, не включенные в текст запроса, сохраняют свои прежние значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
body itemBody Содержание заметки. Поддержка text или html типы контента. Необязательный параметр.
categories Коллекция String Категории, связанные с заметкой. Необязательный параметр.
subject String Название примечания. Необязательный параметр.

Отклик

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

Если заголовок If-Match не совпадает с текущим changeKey, этот метод возвращает код ответа 412 Precondition Failed .

Примеры

Запрос

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

PATCH https://graph.microsoft.com/v1.0/me/notes/AAMkAGI2THVSAAA=
Content-Type: application/json
If-Match: "CQAAABYAAABE"

{
  "subject": "Updated Meeting Notes - Jan 28",
  "body": {
    "contentType": "html",
    "content": "<html><body><h2>Updated Standup</h2><ul><li>Task 1 completed</li><li>Task 2 in progress</li></ul></body></html>"
  }
}

Отклик

Ниже приводится пример отклика.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('user-id')/notes/$entity",
  "id": "AAMkAGI2THVSAAA=",
  "changeKey": "CQAAABYAAABG",
  "createdDateTime": "2024-01-15T10:30:00Z",
  "lastModifiedDateTime": "2024-01-28T09:45:00Z",
  "categories": [],
  "subject": "Updated Meeting Notes - Jan 28",
  "body": {
    "contentType": "html",
    "content": "<html><body><h2>Updated Standup</h2><ul><li>Task 1 completed</li><li>Task 2 in progress</li></ul></body></html>"
  },
  "bodyPreview": "Updated Standup Task 1 completed Task 2 in progress",
  "isDeleted": false,
  "hasAttachments": false
}
  • Last updated on