Verwenden der REST-API für AktivitätsfeedsUse the activity feed REST API

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Sie können die Aktivitätsfeed-API in Microsoft Graph verwenden, um die Aktivität eines Benutzers über Geräte und Plattformen hinweg fortzusetzen.You can use the activity feed API in Microsoft Graph to resume a user's activity across devices and platforms. API-Anforderungen für Aktivitätsfeeds werden im Namen eines Benutzers über Delegierte Berechtigungen und die Benutzer Aktivitäts Berechtigungausgeführt, die entweder mit persönlichen Konten oder mit Arbeits-und Schulkonto verwendet werden kann.Activity feed API requests are performed on behalf of a user via delegated permissions and the user activity permission, which can be used with either personal or work and school accounts.

Benutzeraktivitäten werden durch die Activity -Ressource dargestellt und sind in einem zeitbasierten Feed organisiert, dargestellt durch die Sammlung Me/Activities.User activities are represented by the activity resource and are organized in a time-based feed represented by the collection me/activities.

Was macht eine großartige Benutzeraktivität aus?What makes a great user activity?

Benutzeraktivitäten starten nicht nur apps, sondern sind tiefe Links zu bestimmten Inhalten in Ihrer APP.User activities don’t just launch apps — they are deep links into specific content within your app. Die von Ihnen erstellten Benutzeraktivitäten können nicht nur in ihrer eigenen App, sondern auch in Cortana und in der Windows-Zeitleiste angezeigt werden, was zu einer weiteren erneuten Wiedereinschaltung der APP führt und es Ihren Benutzern einfacher macht, Ihre APP weiterhin über mehrere Geräte hinweg zu verwenden.The user activities you create can not only be used in your own app, but will also appear in Cortana and Windows Timeline — driving more app reengagement and making it easier for your users to continue using your app across multiple devices.

Was sollte eine Aktivität werden?What should become an activity?

Da jede APP unterschiedlich ist, muss jeder App-Entwickler die beste Möglichkeit zum Zuordnen von Aktionen in der Anwendung zu Benutzeraktivitäten verstehen.Because every app is different, it's up to each app developer to understand the best way to map actions within your application to user activities. Beispielsweise können Spiele eine Aktivität für jede Kampagne erstellen, Dokument Erstellungs-Apps können eine Aktivität für jedes einzelne Dokument erstellen, und Branchen-Apps können eine Aktivität für jeden Workflow erstellen.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.

Wenden Sie die folgenden Richtlinien an, wenn Sie Aktivitäten signifikant steigern in Ihrer APP definieren:Apply the following guidlines as you define activitites in your app:

Do: Zeichnet eine einzelne Aktivität für eine Gruppe verwandter Benutzeraktionen auf.DO: Record a single activity for a group of related user actions. Wenn Ihre Anwendung für eine Abfolge von verwandten Inhalten verwendet wird, ist es wahrscheinlich sinnvoll, eine einzelne Aktivität für die gesamte Engagement-Sitzung aufzuzeichnen.If your application is used for a sequence of related content, it probably makes sense to record a single activity for the entire engagement session.

Wiedergabelisten Szenarien: Dies ist insbesondere für Musikwiedergabelisten oder TV-Sendungen relevant – eine einzelne Benutzeraktivität kann aktualisiert werden, um den Fortschritt anzuzeigen.Playlist scenarios: This is especially relevant for music playlists or TV shows — a single user activity can be updated to show your progress. In diesem Fall verfügen Sie über eine einzelne Benutzeraktivität mit mehreren Verlaufs Elementen , die Zeiträume für mehrere Tage oder Wochen darstellen.In this case, you will have a single user activity with multiple history items representing periods of engagement across multiple days or weeks.

Do: Speichern von Benutzerdaten in der CloudDO: Store user data to the cloud. Wenn Sie Geräteübergreifende Aktivitäten unterstützen möchten, müssen Sie sicherstellen, dass der zum erneuten Einbinden dieser Aktivität erforderliche Inhalt an einem Cloud-Speicherort gespeichert wird.If you want to support cross-device activities, you need to make sure the content required to reengage this activity is stored to a cloud location. Wenn Sie beispielsweise eine Aktivität veröffentlichen, wenn ein Benutzer ein Dokument bearbeitet, sollte das Dokument in der Cloud gespeichert werden, im Gegensatz zu lokal auf dem Gerät des Benutzers, um die Geräteübergreifende Wiederverwendung zu aktivieren.For example, if you publish an activity each time a user edits a document, the document should be stored in the cloud as opposed to locally on the user's device in order to enable cross-device reengagement.

Nicht: Erstellen Sie eine Benutzeraktivität für Aktionen, die Benutzer in Zukunft nicht wieder aufnehmen müssen.DO NOT: Create a user activity for actions that users do not need to resume in the future. Wenn Ihre Anwendung zum Ausführen einfacher, einmaliger Vorgänge verwendet wird, die den Status nicht beibehalten, damit Sie in Zukunft nachverfolgen können, müssen Sie wahrscheinlich keine Benutzeraktivität schreiben.If your application is used to complete simple, one-time operations that do not persist status for you to track in the future, you probably do not need to write a user activity.

Um klar zu sein, obwohl Benutzeraktivitäten in der Windows-zeitAchse angezeigt werden, ist dies nicht als Versions Verwaltungstool konzipiert – die Auswahl einer dokumentbasierten Aktivität sollte immer die neueste Version des Dokuments anzeigen (einschließlich der von anderen Benutzern vorgenommenen Änderungen).To be clear, even though user activities appear in Windows Timeline, this is not designed as a versioning tool — choosing a document-based activity should always show the latest version of that document (including changes that were made by another user.)

Nicht: Erstellen Sie eine Benutzeraktivität für Aktionen, die von anderen Benutzernabgeschlossen wurden.DO NOT: Create a user activity for actions completed by other users. Wenn jemand dem Benutzer eine Nachricht sendet oder den Benutzer in Ihrer APP @mentions, sollten Sie keine neue Aktivität schreiben.If someone sends the user a message, or @mentions the user within your app, you should not write a new activity. Diese Interaktionen dienen besser der Oberflächenbehandlung von Benachrichtigungen.These interactions are better served by surfacing notifications.

Zusammenarbeitsszenarien: Wenn mehrere Personen an derselben Aktivität (beispielsweise einem Word-Dokument) arbeiten, gibt es Fälle, in denen ein anderer Benutzer Änderungen am Dokument vorgenommen hat, nachdem Sie ihn zuletzt bearbeitet haben.Collaboration scenarios: If multiple people are working on the same activity (such as a Word document), there will be cases when another user has made changes to the document after you last edited it. In diesem Fall können App-Entwickler die visuellen Elemente in der Aktivität aktualisieren, um die am Dokument vorgenommenen Änderungen widerzuspiegeln.In this case, app developers might want to update the visual elements in the activity to reflect changes made to the document. Zu diesem Zweck kann die APP die vorhandene Aktivität aktualisieren, ohne ein neues Verlaufselement zu erstellen.To do this, the app might update the existing activity without creating a new history item.

Hinweis: Wenn Sie Aktivitäten für eine Webanwendung veröffentlichen, ist es wichtig, sowohl eine activationURL als auch eine fallbackURL für jede ihrer Aktivitäten einzufügen.Note: If you're publishing activities for a web application, it's important to include both an activationURL and a fallbackURL for each of your activities. Die Aktivitäten starten den Benutzer wieder in Ihre APP, wie aus Microsoft-Erfahrungen wie Windows Timeline zu erwarten.The activities will launch the user back into your app as expected from Microsoft experiences like Windows Timeline.

App-Interaktionsmuster und BenutzeraktivitätenApp interaction patterns and user activities

Die Benutzeraktivitäten, die Sie erstellen, unterscheiden sich je nach dem Interaktionsmuster Ihrer APP.The user activities that you create will vary based on the interaction pattern of your app. Während jede APP unterschiedlich ist, fallen die meisten in eines der folgenden Interaktionsmuster:While every app is different, most will fall into one of the following interaction patterns:

  • Dokumentbasierte apps – erstellen Sie eine Aktivität pro Dokument mit einem oder mehreren Verlaufsdatensätzen, die die Nutzungsdauer widerspiegeln.Document-based apps — Create one activity per document with one or more history records reflecting periods of use. Es ist wichtig, ihre Aktivitäts Karte zu aktualisieren, wenn Änderungen am Dokument vorgenommen werden.It is important to update your activity card as changes are made to the document.
  • Apps für die Medienwiedergabe : Erstellen Sie eine Aktivität pro logischer Gruppierung von Inhalten, beispielsweise eine Wiedergabeliste, ein Programm oder einen eigenständigen Inhalt.Media playback apps — Create one activity per logical grouping of content such as a playlist, program, or standalone content.
  • Spiele : Erstellen Sie eine Aktivität für jedes gespeicherte Spiel oder jede beliebige Welt.Games — Create one activity for each saved game or world. Wenn Ihr Spiel nur eine einzelne Sequenz von Ebenen unterstützt, können Sie dieselbe Aktivität im Laufe der Zeit schreiben, obwohl Sie Ihre Karte aktualisieren möchten, um Ihre neuesten Fortschritte oder Erfolge anzuzeigen.If your game supports only a single sequence of levels, you can write the same activity over time, although you might want to update your card to show your latest progress or achievements.
  • Hilfsprogramm-apps – wenn sich in Ihrer APP nichts befindet, das Benutzer fortsetzen möchten, sollten Sie keine Aktivitäten veröffentlichen.Utility apps — If there is nothing within your app that users would want to resume, you should not publish activities. Ein gutes Beispiel hierfür ist eine einfache APP wie Rechner.A good example is a simple single-purpose app like calculator.
  • Branchen- apps – viele apps sind für die Verwaltung einfacher Aufgaben oder Workflows vorhanden.Line-of-business apps — Many apps exist for managing simple tasks or workflows. Erstellen Sie eine Aktivität für jeden einzelnen Workflow, auf den über Ihre App zugegriffen wird.Create one activity for each separate workflow accessed through your app. Beispielsweise wäre jede Spesenabrechnung eine separate Aktivität, da Sie möglicherweise auf diese Aktivität klicken möchten, um zu prüfen, ob Sie genehmigt wurde.For example, each expense report would be a separate activity, because you might want to click that activity to see if it was approved.

Einige komplexe apps schließen mehrere Interaktionsmuster ein. Möglicherweise möchten Sie verschiedene Benutzer Aktivitäts Erstellungs Muster für verschiedene Szenarien ausführen, die von Ihrer APP verarbeitet werden.Some complex apps include multiple interaction patterns. You might want to follow different user activity creation patterns for different scenarios handled by your app.

Nächste SchritteNext steps

Suchen Sie nach weiteren Ideen?Looking for more ideas?