visualInfo-RessourcentypvisualInfo resource type

Ein komplexer Typ für die Darstellung der visualElements -Eigenschaft im Activity -Objekt.A complex type for representing the visualElements property in the activity object.

Jede Benutzeraktivität wird im Zeitachsenbereich als Adaptive Karte angezeigt.Each user activity will be shown in Timeline as an Adaptive Card. App-Entwickler werden aufgefordert, eine benutzerdefinierte Karte bereitzustellen, die die Essenz der Aktivität erfasst, die in Ihrer APP stattfand.App developers are encouraged to provide a custom Card which captures the essence of the activity which took place in your app. Dies ist möglich, indem eine benutzerdefinierte JSON-Karte in der Content-Eigenschaft bereitgestellt wird.This is possible by providing a custom JSON card in the content property.

Neben visuellen Metadaten mit einer adaptiven Karte kann App Inhaltsmetadaten angeben – Daten, die zum Erstellen von Rückschlüssen auf die Aktivität des Benutzers verwendet werden, um neue Aktivitäten für zukünftiges erneutes Engagement anzubieten.In addition to visual metadata with an Adaptive Card, app can specify content metadata – data that be used to build inferences on the user’s activity in order to offer new activities for future re-engagement. Dies ist möglich, indem Sie die contentInfo-Eigenschaft der Aktivität verwenden, um ein JSON-Objekt bereitzustellen, das die Schema.org-Eigenschaften zum Beschreiben des Inhalts nutzt.This is possible by using the activity's contentInfo property to provide a JSON object which leverages schema.org properties to describe the content.

Wenn keine benutzerdefinierte Karte angegeben wird, wird mithilfe der Eigenschaften Display Text und Description eine einfache Karte generiert.If a custom card is not provided, a simple card will be generated using displayText and description properties. Benutzerdefinierte Karten werden empfohlen, um die besten Inhalte in Ihrer APP zu präsentieren.Custom cards are recommended to showcase the best content from within your app.

EigenschaftenProperties

NameName TypType BeschreibungDescription
Display TextdisplayText StringString Erforderlich.Required. Kurze Textbeschreibung der eindeutigen Aktivität des Benutzers (beispielsweise Dokumentname in Fällen, in denen sich eine Aktivität auf die Dokumenterstellung bezieht)Short text description of the user's unique activity (for example, document name in cases where an activity refers to document creation)
descriptiondescription StringString Optional.Optional. Längere Textbeschreibung der eindeutigen Aktivität des Benutzers (Beispiel: Dokumentname, erster Satz und/oder Metadaten)Longer text description of the user's unique activity (example: document name, first sentence, and/or metadata)
Background ColorbackgroundColor StringString Optional.Optional. Hintergrundfarbe, die zum Rendern der Aktivität in der Benutzeroberflächen-Markenfarbe für die Anwendungsquelle der Aktivität verwendet wird.Background color used to render the activity in the UI - brand color for the application source of the activity. Muss eine gültige Hex-Farbe seinMust be a valid hex color
contentcontent Nicht typisiertes JSON-ObjektUntyped JSON object Optional.Optional. Benutzerdefiniertes Daten-JSON-Objekt, das zum Bereitstellen von benutzerdefinierten Inhalten zum Rendern der Aktivität in der Windows Shell-Benutzeroberfläche verwendet wirdCustom piece of data - JSON object used to provide custom content to render the activity in the Windows Shell UI
Attributionattribution imageInfoimageInfo Optional.Optional. JSON-Objekt, das verwendet wird, um ein Symbol darzustellen, das die zum Generieren der Aktivität verwendete Anwendung darstelltJSON object used to represent an icon which represents the application used to generate the activity

JSON-DarstellungJSON Representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

{
    "@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"
    }
}