Ресурс ListItem

  • Статья

Этот ресурс представляет элемент объекта list в SharePoint. Значения столбцов в списке доступны через словарь fieldValueSet.

Задачи для ресурса listItem

Ниже перечислены задачи, доступные для ресурсов listItem. Все приведенные ниже примеры относятся к объекту list, например https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Стандартная задача Метод HTTP
Получение GET /items/{item-id}
Получение значений столбцов GET /items/{item-id}?expand=fields
Создание POST /items
Удаление DELETE /items/{item-id}
Обновление PATCH /items/{item-id}
Обновление значений столбцов PATCH /items/{item-id}/fields

Представление JSON

Ниже показано представление ресурса listItem в формате JSON.

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}

Свойства

Ниже перечислены свойства ресурса listItem.

Имя свойства Тип Описание
contentType contentTypeInfo Тип контента для данного элемента списка.

Ниже перечислены свойства, которые наследуются от ресурса baseItem.

Имя свойства Тип Описание
id string Уникальный идентификатор элемента. Только для чтения.
name string Имя или название элемента.
createdBy identitySet Удостоверение создателя данного элемента. Только для чтения.
createdDateTime DateTimeOffset Дата и время создания элемента. Только для чтения.
description строка Текст с описанием элемента.
eTag string ETag для элемента. Только для чтения.
lastModifiedBy identitySet Удостоверение пользователя, который последним изменил данный элемент. Только для чтения.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения элемента. Только для чтения.
parentReference itemReference Сведения о родительском элементе, если элемент выступает в роли родительского элемента. Чтение и запись.
sharepointIds sharepointIds Возвращает идентификаторы, использующиеся для обеспечения совместимости с SharePoint REST. Только для чтения.
webUrl строка (url-адрес) URL-адрес для отображения элемента в браузере. Только для чтения.

Связи

Ниже перечислены связи ресурса listItem с другими ресурсами.

Имя связи Тип Описание
activities Коллекция itemActivity Список последних действий, выполненных с элементом.
driveItem driveItem Для библиотек документов связь driveItem предоставляет ресурс listItem как объект driveItem
fields fieldValueSet Значения столбцов, установленные для данного элемента списка.
versions Коллекция listItemVersion Список предыдущих версий элемента списка.