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


Тип ресурса listItem

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

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

Методы

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

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

Свойства

Ниже перечислены свойства ресурса 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 Список последних действий, выполненных с элементом.
analytics Ресурс itemAnalytics Аналитические данные о действиях просмотра, выполненных для элемента.
documentSetVersions Коллекция documentSetVersion Сведения о версии набора документов, созданной пользователем.
driveItem driveItem Для библиотек документов связь driveItem предоставляет ресурс listItem как объект driveItem
fields fieldValueSet Значения столбцов, установленные для данного элемента списка.
permissions Коллекция объектов permission Набор разрешений для элемента. Только для чтения. Допускается значение null.
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"
}