通过

在列表中创建新项

  • 项目

在列表中创建新的 listItem。

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Sites.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 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"
    }
  }
}

注意：为清楚起见，将截断 Response 对象。 实际调用会返回默认属性。