Изменение элемента в списке

Статья
04/08/2023

Изменение свойств ресурса listItem.

Разрешения

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

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

HTTP-запрос

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields

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

Имя	Значение	Описание
if-match	etag	Если указан этот заголовок запроса, а предоставленный тег eTag не совпадает с текущим тегом eTag элемента, то будет возвращен ответ `412 Precondition Failed`, а элемент не будет обновлен.

Тело запроса

Включите представление объекта fieldValueSet в формате JSON в тело запроса, указав поля, которые необходимо обновить.

Пример

В примере ниже показано, как обновить поля Color (Цвет) и Quantity (Количество) элемента списка, указав новые значения. Все остальные значения для ресурса listItem останутся без изменений.

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}

Ответ

При успешном выполнении этот метод возвращает объект fieldValueSet для обновленного элемента списка в теле ответа.

HTTP/1.1 201 Created
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Fuchsia",
  "Quantity": 934
}

Поделиться через