visualInfo 资源类型

命名空间:microsoft.graph

用于表示活动对象中的 visualElements 属性的复杂类型。

每个用户活动将在时间线中显示为自适应卡片。 建议应用开发人员提供自定义卡片,以捕获应用中发生的活动的本质。 这可以通过在 content 属性中提供自定义 JSON 卡实现。

除了具有自适应卡片的视觉元数据外,应用还可以指定内容元数据 - 用于对用户活动生成推理的数据,以便为将来的重新参与提供新活动。 通过使用活动的 contentInfo 属性提供 JSON 对象,该对象利用 schema.org 属性来描述内容,可以实现此目的。

如果未提供自定义卡片,将使用 displayText 和 description 属性生成简单的卡片。 建议使用自定义卡片来展示应用中的最佳内容。

属性

名称 类型 说明
归 因 imageInfo 可选。 用于表示图标的 JSON 对象,该图标表示用于生成活动的应用程序
backgroundColor String 可选。 用于在 UI 中呈现活动的背景色 - 活动的应用程序源的品牌颜色。 必须是有效的十六进制颜色
content 非类型化 JSON 对象 可选。 自定义数据片段 - 用于提供自定义内容以在 Windows Shell UI 中呈现活动的 JSON 对象
说明 String 可选。 用户唯一活动的较长文本说明 (示例:文档名称、第一句和/或元数据)
displayText String 必填。 用户唯一活动的简短文本说明 (例如,在活动引用文档创建的情况下的文档名称)

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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