tipo de recurso activity

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 juego de vídeo. Cuando un usuario interactúa 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 con el tiempo, se registran varios elementos de historial para una sola actividad de usuario.

Puedes usar actividades en Microsoft Graph para permitir a los usuarios volver a lo que hacían 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 Cortana notificaciones.

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

Métodos

Método Tipo de valor devuelto Descripción
Crear o reemplazar actividad activity Crea o reemplaza una actividad existente (upsert). AppActivityId debe ser seguro para 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 una actividad Sin contenido Elimina la actividad especificada para ese usuario de la aplicación.
Obtener actividades Colección de actividades Obtiene las actividades de la aplicación para un usuario determinado.
Obtener actividades recientes Colección de actividades Obtiene las actividades más recientes de la aplicación para un usuario determinado, ordenadas y basadas en los historyItems creados o actualizados más recientemente.

Propiedades

Nombre Tipo Descripción
userTimezone Cadena Opcional. La zona horaria en la que se usó el dispositivo del usuario para generar la actividad se encontraba en el momento de la creación de la actividad; valores proporcionados como IDs de Olson para admitir la representación entre plataformas.
createdDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando se creó el objeto en el servidor.
lastModifiedDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando se modificó el objeto en el servidor.
id Cadena Id. generado por el servidor usado para el direccionamiento de direcciones URL.
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.
activitySourceHost Cadena Obligatorio. Dirección URL del dominio que representa la asignación de identidad entre plataformas para la aplicación. La asignación se almacena como un archivo JSON hospedado en el dominio o configurable mediante Windows Centro de desarrollo. 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 incluir un subdominio. Por ejemplo: https://contoso.com o https://myapp.contoso.com, pero NO https://myapp.contoso.com/somepath. Debes 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. Breve descripción de texto de la aplicación usada para generar la actividad para su uso en 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 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 en una fuente RSS).
visualElements visualInfo Necesario. El objeto que contiene información para representar la actividad en la experiencia de usuario.
contentInfo Objeto JSON sin tipo Opcional. Una parte personalizada de datos: descripción extensible JSON-LD del contenido según schema.org sintaxis.
expirationDateTime DateTimeOffset Establecido por el servidor. DateTime en UTC cuando el objeto expiró en el servidor.
status status Establecido por el servidor. Código de estado usado para identificar objetos válidos. Valores: activo, actualizado, eliminado, omitido.

Relaciones

Relación Tipo Descripción
historyItems colección activityHistoryItem Opcional. NavigationProperty/Containment; propiedad navigation a historyItems de la actividad.

Representación JSON

Aquí tiene una representación JSON del 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" }]
}