type de ressource activitéactivity resource type

Représente une activité unique dans une application (par exemple, une émission téléVISÉE, un document ou une campagne en cours dans un jeu vidéo).Represents a single activity within an app - for example, a TV show, a document, or a current campaign in a video game. Lorsqu'un utilisateur s'engage avec cette activité, l'engagement est capturé comme un élément d'historique qui indique l'heure de début et de fin de cette activité.When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. Lorsque l'utilisateur réagit avec cette activité dans le temps, plusieurs éléments d'historique sont enregistrés pour une activité utilisateur unique.As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.

Vous pouvez utiliser des activités dans Microsoft Graph pour permettre aux utilisateurs de revenir à ce qu'ils étaient dans leur application, sur plusieurs appareils.You can use activities in Microsoft Graph to enable users to get back to what they were doing in their app, across multiple devices. Les activités créées par votre application apparaissent sur tous les appareils de l'utilisateur et sont exposées aux utilisateurs sous la forme de liens détaillés vers un contenu spécifique de votre application.Activities that your app creates appear on all users' devices, and are exposed to users as deep links to specific content within your app. Vous pouvez exprimer un contenu spécifique au sein de votre application comme destination dans Windows et accessible sur des appareils iOS et Android via des notifications Cortana.You can express specific content within your app as a destination that is showcased in Windows, and accessible on iOS and Android devices through Cortana notifications.

Étant donné que chaque application est différente, c'est à vous de comprendre la meilleure façon de mapper les actions au sein de votre application aux activités de l'utilisateur qui apparaîtront dans Cortana et chronologie.Because every app is different, it's up to you to understand the best way to map actions within your application to user activities that will appear in Cortana and Timeline. Par exemple, les jeux peuvent créer une activité pour chaque campagne, les applications de création de documents peuvent créer une activité pour chaque document unique, et les applications métier peuvent créer une activité pour chaque flux de travail.For example, games might create an activity for each campaign, document authoring apps might create an activity for each unique document, and line-of-business apps might create an activity for each workflow.

Vos activités utilisateur seront présentées dans Cortana et dans les expériences utilisateur de la chronologie Windows, qui sont axées sur l'augmentation de la productivité et de l'efficacité des utilisateurs en les aidant à revenir au contenu sur lequel elles ont travaillé dans le passé.Your user activities will be showcased in Cortana and Windows Timeline user experiences, which are focused on increasing users' productivity and efficiency by helping them get back to content they worked on in the past.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Créer ou remplacer une activitéCreate or replace activity activitéactivity Crée ou remplace une activité existante (upsert).Creates or replaces an existing activity (upsert). Le appActivityId doit être sécurisé URL (tous les caractères sauf pour les caractères non réservés RFC 2396 doivent être convertis en leur représentation hexadécimale), mais l'appActivityId d'origine n'a pas besoin d'être sécurisée URL.The appActivityId needs to be URL-safe (all characters except for RFC 2396 unreserved characters must be converted to their hexadecimal representation), but the original appActivityId does not have to be URL-safe.
Supprimer une activitéDelete an activity Aucun contenuNo Content Supprime l'activité spécifiée pour cet utilisateur de votre application.Deletes the specified activity for that user from your app.
Obtenir les activitésGet activities Collection d' activitésCollection of activities Obtient les activités de votre application pour un utilisateur donné.Gets the activities for your app for a given user.
Obtenir les activités récentesGet recent activities Collection d' activitésCollection of activities Obtient les activités les plus récentes de votre application pour un utilisateur donné, triées et basées sur le historyItemsrécemment créé ou mis à jour.Gets the most recent activities for your app for a given user, sorted and based on the most recently created or updated historyItems.

PropriétésProperties

NomName TypeType DescriptionDescription
userTimezoneuserTimezone ChaîneString Facultatif.Optional. Le fuseau horaire dans lequel l'appareil de l'utilisateur a utilisé pour générer l'activité a été localisé lors de la création de l'activité; valeurs fournies en tant qu'ID Olson afin de prendre en charge la représentation interplateformes.The timezone in which the user's device used to generate the activity was located at activity creation time; values supplied as Olson IDs in order to support cross-platform representation.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Défini par le serveur.Set by the server. Date et heure au format UTC lors de la création de l'objet sur le serveur.DateTime in UTC when the object was created on the server.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Défini par le serveur.Set by the server. Date et heure au format UTC lors de la modification de l'objet sur le serveur.DateTime in UTC when the object was modified on the server.
idid StringString ID généré par le serveur utilisé pour l'adressage URL.Server-generated ID used for URL addressing.
appActivityIdappActivityId StringString Obligatoire.Required. ID d'activité unique dans le contexte de l'application par l'appelant et non modifiable par la suite.The unique activity ID in the context of the app - supplied by caller and immutable thereafter.
activitySourceHostactivitySourceHost StringString Obligatoire.Required. URL du domaine représentant le mappage d'identité multiplateforme pour l'application.URL for the domain representing the cross-platform identity mapping for the app. Le mappage est stocké sous la forme d'un fichier JSON hébergé sur le domaine ou configurable via le centre de développement Windows.Mapping is stored either as a JSON file hosted on the domain or configurable via Windows Dev Center. Le fichier JSON est nommé multiplateforme-application-identificateurs et est hébergé à la racine de votre domaine HTTPs, soit au niveau du domaine de niveau supérieur, soit en tant que sous-domaine.The JSON file is named cross-platform-app-identifiers and is hosted at root of your HTTPS domain, either at the top level domain or include a sub domain. Par exemple : https://contoso.com ou https://myapp.contoso.com mais PAS https://myapp.contoso.com/somepath.For example: https://contoso.com or https://myapp.contoso.com but NOT https://myapp.contoso.com/somepath. Vous devez disposer d'un fichier et d'un domaine uniques (ou sous-domaines) par identité d'application multiplateforme.You must have a unique file and domain (or sub domain) per cross-platform app identity. Par exemple, un fichier et un domaine distincts sont nécessaires pour Word et PowerPoint.For example, a separate file and domain is needed for Word vs. PowerPoint.
appDisplayNameappDisplayName ChaîneString Facultatif.Optional. Texte court description de l'application utilisée pour générer l'activité à utiliser dans les cas où l'application n'est pas installée sur l'appareil local de l'utilisateur.Short text description of the app used to generate the activity for use in cases when the app is not installed on the user’s local device.
activationUrlactivationUrl StringString Obligatoire.Required. URL utilisée pour lancer l'activité dans la meilleure expérience Native représentée par l'appId.URL used to launch the activity in the best native experience represented by the appId. Peut lancer une application Web s'il n'existe aucune application native.Might launch a web-based app if no native app exists.
fallbackUrlfallbackUrl ChaîneString Facultatif.Optional. URL utilisée pour lancer l'activité dans une application Web, si disponible.URL used to launch the activity in a web-based app, if available.
contentUrlcontentUrl ChaîneString Facultatif.Optional. Utilisé dans l'éventualité où le contenu peut être rendu en dehors d'une expérience d'application native ou basée sur le Web (par exemple, un pointeur vers un élément dans un flux RSS).Used in the event the content can be rendered outside of a native or web-based app experience (for example, a pointer to an item in an RSS feed).
visualElementsvisualElements visualInfovisualInfo Obligatoire.Required. Objet contenant des informations pour afficher l'activité dans l'expérience utilisateur.The object containing information to render the activity in the UX.
contentInfocontentInfo Objet JSON non typéUntyped JSON object Facultatif.Optional. Un élément personnalisé de données-JSON-LD extensible Description du contenu conformément à la syntaxe Schema.org .A custom piece of data - JSON-LD extensible description of content according to schema.org syntax.
expirationDateTimeexpirationDateTime DateTimeOffsetDateTimeOffset Défini par le serveur.Set by the server. Date et heure au format UTC lorsque l'objet a expiré sur le serveur.DateTime in UTC when the object expired on the server.
statusstatus statusstatus Défini par le serveur.Set by the server. Un code d'État utilisé pour identifier les objets valides.A status code used to identify valid objects. Valeurs: actif, mis à jour, supprimé, ignoré.Values: active, updated, deleted, ignored.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
historyItemshistoryItems collection activityHistoryItemactivityHistoryItem collection Facultatif.Optional. NavigationProperty/contention; propriété de navigation du historyItems de l'activité.NavigationProperty/Containment; navigation property to the activity's historyItems.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.Here is a JSON representation of the resource.

{
    "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" }]
}