activityHistoryItem tipo de recurso
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 activityHistoryItem 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, uma nova atividadeHistoryItem é adicionada à atividade para acumular o envolvimento do usuário.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Create ou substituir a atividadeHistoryItem | activityHistoryItem | Create ou substituir uma atividade existenteHistoryItem para essa atividade (upsert). A ID precisa ser um GUID. |
Excluir uma atividadeHistoryItem | Sem Conteúdo | Exclua a atividade especificadaHistoryItem 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 a atividadeHistoryItem será submetida à exclusão dura. Pode ser definido pelo cliente. |
id | Cadeia de caracteres | Obrigatório. GUID definido pelo cliente para o objeto activityHistoryItem . |
lastActiveDateTime | DateTimeOffset | Opcional. UTC DateTime quando a atividadeHistoryItem (sessão de atividade) foi entendida pela última vez como ativa ou concluída - se nula, activityHistoryItem status deve ser Contínua. |
lastModifiedDateTime | DateTimeOffset | Definido pelo servidor. DateTime no UTC quando o objeto foi modificado no servidor. |
startedDateTime | DateTimeOffset | Obrigatório. UTC DateTime quando a atividadeHistoryItem (sessão de atividade) foi iniciada. 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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários