人気上昇中を一覧表示する

名前空間: microsoft.graph

ユーザーを中心に傾向を示すドキュメントの一覧を含む計算された分析情報。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	Sites.Read.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	Sites.Read.All、Sites.ReadWrite.All

HTTP 要求

サインインしているユーザーまたは指定したユーザーを中心に傾向を示すドキュメントの一覧を取得します。

GET /me/insights/trending
GET /users/{id | userPrincipalName}/insights/trending

傾向分析情報によって参照される リソースを展開 します。

GET /me/insights/trending/{id}/resource
GET /users/{id | userPrincipalName}/insights/trending/{id}/resource

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

クエリ パラメーターを使用 $filter して、傾向項目をフィルター処理できます。 たとえば、型に基 づいて次の値を指定します。

https://graph.microsoft.com/v1.0/me/insights/trending?$filter=ResourceVisualization/type eq 'PowerPoint'

または containerType に基づく:

https://graph.microsoft.com/v1.0/me/insights/trending?$filter=ResourceVisualization/containerType eq 'OneDriveBusiness'

resourceVisualizationでフィルター処理できる使用可能なコンテナーの種類と種類を確認します。

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {トークン}。必須。
承諾	application/json

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答コードと応答本文の傾向 200 OK 項目 の一覧を返します。 各アイテムには、エクスペリエンスでアイテムを表示するための視覚化プロパティが含まれる。

例

要求

以下は、要求の例です。

GET https://graph.microsoft.com/v1.0/me/insights/trending

応答

以下は、応答の例です。 注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。 ページの下部にある、切り捨てされていない応答の例を参照してください。

HTTP/1.1 200 OK
Content-type: application/json

{
    "value": [
        {
            "id": "AWMiSOpKHlJCpP_ZoVJQXi9ees4wFhDQQqF55Pm5DlaMzvtd2zra4UWSTEvpTldvb6EhQ289G4BAsxnrajQyjW1jIkjqSh5SQqT_2aFSUF4vBQ",
            "weight": "0.1583399742569597",
            "resourceVisualization": {
                "title": "LiveCaptions",
                "type": "Image",
                "mediaType": "application/octet-stream",
                "previewImageUrl": "https://contoso.sharepoint.com/_api/v2.0/drives/b!YyJI6koeUkKk_9mhUlBeL156zjAWENBCoXnk-bkOVozO-13bOtrhRZJMS-lOV29v/items/01H273TR5BEFBW6PI3QBALGGPLNI2DFDLN/thumbnails/0/small/thumbnailContent",
                "previewText": "",
                "containerWebUrl": "https://contoso.sharepoint.com/sites/Mark8ProjectTeam/Shared Documents/Go to Market Plan",
                "containerDisplayName": "Mark 8 Project Team",
                "containerType": "Site"
            },
            "resourceReference": {
                "webUrl": "https://contoso.sharepoint.com/sites/Mark8ProjectTeam/Shared%20Documents/Go%20to%20Market%20Plan/LiveCaptions.gif",
                "id": "drives/b!YyJI6koeUkKk_9mhUlBeL156zjAWENBCoXnk-bkOVozO-13bOtrhRZJMS-lOV29v/items/01H273TR5BEFBW6PI3QBALGGPLNI2DFDLN",
                "type": "microsoft.graph.driveItem"
            }
        }
    ]
}