Compartir a través de


Tipo de recurso visualInfo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Tipo complejo para representar la propiedad visualElements en el objeto de actividad .

Cada actividad de usuario se mostrará en escala de tiempo como una tarjeta adaptable. Se recomienda a los desarrolladores de aplicaciones que proporcionen una tarjeta personalizada que capture la esencia de la actividad que tuvo lugar en la aplicación. Esto es posible proporcionando una tarjeta JSON personalizada en la propiedad de contenido.

Además de los metadatos visuales con una tarjeta adaptable, la aplicación puede especificar metadatos de contenido: datos que se usan para generar inferencias sobre la actividad del usuario con el fin de ofrecer nuevas actividades para futuras reenlaces. Esto es posible mediante el uso de la propiedad contentInfo de la actividad para proporcionar un objeto JSON que aprovecha schema.org propiedades para describir el contenido.

Si no se proporciona una tarjeta personalizada, se generará una tarjeta simple mediante las propiedades displayText y description. Se recomiendan tarjetas personalizadas para mostrar el mejor contenido desde dentro de la aplicación.

Propiedades

Propiedad Tipo Descripción
displayText Cadena Obligatorio. Descripción de texto breve de la actividad única del usuario (por ejemplo, nombre del documento en los casos en los que una actividad hace referencia a la creación de documentos)
description Cadena Opcional. Descripción de texto más larga de la actividad única del usuario (por ejemplo: nombre del documento, primera oración o metadatos)
Backgroundcolor Cadena Opcional. Color de fondo usado para representar la actividad en la interfaz de usuario: color de marca para el origen de la aplicación de la actividad. Debe ser un color hexadecimal válido
contenido Objeto JSON sin tipo Opcional. Elemento de datos personalizado: objeto JSON que se usa para proporcionar contenido personalizado para representar la actividad en la interfaz de usuario de Windows Shell
Atribución imageInfo Opcional. Objeto JSON usado para representar un icono que representa la aplicación utilizada para generar la actividad

Representación JSON

La siguiente es una representación JSON del recurso

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