visualInfo リソースの種類

名前空間: microsoft.graph

アクティビティ オブジェクトの visualElements プロパティを表す複合 型 。

各ユーザー アクティビティはタイムラインにアダプティブ カードとして表示されます。 アプリ開発者は、アプリで行ったアクティビティの本質をキャプチャするカスタム カードを提供してください。 これは、content プロパティにカスタム JSON カードを提供することで可能です。

アダプティブ カードを使用したビジュアル メタデータに加えて、アプリはコンテンツ メタデータ (将来の再エンゲージメントのための新しいアクティビティを提供するために、ユーザーのアクティビティの推論を構築するために使用されるデータ) を指定できます。 これは、アクティビティの contentInfo プロパティを使用して、コンテンツを記述するために、schema.org を利用する JSON オブジェクトを提供することで可能です。

カスタム カードが指定されていない場合は、displayText プロパティと description プロパティを使用して単純なカードが生成されます。 アプリ内から最適なコンテンツを紹介するには、カスタム カードをお勧めします。

プロパティ

Name	型	説明
displayText	String	必須。 ユーザーの一意のアクティビティの短いテキストの説明 (たとえば、アクティビティがドキュメントの作成を参照する場合のドキュメント名)
説明	String	省略可能。 ユーザーの一意のアクティビティの長いテキストの説明 (たとえば、ドキュメント名、最初の文、および/またはメタデータ)
backgroundColor	String	省略可能。 アクティビティのアプリケーション ソースの UI - ブランド色でアクティビティをレンダリングするために使用される背景色。 有効な 16 進数の色である必要があります。
content	型指定されていない JSON オブジェクト	省略可能です。 ユーザー設定のデータ - カスタム コンテンツを提供するために使用される JSON オブジェクトは、シェル UI でアクティビティWindowsします。
属性	imageInfo	省略可能です。 アクティビティの生成に使用されるアプリケーションを表すアイコンを表す JSON オブジェクト

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