visualInfo-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ein komplexer Typ zum Darstellen der visualElements-Eigenschaft im Aktivitätsobjekt .

Jede Benutzeraktivität wird auf der Zeitachse als adaptive Karte angezeigt. App-Entwickler werden aufgefordert, eine benutzerdefinierte Karte bereitzustellen, die das Wesen der Aktivität erfasst, die in Ihrer App stattgefunden hat. Dies ist möglich, indem eine benutzerdefinierte JSON-Karte in der Inhaltseigenschaft bereitgestellt wird.

Zusätzlich zu den visuellen Metadaten mit einer adaptiven Karte kann die App Inhaltsmetadaten angeben– Daten, die verwendet werden, um Rückschlüsse auf die Aktivität des Benutzers zu erstellen, um neue Aktivitäten für zukünftige Erneutes Engagement anzubieten. Dies ist möglich, indem die contentInfo-Eigenschaft der Aktivität verwendet wird, um ein JSON-Objekt bereitzustellen, das schema.org Eigenschaften nutzt, um den Inhalt zu beschreiben.

Wenn kein benutzerdefinierter Karte bereitgestellt wird, wird eine einfache Karte mit displayText- und description-Eigenschaften generiert. Benutzerdefinierte Karten werden empfohlen, um die besten Inhalte aus Ihrer App zu präsentieren.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Displaytext	String	Erforderlich. Kurze Textbeschreibung der eindeutigen Aktivität des Benutzers (z. B. Dokumentname in Fällen, in denen sich eine Aktivität auf die Dokumenterstellung bezieht)
description	Zeichenfolge	Optional. Längere Textbeschreibung der eindeutigen Aktivität des Benutzers (Beispiel: Dokumentname, erster Satz und/oder Metadaten)
Backgroundcolor	Zeichenfolge	Optional. Hintergrundfarbe, die zum Rendern der Aktivität auf der Benutzeroberfläche verwendet wird– Markenfarbe für die Anwendungsquelle der Aktivität. Muss eine gültige Hexaxfarbe sein
content	Nicht typisiertes JSON-Objekt	Optional. Benutzerdefiniertes Datenelement: JSON-Objekt, das zum Bereitstellen von benutzerdefiniertem Inhalt zum Rendern der Aktivität auf der Windows-Shell-Benutzeroberfläche verwendet wird
Attribution	Imageinfo	Optional. JSON-Objekt, das verwendet wird, um ein Symbol darzustellen, das die Anwendung darstellt, die zum Generieren der Aktivität verwendet wird

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
    "@data.type": "microsoft.graph.visualInfo",
    "attribution": {
        "@odata.type": "microsoft.graph.imageInfo",
        "iconUrl": "String (URL)",
        "alternateText": "String",
        "addImageQuery": "boolean"
    },
    "description": "String",
    "backgroundColor": "String",
    "displayText": "String",
    "content": {
        "@data.type": "microsoft.graph.Json"
    }
}