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 la forme d’une 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é de contenu.

En plus des métadonnées visuelles avec une carte adaptative, l’application peut spécifier des métadonnées de contenu, des données qui peuvent être utilisées pour créer des inférences sur l’activité de l’utilisateur afin de proposer de nouvelles activités pour 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 une carte personnalisée n’est pas fournie, une simple carte 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 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, nom du document dans les cas où une activité fait référence à la création d’un 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 de l’application de l’activité. Doit être d’une couleur hexadécimale valide
contenu Objet JSON non typé Facultatif. Données personnalisées : objet JSON utilisé pour fournir un contenu personnalisé afin de rendre l’activité dans l’interface utilisateur Windows Shell
Attribution imageInfo Facultatif. Objet JSON utilisé pour représenter une icône représentant 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"
    }
}
  • Dernière mise à jour :