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 jogo de vídeo. Quando um usuário se envolve com essa atividade, o envolvimento é 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 com essa atividade ao longo do tempo, vários itens de histórico são gravados para uma única atividade do 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 envolvimento do usuário. Sempre que um usuário reaja a 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	Cria ou substitui um historyItem existente para essa atividade (upsert). A ID precisa ser um GUID.
Excluir um historyItem	Sem Conteúdo	Exclui o historyItem especificado para essa atividade.

Propriedades

Nome	Tipo	Descrição
status	status	Definido pelo servidor. Um código de status usado para identificar objetos válidos. Valores: ativo, atualizado, excluído, ignorado.
userTimezone	String	Opcional. O timezone 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.
createdDateTime	DateTimeOffset	Definido pelo servidor. DateTime em UTC quando o objeto foi criado no servidor.
lastModifiedDateTime	DateTimeOffset	Definido pelo servidor. DateTime em UTC quando o objeto foi modificado no servidor.
id	String	Obrigatório. GUID definido pelo cliente para o objeto historyItem.
startedDateTime	DateTimeOffset	Obrigatório. UTC DateTime quando o historyItem (sessão de atividade) foi iniciado. Obrigatório para o histórico da linha do tempo.
lastActiveDateTime	DateTimeOffset	Opcional. UTC DateTime quando o historyItem (sessão de atividade) foi entendido pela última vez como ativo ou concluído - se nulo, o status historyItem deve ser Contínuo.
expirationDateTime	DateTimeOffset	Opcional. UTC DateTime quando historyItem passará por exclusão permanente. Pode ser definido pelo cliente.
activeDurationSeconds	int	Opcional. A duração do envolvimento do usuário ativo. se não for fornecido, isso é calculado a partir do startedDateTime e lastActiveDateTime.

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.

{
    "status": "active | updated | deleted | ignored",
    "createdDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "id": "String",
    "expirationDateTime": "DateTimeOffset",
    "startedDateTime": "DateTimeOffset",
    "userTimezone": "String",
    "lastActiveDateTime": "DateTimeOffset",
    "activeDurationSeconds":"int"
}