visualInfo リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

各ユーザー アクティビティは、タイムラインにアダプティブ カードとして表示されます。 アプリ開発者は、アプリ内で行われたアクティビティのエッセンスをキャプチャしたカスタム カードを提供することをお勧めします。 これは、コンテンツ プロパティにカスタム JSON カードを指定することで実現できます。

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

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

プロパティ

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

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
    "@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"
    }
}
  • Last updated on