tipo de 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 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 recurso driveItem.

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

Métodos

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

Método	Tipo de retorno	Descrição
Criar	listItem	Criar um novo listItem em uma lista.
Get	listItem	Obter um item em uma lista.
Atualizar	fieldValueSet	Atualizar as propriedades de um listItem.
Excluir	Sem Conteúdo	Remove um item de uma lista.
Obter análises	itemAnalytics	Obter análises para este recurso.
Obter valores de coluna	listItem	Obter valores de coluna de listItem.
Atualizar valores de coluna	fieldValueSet	Atualizar os valores de coluna de um listItem.
Listar a versão do conjunto de documentos	coleção documentSetVersion	Obtenha uma lista das versões de um item de conjunto de documentos numa lista.
Criar versão do conjunto de documentos	documentSetVersion	Criar uma nova versão de um item de conjunto de documentos numa lista.
Restaurar a versão do conjunto de documentos	Sem Conteúdo	Restaure o item do conjunto de documentos para uma versão específica.
Obter delta	coleção listItem	Obtenha itens de lista recentemente criados, atualizados ou eliminados sem ter de efetuar uma leitura completa de toda a coleção de itens.
Listar permissões	permissão	Obtenha uma lista dos objetos de permissão associados a um listItem.
Criar permissão	permissão	Obtenha uma lista dos objetos de permissão associados a um listItem.
Obter permissão	permissão	Crie um novo objeto de permissão num listItem.
Atualizar permissão	permissão	Atualizar um objeto de permissão num listItem.
Excluir permissão	Nenhum	Eliminar um objeto de permissão num listItem.

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 desse 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 da última pessoa que alterou esse 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 de uma versão do conjunto de documentos criada por um utilizador.
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.
permissões	Coleção permission	O conjunto de permissões do item. Somente leitura. Anulável.
versões	coleção listItemVersion	A lista de versões anteriores do item de lista.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

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