recurso listItem

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Representa um item em uma [lista][] do Microsoft Office SharePoint Online.

Todos os itens em uma biblioteca de documentos do Microsoft Office SharePoint Online podem ser representados como um listItem ou um r [ecurso driveItem][].

Os valores de coluna na lista estão disponíveis por meio do dicionário fieldValueSet.

Tarefas em um listItem

As tarefas a seguir estão disponíveis para recursos listItem. Todos os exemplos a seguir referem-se a uma list, por exemplo: https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}.

Tarefa comum	Método HTTP
[Get][]	GET /items/{item-id}
[Obter valores de coluna][Get]	GET /items/{item-id}?expand=fields
Obter análises	GET /items/{item-id}/analytics
Obter atividades por intervalo	GET /items/{item-id}/getActivitiesByInterval
Create	POST /items
Delete	DELETE /items/{item-id}
Update	PATCH /items/{item-id}
Atualizar valores de coluna	PATCH /items/{item-id}/fields
createLink	POST /items/{itemId}/createLink
Listar documentSetVersions	GET /items/{item-id}/documentSetVersions
Criar documentSetVersion	POST /items/{item-id}/documentSetVersions
Restaurar documentSetVersion	POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore
Obter delta	GET /items/{item-id}/delta

Representação JSON

Veja a seguir uma representação JSON de um recurso listItem.

{
  "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"
}

Propriedades

O recurso listItem tem as seguintes propriedades.

Propriedade	Tipo	Descrição
contentType	contentTypeInfo	O tipo de conteúdo deste item de lista

As propriedades a seguir são herdadas do baseItem.

Nome da propriedade	Tipo	Descrição
id	string	O identificador exclusivo do item. Somente leitura.
name	string	O nome/título do item.
createdBy	identitySet	Identidade do criador deste item. Somente leitura.
createdDateTime	DateTimeOffset	A data e a hora da criação do item. Somente leitura.
description	string	O texto descritivo do item.
eTag	string	ETag do item. Somente leitura.
lastModifiedBy	identitySet	Identidade do último modificador deste item. Somente leitura.
lastModifiedDateTime	DateTimeOffset	A data e a hora que o item foi modificado pela última vez. Somente leitura.
parentReference	itemReference	Informações do pai, se o item tiver um pai. Leitura e gravação.
sharepointIds	sharepointIds	Retorna os identificadores úteis para fins de compatibilidade do REST do SharePoint. Somente leitura.
webUrl	string (url)	A URL que exibe o item no navegador. Somente leitura.

Relações

O recurso listItem tem as seguintes relações com outros recursos.

Relação	Tipo	Descrição
activities	Conjunto itemActivity	A lista de atividades recentes que ocorreram neste item.
análise	recurso itemAnalytics	Análise sobre as atividades de visualização que ocorreram neste item.
documentSetVersions	coleção documentSetVersion	Informações de versão para uma versão do conjunto de documentos criada por um usuário.
driveItem	driveItem	Para bibliotecas de documentos, a relação driveItem expõe listItem como um driveItem
campos	fieldValueSet	Os valores das colunas definidos neste item de lista.
versões	coleção listItemVersion	A lista de versões anteriores do item de lista.