Получение ресурса listItem

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

Возвращает метаданные элемента в списке.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Sites.Read.All Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Sites.Read.All Sites.ReadWrite.All, Sites.Manage.All

Примечание.: Требуется разрешение для приложений Sites.Manage.All, если в списке SharePoint включены параметры утверждения контента. В противном случае Microsoft Graph не будет извлекать элементы списка с состоянием утверждения, отличающимся от утвержденного.

HTTP-запрос

Получение ресурса listItem

GET /sites/{site-id}/lists/{list-id}/items/{item-id}

Получение значений столбцов ресурса listItem

GET /sites/{site-id}/lists/{list-id}/items/{item-id}?expand=fields

Получение значений определенных столбцов ресурса listItem

GET /sites/{site-id}/lists/{list-id}/items/{item-id}?expand=fields(select=Column1,Column2)

Необязательные параметры запросов

Этот метод поддерживает параметры запросов OData для настройки отклика.

Заголовки запросов

Имя Описание
Авторизация Bearer {код}. Обязательно.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

При успешном выполнении этот метод возвращает код ответа 200 OK и объект item в тексте отклика.

Пример

Запрос

GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}?expand=fields

Отклик

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "5",
  "fields": {
    "Name": "Widget",
    "Color": "Blue",
    "Quantity": 2357
    }
}