Partager via

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 String 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é

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de 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"
    }
}
  • Last updated on