Создание элемента в списке

Статья
04/08/2023

Создание элемента listItem в списке.

Разрешения

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

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

HTTP-запрос

POST /sites/{site-id}/lists/{list-id}/items

Тело запроса

В теле запроса укажите представление ресурса listItem, который необходимо создать, в формате JSON.

Пример

В примере ниже показано, как создать элемент списка общего назначения.

POST /sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

Ответ

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

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

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

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

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