Feedback Bearbeiten

Verwenden der Aktivitätsfeed-REST-API

  • Artikel
  • 4 Minuten Lesedauer

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. Api-Anforderungen für Aktivitätsfeeds werden im Namen eines Benutzers über delegierte Berechtigungen und die Benutzeraktivitätsberechtigungausgeführt, die 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 Deep-Links zu bestimmten Inhalten innerhalb Ihrer App. Die von Ihnen erstellten Benutzeraktivitäten können nicht nur in Ihrer eigenen App verwendet werden, sondern werden auch in Cortana und Windows Zeitachse angezeigt. Dies führt zu mehr App-Neuverwaltung und erleichtert Es Ihren Benutzern, Ihre App auf mehreren Geräten weiter zu verwenden.

Was sollte eine Aktivität werden?

Da jede App unterschiedlich ist, liegt es an jedem App-Entwickler, die beste Möglichkeit zu verstehen, Aktionen innerhalb Ihrer Anwendung Benutzeraktivitäten zuzuordnen. 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, während Sie Aktivitäten in Ihrer App definieren:

GEHEN SIE FOLGENDERMAßEN VOR: Zeichnen Sie eine einzelne Aktivität für eine Gruppe verwandter Benutzeraktionen auf. Wenn Ihre Anwendung für eine Abfolge verwandter Inhalte verwendet wird, ist es wahrscheinlich sinnvoll, eine einzelne Aktivität für die gesamte Engagement-Sitzung zu erfassen.

Wiedergabelistenszenarien: Dies ist besonders relevant für Musikwiedergabelisten oder TV-Shows – 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 Aktivierungszeiträume über mehrere Tage oder Wochen hinweg darstellen.

DO: Store Benutzerdaten in die 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 Cloudspeicherort gespeichert werden. Wenn Sie beispielsweise jedes Mal, wenn ein Benutzer ein Dokument bearbeitet, eine Aktivität veröffentlichen, sollte das Dokument in der Cloud gespeichert werden und nicht lokal auf dem Gerät des Benutzers, um die geräteübergreifende erneute Aktivierung zu ermöglichen.

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 auszuführen, die den Status nicht beibehalten, damit Sie in Zukunft nachverfolgt werden können, müssen Sie wahrscheinlich keine Benutzeraktivität schreiben.

Um zu verdeutlichen, dass Benutzeraktivitäten zwar in Windows Zeitachse angezeigt werden, dies ist jedoch nicht als Versionsverwaltungstool konzipiert . Bei auswahl einer dokumentbasierten Aktivität sollte immer die neueste Version dieses Dokuments angezeigt werden (einschließlich Änderungen, die von einem anderen Benutzer vorgenommen wurden).)

NICHT: Erstellen Sie eine Benutzeraktivität für Aktionen, die von anderen Benutzern abgeschlossen wurden. Wenn jemand dem Benutzer eine Nachricht sendet oder den Benutzer innerhalb Ihrer App @mentions, sollten Sie keine neue Aktivität schreiben. Diese Interaktionen werden besser durch das Anzeigen von Benachrichtigungen bedient.

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 die visuellen Elemente in der Aktivität möglicherweise aktualisieren, um änderungen am Dokument widerzuspiegeln. Hierzu aktualisiert die App möglicherweise die vorhandene Aktivität, ohne ein neues Verlaufselement zu erstellen.

Hinweis: Wenn Sie Aktivitäten für eine Webanwendung veröffentlichen, ist es wichtig, sowohl eine als auch activationURL eine für jede Ihrer Aktivitäten einzuschließen. fallbackURL Die Aktivitäten starten den Benutzer wie erwartet von Microsoft-Oberflächen wie Windows Zeitachse zurück in Ihre App.

App-Interaktionsmuster und Benutzeraktivitäten

Die von Ihnen erstellten Benutzeraktivitäten variieren je nach Interaktionsmuster Ihrer App. Während sich jede App unterscheidet, fallen die meisten in eines der folgenden Interaktionsmuster:

  • Dokumentbasierte Apps – Erstellen Sie eine Aktivität pro Dokument mit einem oder mehreren Verlaufsdatensätzen, die Nutzungszeiträume widerspiegeln. Es ist wichtig, die Aktivitätskarte zu aktualisieren, wenn Änderungen am Dokument vorgenommen werden.
  • Medienwiedergabe-Apps – Erstellen Sie eine Aktivität pro logischer Gruppierung von Inhalten, z. B. eine Wiedergabeliste, ein Programm oder eigenständige Inhalte.
  • Spiele – Erstellen Sie eine Aktivität für jedes gespeicherte Spiel oder jede gespeicherte Welt. Wenn Ihr Spiel nur eine einzelne Abfolge von Leveln unterstützt, können Sie dieselbe Aktivität im Laufe der Zeit schreiben, obwohl Sie Ihre Karte möglicherweise aktualisieren möchten, um Ihre neuesten Fortschritte oder Erfolge anzuzeigen.
  • Hilfsprogramm-Apps – Wenn ihre App nichts enthält, das Benutzer fortsetzen möchten, sollten Sie keine Aktivitäten veröffentlichen. Ein gutes Beispiel ist eine einfache Einzelanwendung wie der Rechner.
  • Branchenspezifische Apps – Viele Apps sind für die Verwaltung einfacher Aufgaben oder Workflows vorhanden. 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 möglicherweise auf diese Aktivität klicken 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 unterschiedliche Szenarien befolgen, die von Ihrer App verarbeitet werden.

Nächste Schritte

  • Sehen Sie sich die Aktivitätsressource an, und definieren Sie die Aktivitäten Ihrer App, damit Benutzer wichtige Aufgaben fortsetzen können.
  • Sehen Sie sich die Beispiele für adaptive Karten an, um Ideen zu entwickeln, um Ihre Aktivitäten zu verf?nen.
  • Probieren Sie die API im Graph-Tester aus.

Suchen Sie nach weiteren Ideen?