Neues Element in einer Liste erstellen

Artikel
04/08/2023

Erstellen Sie ein neues listItem in einer Liste.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Sites.ReadWrite.All

HTTP-Anforderung

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der zu erstellenden listItem-Ressource an.

Beispiel

Unten sehen Sie ein Beispiel, das die Erstellung eines neuen generischen Listenelements illustriert.

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

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

Antwort

Wenn die Methode erfolgreich verläuft, wird ein listItem-Objekt im Antworttext des neu erstellten Listenelements zurückgegeben.

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"
    }
  }
}

Hinweis: Das „Response“-Objekt wurde zwecks besserer Übersichtlichkeit gekürzt. Der tatsächliche Aufruf gibt die Standardeigenschaften zurück.

Freigeben über