Freigeben über


visualInfo-Ressourcentyp

Namespace: microsoft.graph

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 keine benutzerdefinierte 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

Name Typ Beschreibung
Zuschreibung imageInfo Optional. JSON-Objekt, das verwendet wird, um ein Symbol darzustellen, das die Anwendung darstellt, die zum Generieren der Aktivität verwendet wird
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
description Zeichenfolge Optional. Längere Textbeschreibung der eindeutigen Aktivität des Benutzers (Beispiel: Dokumentname, erster Satz und/oder Metadaten)
displayText Zeichenfolge 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)

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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