Aktivitäts Ressourcentypactivity resource type

Stellt eine einzelne Aktivität in einer APP dar, beispielsweise eine TV-Sendung, ein Dokument oder eine aktuelle Kampagne in einem Videospiel.Represents a single activity within an app - for example, a TV show, a document, or a current campaign in a video game. Wenn ein Benutzer diese Aktivität einsetzt, wird das Engagement als Verlaufselement erfasst, das die Anfangs-und Endzeit für diese Aktivität angibt.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. Wenn sich der Benutzer im Laufe der Zeit erneut mit dieser Aktivität beschäftigt, werden mehrere Verlaufselemente für eine einzelne Benutzeraktivität aufgezeichnet.As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.

Sie können Aktivitäten in Microsoft Graph verwenden, um Benutzern die Möglichkeit zu geben, ihre Aufgaben in Ihrer APP auf mehreren Geräten wieder aufzurufen.You can use activities in Microsoft Graph to enable users to get back to what they were doing in their app, across multiple devices. Aktivitäten, die Ihre APP erstellt, werden auf den Geräten aller Benutzer angezeigt und für Benutzer als tiefe Links zu bestimmten Inhalten in ihrer app verfügbar gemacht.Activities that your app creates appear on all users' devices, and are exposed to users as deep links to specific content within your app. Sie können bestimmte Inhalte in ihrer App als ein Zielausdrücken, das in Windows präsentiert wird und auf IOS-und Android-Geräten über Cortana-Benachrichtigungen zugänglich ist.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.

Da jede APP unterschiedlich ist, liegt es an Ihnen, die beste Möglichkeit zum Zuordnen von Aktionen in Ihrer Anwendung zu Benutzeraktivitäten zu verstehen, die in Cortana und in der Zeitachse angezeigt werden.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. Beispielsweise können Spiele eine Aktivität für jede Kampagne erstellen, die Dokument Erstellungs Apps erstellen möglicherweise eine Aktivität für jedes einzelne Dokument, und branchenbezogene Apps erstellen möglicherweise eine Aktivität für jeden Workflow.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.

Ihre Benutzeraktivitäten werden in Cortana und Windows-Zeitskala-Benutzer Erfahrungen vorgestellt, die sich auf die Steigerung der Produktivität und Effizienz von Benutzern konzentrieren, indem Sie Ihnen helfen, wieder auf Inhalte zurückzukommen, an denen Sie in der Vergangenheit gearbeitet haben.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.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Aktivität erstellen oder ersetzenCreate or replace activity Kommentaraktivitätactivity Erstellt oder ersetzt eine vorhandene Aktivität (Upsert).Creates or replaces an existing activity (upsert). Das appActivityId muss URL-sicher sein (alle Zeichen mit Ausnahme von nicht reservierten RFC 2396-Zeichen müssen in ihre Hexadezimaldarstellung konvertiert werden), aber das ursprüngliche appActivityId muss nicht URL-sicher sein.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.
Aktivität löschenDelete an activity Kein InhaltNo Content Löscht die angegebene Aktivität für diesen Benutzer aus Ihrer APP.Deletes the specified activity for that user from your app.
Aktivitäten abrufenGet activities Sammlung von AktivitätenCollection of activities Ruft die Aktivitäten für Ihre APP für einen bestimmten Benutzer ab.Gets the activities for your app for a given user.
Aktuelle Aktivitäten abrufenGet recent activities Sammlung von AktivitätenCollection of activities Ruft die neuesten Aktivitäten für Ihre APP für einen bestimmten Benutzer sortiert und basierend auf der zuletzt erstellten oder aktualisierten historyItems.Gets the most recent activities for your app for a given user, sorted and based on the most recently created or updated historyItems.

EigenschaftenProperties

NameName TypType BeschreibungDescription
userTimezoneuserTimezone StringString Optional.Optional. Die Zeitzone, in der das Gerät des Benutzers zum Generieren der Aktivität zum Zeitpunkt der Aktivitätserstellung gefunden wurde; Werte, die als Olson-IDs bereitgestellt werden, um die plattformübergreifende Darstellung zu unterstützen.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 Vom Server festgelegt.Set by the server. DateTime in UTC, als das Objekt auf dem Server erstellt wurde.DateTime in UTC when the object was created on the server.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Vom Server festgelegt.Set by the server. DateTime in UTC, wenn das Objekt auf dem Server geändert wurde.DateTime in UTC when the object was modified on the server.
idid StringString Server generierte ID, die für die URL-Adressierung verwendet wird.Server-generated ID used for URL addressing.
appActivityIdappActivityId StringString Erforderlich.Required. Die eindeutige Aktivitäts-ID im Kontext der vom Aufrufer bereitgestellten APP und danach unveränderlich.The unique activity ID in the context of the app - supplied by caller and immutable thereafter.
activitySourceHostactivitySourceHost StringString Erforderlich.Required. URL für die Domäne, die die plattformübergreifende Identitätszuordnung für die APP darstellt.URL for the domain representing the cross-platform identity mapping for the app. Die Zuordnung wird entweder als in der Domäne gehostete JSON-Datei oder über Windows dev Center konfiguriert gespeichert.Mapping is stored either as a JSON file hosted on the domain or configurable via Windows Dev Center. Die JSON-Datei heißt plattformübergreifend-App-Identifier und wird im Stammverzeichnis Ihrer HTTPS-Domäne gehostet, entweder in der Domäne der obersten Ebene oder in einer Unterdomäne.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. Zum Beispiel: https://contoso.com oder https://myapp.contoso.com, jedoch NICHT https://myapp.contoso.com/somepath.For example: https://contoso.com or https://myapp.contoso.com but NOT https://myapp.contoso.com/somepath. Sie müssen über eine eindeutige Datei und Domäne (oder Unterdomäne) pro plattformübergreifender App-Identität verfügen.You must have a unique file and domain (or sub domain) per cross-platform app identity. Beispielsweise ist eine separate Datei und Domäne für Word vs PowerPoint erforderlich.For example, a separate file and domain is needed for Word vs. PowerPoint.
appDisplayNameappDisplayName StringString Optional.Optional. Kurze Textbeschreibung der APP, die verwendet wurde, um die Aktivität für den Fall zu generieren, dass die APP nicht auf dem lokalen Gerät des Benutzers installiert ist.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 Erforderlich.Required. URL, die zum Starten der Aktivität in der besten systemeigenen Umgebung verwendet wird, die durch die-Anwendung dargestellt wird.URL used to launch the activity in the best native experience represented by the appId. Möglicherweise wird eine webbasierte App gestartet, wenn keine systemeigene app vorhanden ist.Might launch a web-based app if no native app exists.
fallbackUrlfallbackUrl StringString Optional.Optional. URL, die zum Starten der Aktivität in einer webbasierten App verwendet wird (sofern verfügbar).URL used to launch the activity in a web-based app, if available.
contentUrlcontentUrl StringString Optional.Optional. Wird für den Fall verwendet, dass der Inhalt außerhalb einer systemeigenen oder webbasierten App-Umgebung gerendert werden kann (beispielsweise ein Zeiger auf ein Element in einem RSS-Feed).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 Erforderlich.Required. Das Objekt, das Informationen zum Rendern der Aktivität im UX enthält.The object containing information to render the activity in the UX.
contentInfocontentInfo Nicht typisiertes JSON-ObjektUntyped JSON object Optional.Optional. Ein benutzerdefiniertes Datenelement-JSON-LD Extensible Description of Content entsprechend der Schema.org -Syntax.A custom piece of data - JSON-LD extensible description of content according to schema.org syntax.
expirationDateTimeexpirationDateTime DateTimeOffsetDateTimeOffset Vom Server festgelegt.Set by the server. DateTime in UTC, wenn das Objekt auf dem Server abgelaufen ist.DateTime in UTC when the object expired on the server.
statusstatus statusstatus Vom Server festgelegt.Set by the server. Ein Statuscode, der zum Identifizieren gültiger Objekte verwendet wird.A status code used to identify valid objects. Werte: aktiv, aktualisiert, gelöscht, ignoriert.Values: active, updated, deleted, ignored.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
historyItemshistoryItems activityHistoryItem -SammlungactivityHistoryItem collection Optional.Optional. NavigationProperty/Containment; Navigationseigenschaft des historyItems der Aktivität.NavigationProperty/Containment; navigation property to the activity's historyItems.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der 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" }]
}