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 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 /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 |
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 para uma versão de 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. |
Representação JSON
Veja a seguir uma representação JSON do 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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de