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

Sie können die Aktivitätsfeed-API in Microsoft Graph verwenden, um die Aktivitäten eines Benutzers auf allen Geräten und Plattformen 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 mit persönlichen oder geschäftlichen und Schul Konten 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 Aktivitäts Ressource dargestellt und in einem zeitbasierten Feed organisiert, der durch die Auflistung Me/Activities dargestellt wird.User activities are represented by the activity resource and are organized in a time-based feed represented by the collection me/activities.

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

Benutzeraktivitäten starten nicht einfach apps – Sie 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 Benutzeraktivitäten, die Sie erstellen, können nicht nur in ihrer eigenen App verwendet werden, sondern auch in Cortana und in der Windows-Zeitachse angezeigt werden, wodurch mehr apps wieder eingezogen werden und es den Benutzern leichter gemacht wird, Ihre APP über mehrere Geräte hinweg weiterhin 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, 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.

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

Ausführen: Zeichnen Sie 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 Sequenz verwandter Inhalte 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 haben Sie eine einzelne Benutzeraktivität mit mehreren Verlaufs Elementen , die Zeiträume des Engagements 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.

Ausführen: Speichern von Benutzerdaten in der Cloud.DO: Store user data to the cloud. Wenn Sie Geräteübergreifende Aktivitäten unterstützen möchten, müssen Sie sicherstellen, dass die zum erneuten Aktivieren dieser Aktivität erforderlichen Inhalte an einem Cloud-Speicherort gespeichert werden.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 jedes Mal 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 eine Geräteübergreifende erneute Aktivierung zu ermöglichen.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 mehr fortsetzen müssen.DO NOT: Create a user activity for actions that users do not need to resume in the future. Wenn Ihre Anwendung zum Abschließen einfacher, einmaliger Vorgänge verwendet wird, die den Status nicht in Zukunft aufrecht erhalten, 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 es deutlich zu sagen: Obwohl Benutzeraktivitäten in der Windows-Zeitachse angezeigt werden, ist dies nicht als Versions Verwaltungstool gedacht: bei der Auswahl einer dokumentbasierten Aktivität sollte immer die neueste Version dieses Dokuments angezeigt werden (einschließlich der Änderungen, die von einem anderen Benutzer vorgenommen wurden).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 werden besser durch Oberflächen Benachrichtigungen bedient.These interactions are better served by surfacing notifications.

Szenarien für die Zusammenarbeit: Wenn mehrere Personen an derselben Aktivität Arbeiten (beispielsweise ein Word-Dokument), gibt es Fälle, in denen ein anderer Benutzer nach der letzten Bearbeitung des Dokuments Änderungen am Dokument vorgenommen hat.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 möchten App-Entwickler möglicherweise 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. Dazu 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 einzubeziehen.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 Ihrer APP, wie von Microsoft-Erfahrungen wie Windows-Zeitachse erwartet.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 von Ihnen erstellten Benutzeraktivitäten variieren basierend auf 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 einem 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 mindestens einem Verlaufsdatensatz, der die Nutzungszeiten reflektiert.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 Medienwiedergabe – erstellen Sie eine Aktivität pro logischer Gruppierung von Inhalten wie einer Wiedergabeliste, einem Programm oder eigenständigen Inhalten.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 die gleiche Aktivität im Laufe der Zeit schreiben, obwohl Sie möglicherweise Ihre Karte aktualisieren möchten, um Ihre neuesten Fortschritte oder Ergebnisse 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.
  • Dienstprogramm-apps : Wenn Ihre APP nichts enthält, das von Benutzern wieder aufgenommen werden soll, 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 mit einem einzigen Zweck.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 überprü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 umfassen mehrere Interaktionsmuster. Möglicherweise möchten Sie verschiedene Erstellungs Muster für Benutzeraktivitäten für verschiedene Szenarien befolgen, 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?