Aktivitäts Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt eine einzelne Aktivität in einer APP dar, beispielsweise eine TV-Sendung, ein Dokument oder eine aktuelle Kampagne in einem Videospiel. Wenn ein Benutzer diese Aktivität einsetzt, wird das Engagement als Verlaufselement erfasst, das die Anfangs-und Endzeit für diese Aktivität angibt. 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.

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. 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. 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.

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. 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.

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.

Methoden

Methode	Rückgabetyp	Beschreibung
Aktivität erstellen oder ersetzen	Kommentaraktivität	Erstellt oder ersetzt eine vorhandene Aktivität (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.
Aktivität löschen	Kein Inhalt	Löscht die angegebene Aktivität für diesen Benutzer aus Ihrer APP.
Aktivitäten abrufen	Sammlung von Aktivitäten	Ruft die Aktivitäten für Ihre APP für einen bestimmten Benutzer ab.
Aktuelle Aktivitäten abrufen	Sammlung von Aktivitäten	Ruft die neuesten Aktivitäten für Ihre APP für einen bestimmten Benutzer sortiert und basierend auf der zuletzt erstellten oder aktualisierten historyItems.

Eigenschaften

Name	Typ	Beschreibung
userTimezone	Zeichenfolge	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.
createdDateTime	DateTimeOffset	Vom Server festgelegt. DateTime in UTC, als das Objekt auf dem Server erstellt wurde.
lastModifiedDateTime	DateTimeOffset	Vom Server festgelegt. DateTime in UTC, wenn das Objekt auf dem Server geändert wurde.
id	String	Server generierte ID, die für die URL-Adressierung verwendet wird.
appActivityId	String	Erforderlich. Die eindeutige Aktivitäts-ID im Kontext der vom Aufrufer bereitgestellten APP und danach unveränderlich.
activitySourceHost	String	Erforderlich. URL für die Domäne, die die plattformübergreifende Identitätszuordnung für die APP darstellt. Die Zuordnung wird entweder als in der Domäne gehostete JSON-Datei oder über Windows dev Center konfiguriert gespeichert. 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. Zum Beispiel: https://contoso.com oder https://myapp.contoso.com, jedoch NICHT 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. Beispielsweise ist eine separate Datei und Domäne für Word vs PowerPoint erforderlich.
appDisplayName	Zeichenfolge	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.
activationUrl	String	Erforderlich. URL, die zum Starten der Aktivität in der besten systemeigenen Umgebung verwendet wird, die durch die-Anwendung dargestellt wird. Möglicherweise wird eine webbasierte App gestartet, wenn keine systemeigene app vorhanden ist.
fallbackUrl	Zeichenfolge	Optional. URL, die zum Starten der Aktivität in einer webbasierten App verwendet wird (sofern verfügbar).
contentUrl	Zeichenfolge	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).
visualElements	visualInfo	Erforderlich. Das Objekt, das Informationen zum Rendern der Aktivität im UX enthält.
contentInfo	Nicht typisiertes JSON-Objekt	Optional. Ein benutzerdefiniertes Datenelement-JSON-LD Extensible Description of Content entsprechend der Schema.org -Syntax.
expirationDateTime	DateTimeOffset	Vom Server festgelegt. DateTime in UTC, wenn das Objekt auf dem Server abgelaufen ist.
status	Zeichenfolge	Vom Server festgelegt. Ein Statuscode, der zum Identifizieren gültiger Objekte verwendet wird. Werte: aktiv, aktualisiert, gelöscht, ignoriert.

Beziehungen

Beziehung	Typ	Beschreibung
historyItems	historyItem -Sammlung	Optional. NavigationProperty/Containment; Navigationseigenschaft des historyItems der Aktivität.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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