Type de ressource visualInfo

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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, un carte simple est généré à 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

Propriété	Type	Description
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)
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)
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
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é

Représentation JSON

Voici une représentation JSON de la 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"
    }
}