Tipo de recurso userActivity

  • Artículo

Espacio de nombres: microsoft.graph

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 se involucra con esa actividad, la interacción se captura como un elemento de 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 de usuario.

Puede usar actividades en 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 todos los dispositivos de los usuarios y se exponen a los usuarios como vínculos profundos a contenido específico dentro de la aplicación. Puedes expresar contenido específico dentro de la aplicación como un destino que se muestra en Windows y accesible en dispositivos iOS y Android a través de notificaciones de Cortana.

Dado que cada aplicación es diferente, depende de usted comprender la mejor manera de asignar acciones dentro de la aplicación a las actividades del usuario que aparecerán en Cortana y escala 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 del usuario se mostrarán en las experiencias de usuario de Cortana y Windows Timeline, que se centran en aumentar la productividad y la eficacia de los usuarios ayudándoles a volver al contenido en el que trabajaron en el pasado.

Métodos

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

Propiedades

Nombre Tipo Description
activationUrl Cadena Obligatorio. Dirección URL que se usa para iniciar la actividad en la mejor experiencia nativa representada por appId. Puede iniciar una aplicación basada en web si no existe ninguna aplicación nativa.
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 configurable a través del Centro de desarrollo de Windows. El archivo JSON se denomina cross-platform-app-identifiers y se hospeda en la raíz del dominio HTTPS, ya sea en el dominio de nivel superior o en un 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.
appActivityId Cadena Obligatorio. Identificador de actividad único en el contexto de la aplicación, proporcionado por el autor de la llamada e inmutable a partir de entonces.
appDisplayName Cadena Opcional. Descripción de texto breve de la aplicación usada para generar la actividad para su uso en casos en los que la aplicación no está instalada en el dispositivo local del usuario.
contentInfo Objeto JSON sin tipo Opcional. Un fragmento de datos personalizado: descripción extensible JSON-LD del contenido según schema.org sintaxis.
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, un puntero a un elemento de una fuente RSS).
createdDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando se creó el objeto en el servidor.
expirationDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando el objeto expiró en el servidor.
fallbackUrl Cadena Opcional. Dirección URL que se usa para iniciar la actividad en una aplicación basada en web, si está disponible.
id Cadena Identificador generado por el servidor que se usa para el direccionamiento de direcciones URL.
lastModifiedDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando se modificó el objeto en el servidor.
status status Establecido por el servidor. Código de estado que se usa para identificar objetos válidos. Valores: activos, actualizados, eliminados, omitidos.
userTimezone Cadena Opcional. La zona horaria en la que se encontraba el dispositivo del usuario para generar la actividad en el momento de la creación de la actividad; valores proporcionados como identificadores de Olson para admitir la representación multiplataforma.
visualElements visualInfo Obligatorio. Objeto que contiene información para representar la actividad en la experiencia de usuario.

Relaciones

Relación Tipo Description
historyItems activityHistoryItem (colección) Opcional. NavigationProperty/Contención; propiedad navigation a historyItems de la actividad.

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": "active | updated | deleted | ignored",
    "contentInfo": { "@odata.type": "microsoft.graph.Json" },
    "visualElements": { "@odata.type": "microsoft.graph.visualInfo" },
    "historyItems": [{ "@odata.type": "microsoft.graph.activityHistoryItem" }]
}