Тип ресурса 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"
}