Type de ressource visualInfo

  • Article

Espace de noms: microsoft.graph

Type complexe pour représenter la propriété visualElements dans l’objet d’activité .

Chaque activité utilisateur s’affiche dans la chronologie sous forme de carte adaptative. Les développeurs d’applications sont encouragés à fournir une carte personnalisée qui capture l’essence de l’activité qui a eu lieu dans votre application. Cela est possible en fournissant une carte JSON personnalisée dans la propriété content.

En plus des métadonnées visuelles avec une carte adaptative, l’application peut spécifier des métadonnées de contenu, c’est-à-dire des données utilisées pour générer des inférences sur l’activité de l’utilisateur afin d’offrir de nouvelles activités en vue d’un ré-engagement futur. Cela est possible en utilisant la propriété contentInfo de l’activité pour fournir un objet JSON qui exploite schema.org propriétés pour décrire le contenu.

Si aucune carte personnalisée n’est fournie, une carte simple est générée à l’aide des propriétés displayText et description. Les cartes personnalisées sont recommandées pour présenter le meilleur contenu à partir de votre application.

Propriétés

Nom Type Description
attribution imageInfo Optional. Objet JSON utilisé pour représenter une icône qui représente l’application utilisée pour générer l’activité
backgroundColor String Facultatif. Couleur d’arrière-plan utilisée pour afficher l’activité dans l’interface utilisateur : couleur de marque pour la source d’application de l’activité. Doit être une couleur hexadécimale valide
contenu Objet JSON non typé Optional. Élément de données personnalisé : objet JSON utilisé pour fournir du contenu personnalisé afin de restituer l’activité dans l’interface utilisateur De l’interpréteur de commandes Windows
description String Facultatif. Description textuelle plus longue de l’activité unique de l’utilisateur (exemple : nom du document, première phrase et/ou métadonnées)
displayText Chaîne Obligatoire. Brève description textuelle de l’activité unique de l’utilisateur (par exemple, le nom du document dans les cas où une activité fait référence à la création de document)

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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