Verwenden Sie den Aktivitätsfeed REST-APIUse the activity feed REST API

Wichtig: Die APIs der /Beta-Version in Microsoft Graph befinden sich in der Vorschau und können Änderungen unterliegen.Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktivitätsfeed API in Microsoft Graph können Sie die Aktivität des Benutzers Geräte-und plattformübergreifend fortsetzen.You can use the activity feed API in Microsoft Graph to resume a user's activity across devices and platforms. Aktivität feed API-Anfragen werden ausgeführt, im Auftrag eines Benutzers über Berechtigungen delegiert und die Benutzerberechtigungen für die Aktivität, die mit entweder persönliche oder Arbeit und Schule Konten verwendet werden können.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.

Die Benutzeraktivitäten werden von der Ressource Aktivität dargestellt und sind organisiert ein Feed zeitbasierte dargestellt durch die Auflistung mich / Aktivitäten.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 hervorragende Benutzeraktivität?What makes a great user activity?

Die Benutzeraktivitäten nicht starten Sie apps – sie deep-Links in spezifischem Inhalt Ihrer App sind.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, aber auch im Cortana und Windows-Zeitachse angezeigt – gesteuerter Weitere app-Reengagement und erleichtert es für Ihre Benutzer weiterhin Ihre app für mehrere Geräte 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 jeder app unterscheidet, ist es zu verstehen, die beste Möglichkeit zum Zuordnen von Aktionen innerhalb der Anwendung auf die Benutzeraktivitäten jeder app-Entwickler.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 Spiele möglicherweise eine Aktivität für jede Kampagne erstellen, Erstellen von apps Dokument möglicherweise eine Aktivität für jedes Dokument erstellen und Line-of-Business-apps möglicherweise 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, wie Sie in Ihrer app Activitites definieren:Apply the following guidlines as you define activitites in your app:

Aktionen aus: Tragen Sie eine einzelne Aktivität für eine Gruppe von verwandten Benutzeraktionen.DO: Record a single activity for a group of related user actions. Wenn Ihre Anwendung bei einer Sequenz von verwandten Inhalten verwendet wird, ist es wahrscheinlich sinnvoll, um eine einzelne Aktivität für die gesamte 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.

Wiedergabeliste Szenarien: Dies ist besonders relevant für Wiedergabelisten oder TV-Programmen – eine Aktivität einzelner Benutzer kann aktualisiert werden, um Ihren 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 müssen Sie eine einzelne Benutzeraktivität mit mehreren Verlaufselemente , die über mehrere Tage oder Wochen hinweg Zeiträume, in denen Engagements darstellt.In this case, you will have a single user activity with multiple history items representing periods of engagement across multiple days or weeks.

Aktionen aus: Speichern von Benutzerdaten in die Cloud.DO: Store user data to the cloud. Wenn Sie Aktivitäten Cross-Gerät unterstützen möchten, müssen Sie sicherstellen, dass der Inhalt erforderlich, um diese Aktivität reengage an einen Speicherort für die Cloud gespeichert ist.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. Angenommen, wenn Sie eine Aktivität eines Dokuments Bearbeitung jedes Mal veröffentlichen, sollte das Dokument in der Cloud im Gegensatz zur lokal auf dem Gerät des Benutzers gespeichert werden, um zwischen Geräten Reengagement 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 nicht benötigen, um zukünftig fortzusetzen.DO NOT: Create a user activity for actions that users do not need to resume in the future. Wenn Ihre Anwendung verwendet wird, zum einfachen, einmaligen Vorgänge ausführen, die Status für Sie in der Zukunft verfolgen nicht beibehalten, müssen wahrscheinlich nicht Sie eine Benutzeraktivität zu 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, obwohl die Benutzeraktivitäten in Windows Zeitachse angezeigt werden, Dies dient nicht als Tool Versioning – auswählen eine Aktivität dokumentbasierten sollte immer die neueste Version des Dokuments (einschließlich Änderungen, die von einem anderen Benutzer vorgenommen wurden.) anzeigenTo 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.DO NOT: Create a user activity for actions completed by other users. Wenn Ihnen jemand eine Nachricht oder @mentions der Benutzer in der app dem Benutzer sendet, sollte eine neue Aktivität nicht geschrieben werden.If someone sends the user a message, or @mentions the user within your app, you should not write a new activity. Diese Interaktionen sind besser versorgt, indem persönliche angezeigt werden Benachrichtigungen.These interactions are better served by surfacing notifications.

Szenarien der Zusammenarbeit: Wenn mehrere Personen für die gleiche Aktivität (beispielsweise ein Word-Dokument) arbeiten, ist es, Fällen, wenn ein anderer Benutzer Änderungen an das Dokument vorgenommen hat, nachdem Sie zuletzt bearbeitet.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 sollten app-Entwickler aktualisieren die visuellen Elemente in der Aktivität entsprechend dem Dokument geändert.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 möglicherweise die app die vorhandene Aktivität aktualisieren, ohne ein neues Historienelement 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 zu veröffentlichen, es ist wichtig, die beide enthalten eine activationURL und eine fallbackURL für jede Ihrer Aktivitäten.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 werden den Benutzer wieder in Ihrer app gestartet erwartungsgemäß aus Microsoft Erfahrungen wie Windows Zeitachse.The activities will launch the user back into your app as expected from Microsoft experiences like Windows Timeline.

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

Die Benutzeraktivitäten, die Sie erstellen variiert basierend auf der Interaktionsmuster Ihrer App.The user activities that you create will vary based on the interaction pattern of your app. Während jeder app unterscheidet, werden die meisten in eine der folgenden Interaktionsmuster gehören:While every app is different, most will fall into one of the following interaction patterns:

  • Dokumentbasierter apps – Erstellen einer Aktivität pro Dokument mit mindestens einen Verlaufsdatensätze spiegeln Zeiträume, in denen verwenden.Document-based apps — Create one activity per document with one or more history records reflecting periods of use. Es ist wichtig, die Aktivität Karte aktualisieren, wie das Dokument geändert wird.It is important to update your activity card as changes are made to the document.
  • Media Wiedergabe apps – Erstellen einer Aktivität pro logische Gruppierung von Inhalt wie eine Wiedergabeliste, Programm oder eigenständigen Inhalte.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 jeden gespeicherte Spiel oder der Praxis.Games — Create one activity for each saved game or world. Wenn das Spiel nur eine einzelne Sequenz von Ebenen unterstützt, können Sie die gleiche Aktivität im Laufe der Zeit schreiben, obwohl sollten Sie die Visitenkarte zum Anzeigen Ihrer aktuellen Status oder Erfolge zu aktualisieren.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 – liegt nothing innerhalb Ihrer app, die Benutzer fortsetzen möchten, sollten Sie Aktivitäten nicht 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 ist eine einfache einfachen Zweck erfüllende app wie Rechner.A good example is a simple single-purpose app like calculator.
  • Branchen apps – viele apps zum Verwalten von Workflows oder einfache Aufgaben vorhanden.Line-of-business apps — Many apps exist for managing simple tasks or workflows. Erstellen Sie eine Aktivität für jeden separate Workflow auf die Sie über Ihre app.Create one activity for each separate workflow accessed through your app. Beispielsweise wäre jede Spesenabrechnung eine separate-Aktivität, da Sie möglicherweise klicken Sie auf diese Aktivität, um festzustellen, 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 enthalten mehrere Interaktionsmuster. Möglicherweise möchten Sie führen die anderen Benutzer Aktivität Erstellung Mustern für die verschiedenen Szenarien, die von Ihrer app behandelt.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

Weitere Ideen suchen?Looking for more ideas?