Compartilhar via


tipo de recurso visualInfo

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Um tipo complexo para representar a propriedade visualElements no objeto de atividade .

Cada atividade de utilizador será apresentada na Linha Cronológica como um Cartão Ajustável. Os programadores de aplicações são encorajados a fornecer um Cartão personalizado que captura a essência da atividade que ocorreu na sua aplicação. Isto é possível ao fornecer uma card JSON personalizada na propriedade content.

Além dos metadados visuais com um Cartão Ajustável, a aplicação pode especificar metadados de conteúdo – dados que são utilizados para criar inferências sobre a atividade do utilizador para oferecer novas atividades para o envolvimento futuro. Isto é possível ao utilizar a propriedade contentInfo da atividade para fornecer um objeto JSON que tira partido schema.org propriedades para descrever o conteúdo.

Se não for fornecida uma card personalizada, será gerada uma card simples com as propriedades displayText e description. Os cartões personalizados são recomendados para mostrar os melhores conteúdos a partir da sua aplicação.

Propriedades

Propriedade Tipo Descrição
displayText Cadeia de caracteres Obrigatório. Breve descrição de texto da atividade exclusiva do utilizador (por exemplo, o nome do documento nos casos em que uma atividade se refere à criação de documentos)
description String Opcional. Descrição de texto mais longa da atividade exclusiva do utilizador (exemplo: nome do documento, primeira frase e/ou metadados)
backgroundColor String Opcional. Cor de fundo utilizada para compor a atividade na IU – cor da marca para a origem da aplicação da atividade. Tem de ser uma cor hexadecimida válida
conteúdo Objeto JSON não escrito Opcional. Peça de dados personalizada – objeto JSON utilizado para fornecer conteúdo personalizado para compor a atividade na IU da Shell do Windows
attribution imageInfo Opcional. Objeto JSON utilizado para representar um ícone que representa a aplicação utilizada para gerar a atividade

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de 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"
    }
}