Tipo de recurso userActivity

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una sola actividad dentro de una aplicación, por ejemplo, un programa de televisión, un documento o una campaña actual en un videojuego. Cuando un usuario interactúa con esa actividad, la interacción se captura como un elemento del historial que indica la hora de inicio y finalización de esa actividad. A medida que el usuario vuelve a interactuar con esa actividad a lo largo del tiempo, se registran varios elementos del historial para una sola actividad del usuario.

Puede usar las actividades de Microsoft Graph para permitir que los usuarios vuelvan a lo que estaban haciendo en su aplicación, en varios dispositivos. Las actividades que crea la aplicación aparecen en los dispositivos de todos los usuarios y se exponen a los usuarios como vínculos profundos a contenido específico dentro de la aplicación. Puede expresar contenido específico dentro de la aplicación como un destino que se muestra en Windows y al que se puede acceder en dispositivos iOS y Android a través de las notificaciones de Cortana.

Dado que cada aplicación es diferente, depende de usted comprender la mejor manera de asignar las acciones dentro de la aplicación a las actividades del usuario que aparecerán en Cortana y la línea de tiempo. Por ejemplo, los juegos pueden crear una actividad para cada campaña, las aplicaciones de creación de documentos pueden crear una actividad para cada documento único y las aplicaciones de línea de negocio pueden crear una actividad para cada flujo de trabajo.

Las actividades de usuario se mostrarán en las experiencias de usuario de Cortana y Escala de tiempo de Windows, que se centran en aumentar la productividad y eficiencia de los usuarios ayudándoles a volver al contenido en el que trabajaron en el pasado.

Métodos

Método Tipo de valor devuelto Descripción
Crear o reemplazar una actividad userActivity Crea o reemplaza una actividad existente (upsert). El appActivityId debe ser seguro para URL (todos los caracteres excepto los caracteres no reservados RFC 2396 deben convertirse a su representación hexadecimal), pero el appActivityId original no tiene que ser seguro para URL.
Eliminar actividad Sin contenido Elimina la actividad especificada para ese usuario de la aplicación.
Obtener actividades Recopilación de userActivity Obtiene las actividades de la aplicación para un usuario determinado.
Obtener actividades recientes Recopilación de userActivity Obtiene las actividades más recientes de la aplicación para un usuario determinado, ordenadas y basadas en los activityHistoryItems creados o actualizados más recientemente.

Propiedades

Nombre Tipo Descripción
userTimezone Cadena Opcional. La zona horaria en la que se encontraba el dispositivo del usuario utilizado para generar la actividad en el momento de creación de la actividad; valores suministrados como identificadores de Olson para admitir la representación multiplataforma.
createdDateTime DateTimeOffset Establecida por el servidor. DateTime en UTC cuando se creó el objeto en el servidor.
lastModifiedDateTime DateTimeOffset Establecida por el servidor. DateTime en UTC cuando se modificó el objeto en el servidor.
id Cadena Id. generado por el servidor que se usa para el direccionamiento de direcciones URL.
appActivityId Cadena Obligatorio. El id. de actividad único en el contexto de la aplicación: proporcionado por el autor de la llamada e inmutable a partir de entonces.
activitySourceHost Cadena Obligatorio. Dirección URL del dominio que representa la asignación de identidad multiplataforma para la aplicación. La asignación se almacena como un archivo JSON hospedado en el dominio o se puede configurar a través del Centro de desarrollo de Windows. El archivo JSON se denomina multiplataforma-app-identifiers y se hospeda en la raíz del dominio HTTPS, ya sea en el dominio de nivel superior o en el subdominio. Por ejemplo: https://contoso.com o https://myapp.contoso.com, pero NO https://myapp.contoso.com/somepath. Debe tener un archivo y un dominio únicos (o subdominio) por identidad de aplicación multiplataforma. Por ejemplo, se necesita un archivo y un dominio independientes para Word frente a PowerPoint.
appDisplayName Cadena Opcional. Descripción breve de la aplicación utilizada para generar la actividad y su uso en los casos en que la aplicación no esté instalada en el dispositivo local del usuario.
activationUrl Cadena Obligatorio. Dirección URL usada para iniciar la actividad en la mejor experiencia nativa representada por el appId. Puede iniciar una aplicación basada en web si no existe ninguna aplicación nativa.
fallbackUrl Cadena Opcional. Dirección URL usada para iniciar la actividad en una aplicación basada en web, si está disponible.
contentUrl Cadena Opcional. Se usa en el caso de que el contenido se pueda representar fuera de una experiencia de aplicación nativa o basada en web (por ejemplo, puntero a un elemento en una fuente RSS).
elementos visuales información visual Obligatorio. Objeto que contiene información para representar la actividad en la experiencia de usuario.
contentInfo Objeto JSON sin tipo Opcional. Un dato personalizado: JSON-LD Descripción extensible del contenido según la sintaxis schema.org .
expirationDateTime DateTimeOffset Establecida por el servidor. DateTime en UTC cuando el objeto expiró en el servidor.
status cadena Establecida por el servidor. Código de estado usado para identificar objetos válidos. Valores: activo, actualizado, eliminado, omitido.

Relaciones

Relación Tipo Descripción
elementos de historial Colección activityHistoryItem Opcional. NavigationProperty/Containment; navigation a activityHistoryItems.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
    "appActivityId": "String",
    "activitySourceHost": "String (host name/domain/URL)",
    "userTimezone": "String",
    "appDisplayName": "String",
    "activationUrl": "String (URL)",
    "contentUrl": "String (URL)",
    "fallbackUrl": "String (URL)",
    "createdDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "expirationDateTime": "DateTimeOffset",
    "id": "String",
    "status": "string",
    "contentInfo": { "@data.type": "microsoft.graph.Json" },
    "visualElements": { "@data.type": "microsoft.graph.visualInfo" },
    "historyItems": [{ "@odata.type": "microsoft.graph.activityHistoryItem" }]
}
  • Last updated on