Verwenden der Aktivitätsfeed-REST-API

  • Artikel

Namespace: microsoft.graph

Sie können die Aktivitätsfeed-API in Microsoft Graph verwenden, um die Aktivitäten eines Benutzers geräte- und plattformübergreifend fortzusetzen. Aktivitätsfeed-API-Anforderungen werden im Namen eines Benutzers über delegierte Berechtigungen und die Benutzeraktivitätsberechtigung ausgeführt, die entweder mit persönlichen Konten oder Geschäfts-, Schul- und Unikonten verwendet werden können.

Benutzeraktivitäten werden durch die Aktivitätsressource dargestellt und in einem zeitbasierten Feed organisiert, der durch die Sammlung me/activities dargestellt wird.

Was macht eine großartige Benutzeraktivität aus?

Benutzeraktivitäten starten nicht nur Apps, sie sind DeepLinks zu bestimmten Inhalten in Ihrer App. Die von Ihnen erstellten Benutzeraktivitäten können nicht nur in Ihrer eigenen App verwendet werden, sondern werden auch in Cortana und der Windows-Zeitachse angezeigt. Dies sorgt für mehr App-Reaktivierung und erleichtert es Ihren Benutzern, Ihre App weiterhin auf mehreren Geräten zu verwenden.

Was sollte eine Aktivität werden?

Da jede App anders ist, liegt es an jedem App-Entwickler, zu verstehen, wie Aktionen innerhalb Ihrer Anwendung am besten benutzerseitigen Aktivitäten zugeordnet werden können. Beispielsweise können Spiele eine Aktivität für jede Kampagne erstellen, Dokumenterstellungs-Apps können eine Aktivität für jedes eindeutige Dokument erstellen, und Branchen-Apps können eine Aktivität für jeden Workflow erstellen.

Wenden Sie die folgenden Richtlinien an, wenn Sie Aktivitäten in Ihrer App definieren:

TUN: Zeichnen Sie eine einzelne Aktivität für eine Gruppe verwandter Benutzeraktionen auf. Wenn Ihre Anwendung für eine Sequenz verwandter Inhalte verwendet wird, ist es wahrscheinlich sinnvoll, eine einzelne Aktivität für die gesamte Interaktionssitzung aufzuzeichnen.

Wiedergabelistenszenarien: Dies ist besonders für Musikwiedergabelisten oder TV-Sendungen relevant – eine einzelne Benutzeraktivität kann aktualisiert werden, um Ihren Fortschritt anzuzeigen. In diesem Fall verfügen Sie über eine einzelne Benutzeraktivität mit mehreren Verlaufselementen , die Zeiträume der Interaktion über mehrere Tage oder Wochen darstellen.

TUN: Speichern von Benutzerdaten in der Cloud. Wenn Sie geräteübergreifende Aktivitäten unterstützen möchten, müssen Sie sicherstellen, dass die inhalte, die zum erneuten Einschalten dieser Aktivität erforderlich sind, an einem Cloudspeicherort gespeichert werden. Wenn Sie beispielsweise eine Aktivität jedes Mal veröffentlichen, wenn ein Benutzer ein Dokument bearbeitet, sollte das Dokument in der Cloud und nicht lokal auf dem Gerät des Benutzers gespeichert werden, um die geräteübergreifende Reengagement zu aktivieren.

TUE NICHT: Erstellen Sie eine Benutzeraktivität für Aktionen, die Benutzer in Zukunft nicht fortsetzen müssen. Wenn Ihre Anwendung verwendet wird, um einfache, einmalige Vorgänge durchzuführen, die nicht status beibehalten werden, damit Sie sie in Zukunft nachverfolgen können, müssen Sie wahrscheinlich keine Benutzeraktivität schreiben.

Obwohl Benutzeraktivitäten in der Windows-Zeitachse angezeigt werden, ist dies nicht als Tool für die Versionsverwaltung konzipiert. Wenn Sie eine dokumentbasierte Aktivität auswählen, sollte immer die neueste Version dieses Dokuments angezeigt werden (einschließlich änderungen, die von einem anderen Benutzer vorgenommen wurden).

TUE NICHT: Erstellen Sie eine Benutzeraktivität für Aktionen, die von anderen Benutzern ausgeführt werden. Wenn jemand dem Benutzer oder dem Benutzer in Ihrer App eine Nachricht @mentions sendet, sollten Sie keine neue Aktivität schreiben. Diese Interaktionen werden besser durch das Anzeigen von Benachrichtigungen unterstützt.

Szenarien für die Zusammenarbeit: Wenn mehrere Personen an derselben Aktivität arbeiten (z. B. ein Word Dokument), gibt es Fälle, in denen ein anderer Benutzer Änderungen am Dokument vorgenommen hat, nachdem Sie es zuletzt bearbeitet haben. In diesem Fall möchten App-Entwickler möglicherweise die visuellen Elemente in der Aktivität aktualisieren, um änderungen am Dokument widerzuspiegeln. Dazu kann die App die vorhandene Aktivität aktualisieren, ohne ein neues Verlaufselement zu erstellen.

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 einzuschließen. Die Aktivitäten starten den Benutzer wieder in Ihre App, wie von Microsoft-Umgebungen wie Windows-Zeitachsen erwartet.

App-Interaktionsmuster und Benutzeraktivitäten

Die von Ihnen erstellten Benutzeraktivitäten variieren je nach Interaktionsmuster Ihrer App. Obwohl jede App anders ist, fallen die meisten in eines der folgenden Interaktionsmuster:

  • Dokumentbasierte Apps : Erstellen Sie eine Aktivität pro Dokument mit mindestens einem Verlaufsdatensatz, der Nutzungszeiträume widerspiegelt. Es ist wichtig, Ihre Aktivität Karte zu aktualisieren, wenn Änderungen am Dokument vorgenommen werden.
  • Medienwiedergabe-Apps – Erstellen Sie eine Aktivität pro logischer Gruppierung von Inhalten, z. B. einer Wiedergabeliste, einem Programm oder eigenständigen Inhalt.
  • Spiele : Erstellen Sie eine Aktivität für jedes gespeicherte Spiel oder jede gespeicherte Welt. Wenn Ihr Spiel nur eine einzelne Sequenz von Levels unterstützt, können Sie die gleiche Aktivität im Laufe der Zeit schreiben, obwohl Sie Ihre Karte aktualisieren möchten, um Ihre neuesten Fortschritte oder Erfolge anzuzeigen.
  • Hilfsprogramm-Apps : Wenn es in Ihrer App nichts gibt, das Benutzer fortsetzen möchten, sollten Sie keine Aktivitäten veröffentlichen. Ein gutes Beispiel ist eine einfache Einzweck-App wie der Rechner.
  • Branchenspezifische Apps – Es gibt viele Apps zum Verwalten einfacher Aufgaben oder Workflows. Erstellen Sie eine Aktivität für jeden separaten Workflow, auf den über Ihre App zugegriffen wird. Beispielsweise wäre jede Spesenabrechnung eine separate Aktivität, da Sie diese Aktivität auswählen möchten, um festzustellen, ob sie genehmigt wurde.

Einige komplexe Apps enthalten mehrere Interaktionsmuster. Möglicherweise möchten Sie verschiedene Muster für die Erstellung von Benutzeraktivitäten für verschiedene Szenarien befolgen, die von Ihrer App behandelt werden.

Nächste Schritte

Suchen Sie nach weiteren Ideen?