tipo de recurso historyItem

Namespace: microsoft.graph

Representa um item de histórico para uma atividade em um aplicativo. As atividades do usuário representam um único destino em seu aplicativo; por exemplo, um programa de TV, um documento ou uma campanha atual em um videogame. Quando um usuário se envolve com essa atividade, o compromisso é capturado como um item de histórico que indica a hora de início e término dessa atividade. À medida que o usuário se envolve novamente com essa atividade ao longo do tempo, vários itens de histórico são registrados para uma única atividade de usuário.

Quando um aplicativo cria uma sessão, um objeto historyItem deve ser adicionado ao objeto de atividade para refletir o período de engajamento do usuário. Sempre que um usuário se envolve novamente com uma atividade, um novo historyItem é adicionado à atividade para acumular o envolvimento do usuário.

Métodos

Método	Tipo de retorno	Descrição
Criar ou substituir historyItem	historyItem	Crie ou substitua um historyItem existente para essa atividade (upsert). A ID precisa ser um GUID.
Excluir um historyItem	Sem Conteúdo	Exclua o historyItem especificado para essa atividade.

Propriedades

Nome	Tipo	Descrição
activeDurationSeconds	int	Opcional. A duração do envolvimento ativo do usuário. se não for fornecido, isso será calculado a partir do startedDateTime e do lastActiveDateTime.
createdDateTime	DateTimeOffset	Definido pelo servidor. DateTime no UTC quando o objeto foi criado no servidor.
expirationDateTime	DateTimeOffset	Opcional. UTC DateTime quando o historyItem será submetido à exclusão dura. Pode ser definido pelo cliente.
id	Cadeia de caracteres	Obrigatório. GUID definido pelo cliente para o objeto historyItem .
lastActiveDateTime	DateTimeOffset	Opcional. UTC DateTime quando o historyItem (sessão de atividade) foi entendido pela última vez como ativo ou concluído - se nulo, historyItem status deve ser Contínuo.
lastModifiedDateTime	DateTimeOffset	Definido pelo servidor. DateTime no UTC quando o objeto foi modificado no servidor.
startedDateTime	DateTimeOffset	Obrigatório. UTC DateTime quando o historyItem (sessão de atividade) foi iniciado. Necessário para linha do tempo histórico.
status	status	Definido pelo servidor. Um código status usado para identificar objetos válidos. Valores: ativo, atualizado, excluído, ignorado.
userTimezone	String	Opcional. O fuso horário no qual o dispositivo do usuário usado para gerar a atividade estava localizado no momento da criação da atividade. Valores fornecidos como IDs Olson para dar suporte à representação entre plataformas.

Relações

Relação	Tipo	Descrição
atividade	userActivity	Opcional. NavigationProperty/Containment; propriedade navigation para a atividade associada.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
    "activeDurationSeconds":"int",
    "createdDateTime": "DateTimeOffset",
    "expirationDateTime": "DateTimeOffset",
    "id": "String",
    "lastActiveDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "startedDateTime": "DateTimeOffset",
    "status": "String",
    "userTimezone": "String"
}