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

Ресурс List

  • Статья

Ресурс list представляет список в ресурсе site. Этот ресурс содержит высокоуровневые свойства списка, включая определения шаблонов и полей.

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

Ниже перечислены задачи, доступные для ресурсов list. Примечание. В этой бета-версии разрешается только навигация по спискам. Их создание и обновление не поддерживаются. Однако вы можете создавать или обновлять элементы списка.

Все приведенные ниже примеры относятся к сайту, например https://graph.microsoft.com/v1.0/sites/{site-id}.

Стандартная задача Метод HTTP
Получение списка GET /lists/{list-id}
Перечисление элементов списка GET /lists/{list-id}/items
Обновление элемента списка PATCH /lists/{list-id}/items/{item-id}
Удаление элемента списка DELETE /lists/{list-id}/items/{item-id}
Создание элемента в списке POST /lists/{list-id}
Получение последних действий GET /lists/{list-id}/activities

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

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

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "displayName": "title of list",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "items": [ { "@odata.type": "microsoft.graph.listItem" } ],
  "list": {
    "@odata.type": "microsoft.graph.listInfo",
    "hidden": false,
    "template": "documentLibrary | genericList | survey | links | announcements | contacts | accessRequest ..."
  },
  "system": false,

  /* inherited from baseItem */
  "id": "string",
  "name": "name of list",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of list",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "webUrl": "url to visit the list in a browser"
}

Свойства

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

Имя свойства Тип Описание
displayName строка Отображаемый заголовок списка.
list listInfo Предоставляет дополнительные сведения о списке.
system systemFacet Если это свойство задано, оно указывает, что данным списком управляет система. Только для чтения.

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

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

Связи

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

Имя связи Тип Описание
activities Коллекция itemActivity Последние действия, выполненные в списке.
drive drive Доступна только для библиотек документов. Разрешает доступ к списку как к ресурсу drive с объектами driveItem.
items Коллекция (listItem) Все элементы, содержащиеся в списке.
columns Коллекция (columnDefinition) Коллекция определений полей для данного списка.
contentTypes Коллекция (contentType) Коллекция типов контента в данном списке.