Ресурс listItem

  • Статья

Пространство имен: microsoft.graph

Представляет элемент объекта list в SharePoint.

Все элементы в библиотеке документов SharePoint могут быть представлены как ресурс listItem или driveItem.

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

Методы

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

Метод Возвращаемый тип Описание
получение; listItem Получение элемента списка.
Получение значений столбцов listItem Получение значений столбцов из ресурса listItem.
Получение аналитики itemAnalytics Получение аналитических данных для ресурса.
Получение действий по интервалу itemActivityStat Получение коллекции объектов itemActivityStat в пределах указанного интервала времени.
Создание listItem Создание ресурса listItem в списке.
Удаление Содержимое отсутствует Удаление элемента из списка.
Обновление fieldValueSet Изменение свойств ресурса listItem.
Обновление значений столбцов fieldValueSet Изменение значений столбцов ресурса listItem.
Перечисление documentSetVersions Коллекция documentSetVersion Получение списка версий элемента набора документов в списке.
Создание documentSetVersion documentSetVersion Создайте новую версию элемента набора документов в списке.
Восстановление documentSetVersion Содержимое отсутствует Восстановите элемент набора документов до определенной версии.
Получение дельты Коллекция listItem Получение только что созданных, обновленных или удаленных элементов списка без необходимости выполнять полное чтение всей коллекции элементов.

Свойства

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

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

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

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

Связи

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

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

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

В следующем представлении 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"}],
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "documentSetVersions": [{"@odata.type": "microsoft.graph.documentSetVersion"}],
  "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"
}